README 更新技能

描述

智能更新 README.md，保持與程式碼變更同步。

觸發條件

•「更新 README」「readme」「文檔同步」
•被 git-precommit 編排器調用
•新增重要功能後

法規依據

•憲法：CONSTITUTION.md 第 6 條

📁 README.md 建議結構

markdown

# 專案名稱

> 一句話描述

## ✨ 功能特色

- 🔥 功能 1
- 🚀 功能 2

## 📦 安裝

### 前置需求
- Node.js >= 18
- Python >= 3.11

### 安裝步驟
\`\`\`bash
npm install
\`\`\`

## 🚀 快速開始

\`\`\`bash
npm run dev
\`\`\`

## 📖 使用說明

### 基本用法
...

### 進階用法
...

## 📁 專案結構

\`\`\`
src/
├── domain/
├── application/
├── infrastructure/
└── presentation/
\`\`\`

## ⚙️ 設定

| 變數 | 說明 | 預設值 |
| ---- | ---- | ------ |
| PORT | 服務埠號 | 3000 |

## 🤝 貢獻

請參閱 CONTRIBUTING.md

## 📄 授權

MIT License

🔧 操作步驟

Step 1: 讀取現有 README

code

read_file("README.md")

Step 2: 分析變更內容

從 git-precommit 調用時：

code

get_changed_files()

或分析專案結構：

code

list_dir("src/")

Step 3: 判斷需要更新的區塊

變更類型	更新區塊	偵測方式
新功能	✨ 功能特色	新增 feature 資料夾
新依賴	📦 安裝	pyproject.toml/package.json 變更
API 變更	📖 使用說明	公開 API 檔案變更
目錄變更	📁 專案結構	新增/移除主要資料夾
新設定	⚙️ 設定	config 檔案變更

Step 4: 執行更新

使用 replace_string_in_file 精確更新：

新增功能到功能列表：

code

oldString: "## ✨ 功能特色\n\n- 🔥 功能 1\n- 🚀 功能 2"
newString: "## ✨ 功能特色\n\n- 🔥 功能 1\n- 🚀 功能 2\n- 🔐 用戶認證（新）"

更新專案結構：

code

oldString: "## 📁 專案結構\n\n```\nsrc/\n├── domain/"
newString: "## 📁 專案結構\n\n```\nsrc/\n├── domain/\n│   └── entities/"

🛡️ 保護區塊

以下區塊不應自動修改（需人工確認）：

•📄 授權資訊（License）
•🤝 貢獻指南（Contributing）
•🙏 致謝（Acknowledgments）
•📜 免責聲明（Disclaimer）

🔄 與其他 Skills 整合

Skill	整合方式
`git-precommit`	自動調用，傳入變更資訊
`readme-i18n`	更新後同步多語言版本
`changelog-updater`	參考 CHANGELOG 新功能

📊 輸出格式

code

📝 README 更新報告

變更偵測：
- ✅ 新增功能：用戶認證模組
- ✅ 新增依賴：bcrypt

建議更新：
- [功能列表] 新增「🔐 用戶認證」
- [安裝說明] 新增 bcrypt 安裝指令

執行結果：
- ✅ README.md 已更新 (2 處變更)

📌 提醒：請檢查 readme-i18n 是否需要同步

⚠️ 注意事項

•保持格式一致：使用 emoji 時要與現有風格一致
•不要移除內容：只新增或更新，不主動刪除區塊
•程式碼範例驗證：更新範例時確保語法正確
•多語言同步：有 README.zh-TW.md 時需通知 readme-i18n