git-precommit

| 用戶說法 | 觸發 |

|----------|------|

| 準備 commit、要提交了 | ✅ |

| 推送、做完了、收工 | ✅ |

---

編排的 Skills

| Step | Skill | 工具 | 必要性 |

|------|-------|------|--------|

| 1 | memory-updater | memory_bank_update_progress | 必要 |

| 2 | readme-updater | read_file, replace_string_in_file | 可選 |

| 3 | changelog-updater | read_file, replace_string_in_file | 可選 |

| 4 | roadmap-updater | read_file, replace_string_in_file | 可選 |

| 5 | ddd-architect | grep_search, list_dir | 條件觸發 |

| 6 | - | run_in_terminal (git commands) | 必要 |

Git 操作工具

| 工具 | 用途 |

|------|------|

| get_changed_files() | 取得變更檔案清單 |

| run_in_terminal("git status") | 檢查 Git 狀態 |

| run_in_terminal("git add .") | 暫存變更 |

| run_in_terminal("git commit -m '...'") | 提交 |

---

```

┌─────────────────────────────────────────────────┐

│ Git Pre-Commit Orchestrator │

├─────────────────────────────────────────────────┤

│ Step 1: memory-sync [必要] Memory Bank 同步 │

│ Step 2: readme-update [可選] README 更新 │

│ Step 3: changelog-update[可選] CHANGELOG 更新 │

│ Step 4: roadmap-update [可選] ROADMAP 更新 │

│ Step 5: arch-check [條件] 架構文檔檢查 │

│ Step 6: commit-prepare [最終] 準備提交 │

└─────────────────────────────────────────────────┘

```

---

```python

# Step 1: 檢查變更

get_changed_files()

# Step 2: 同步 Memory Bank（必要）

memory_bank_update_progress(

done=["完成功能 X"],

doing=[],

next=["下一步..."]

)

# Step 3: 分析是否需要更新文檔

# - 新功能 → 更新 README

# - 版本變更 → 更新 CHANGELOG

# - 里程碑完成 → 更新 ROADMAP

# Step 4: 準備提交

run_in_terminal("git add .")

run_in_terminal("git status")

# Step 5: 建議 commit message

# 格式：type(scope): description

# - feat: 新功能

# - fix: 修復

# - docs: 文檔

# - refactor: 重構

# Step 6: 執行提交（用戶確認後）

run_in_terminal("git commit -m 'feat: 新增功能'")

```

---

```

「快速 commit」 = --quick

只執行：

1. Memory Bank 同步
2. git add + commit

```

---

```

🚀 Git Pre-Commit 工作流

[1/6] Memory Bank 同步 ✅

└─ progress.md: 更新 2 項

[2/6] README 更新 ⏭️ (無變更)

[3/6] CHANGELOG 更新 ✅

└─ 添加 v0.2.0 條目

[4/6] ROADMAP 更新 ⏭️ (無變更)

[5/6] 架構文檔 ⏭️ (無結構性變更)

[6/6] Commit 準備 ✅

└─ 建議訊息：feat: 新增用戶認證模組

📋 Staged files:

- src/auth/...

準備好了！確認提交？

```

---

• memory-updater - Memory Bank 同步
• changelog-updater - CHANGELOG 更新
• readme-updater - README 更新
• roadmap-updater - ROADMAP 更新