git-precommit

Git 提交前工作流（編排器）

描述

協調多個 Skills 完成 Git 提交前的所有準備工作。這是一個「編排器」Skill，負責調用其他 Skills。

觸發條件

• 「準備 commit」「GIT」「gc」
• 「要提交了」「git commit」
• 「推送」「push」

法規依據

• 憲法：CONSTITUTION.md 第三章
• 子法：.github/bylaws/git-workflow.md

---

🔧 操作步驟（編排流程）

Step 1: 收集變更資訊

git status --short
git diff --name-only --cached

使用工具：

get_changed_files()  # 取得變更清單

Step 2: 執行 memory-updater（必要）

呼叫條件：永遠執行

調用 memory-updater skill：
- 更新 activeContext.md（當前焦點）
- 更新 progress.md（移動 Done/Doing）

Step 3: 執行 readme-updater（條件）

呼叫條件：

• 新增功能（src/ 有新檔案）
• 依賴變更（pyproject.toml/package.json 變更）
• API 變更

若需要，調用 readme-updater skill

Step 4: 執行 changelog-updater（條件）

呼叫條件：

• 有功能性變更（非純文檔）
• 有 bug 修復
• 有安全性修補

若需要，調用 changelog-updater skill

Step 5: 執行 roadmap-updater（條件）

呼叫條件：

• 完成了 ROADMAP 中列出的功能

若需要，調用 roadmap-updater skill

Step 6: 架構文檔檢查（條件）

呼叫條件：

• 有結構性變更（新增 domain/application 層）

若需要，更新 memory-bank/architect.md

Step 7: 生成 Commit Message

依據 Conventional Commits 格式：

<type>(<scope>): <description>

[optional body]

[optional footer(s)]

類型對照：

變更內容	type
新功能	feat
Bug 修復	fix
文檔	docs
重構	refactor
測試	test
建構/CI	chore

Step 8: 執行 Git 命令

# 檢查狀態
git status

# Stage 變更
git add .

# 提交
git commit -m "feat(auth): 新增用戶認證模組"

# 推送（如果用戶確認）
git push origin main

---

📊 流程圖

┌─────────────────────────────────────────────────┐
│          Git Pre-Commit Orchestrator            │
├─────────────────────────────────────────────────┤
│  Step 1: 收集變更    [分析] get_changed_files   │
│  Step 2: memory-sync [必要] Memory Bank 同步    │
│  Step 3: readme      [條件] README 更新         │
│  Step 4: changelog   [條件] CHANGELOG 更新      │
│  Step 5: roadmap     [條件] ROADMAP 更新        │
│  Step 6: architect   [條件] 架構文檔檢查        │
│  Step 7: message     [生成] Commit Message      │
│  Step 8: commit      [執行] git add/commit/push │
└─────────────────────────────────────────────────┘