Git 提交前工作流（編排器 + Pre-Commit Hooks）
Copilot Hooks（寫作時即時修正）定義於 auto-paper/SKILL.md。 Pre-Commit Hooks（本檔，git commit 前最終把關）只報告不自動修改。
觸發：「commit」「推送」「做完了」「收工」「快速 commit」
Step 0: 偵測變更範圍
get_changed_files() 或 git diff --cached --name-only。 論文檔案模式：projects/*/drafts/*, projects/*/concept.md, projects/*/references/*, projects/*/.memory/* → 匹配時觸發 Paper Hooks。
通用 Hooks（每次觸發）
| Hook | 條件 | 動作 | MCP Tools |
|---|---|---|---|
| G1 memory-sync | 必要 | 更新 Memory Bank + workspace state | memory_bank_update_progress, sync_workspace_state |
| G2 readme-update | 新功能/API 變更 | 更新 README | read_file, replace_string_in_file |
| G3 changelog-update | 版本/重要修改 | 更新 CHANGELOG | 同上 |
| G4 roadmap-update | 里程碑完成 | 更新 ROADMAP | 同上 |
| G5 arch-check | 結構性變更 | 檢查架構文檔 | grep_search, list_dir |
| G6 project-integrity | SKILL/AGENTS/src 變更 | 專案一致性審計 | 見下方 |
| G7 vsx-integrity | skills/prompts/vsx 變更 | VSX Extension 同步 | 見下方 |
| G8 doc-update-reminder | 任何程式/設定變更 | 提醒需更新的文檔 | scripts/check-doc-updates.py (pre-commit hook) |
| G9 git-status-check | 必要 | 偵測未 commit/未 push（Code-Enforced） | run_writing_hooks G9 |
G6 專案一致性審計
| # | 檢查 | 方法 | 失敗 |
|---|---|---|---|
| G6.1 | Tool 數量 | grep -c "mcp.tool" vs README/ARCHITECTURE | ⚠️ WARN |
| G6.2 | Skill 數量 | ls -d.claude/skills/*/ vs AGENTS.md | ⚠️ WARN |
| G6.3 | Prompt 數量 | ls.github/prompts/*.prompt.md vs 文檔 | ⚠️ WARN |
| G6.4 | Hook 工具存在 | SKILL.md 中 mcp_mdpaper_* → 已註冊 | ❌ FAIL |
| G6.5 | 跨文件數字一致 | README vs ARCHITECTURE vs AGENTS | ⚠️ WARN |
G7 VSX Extension 同步
| # | 檢查 | 方法 | 失敗 |
|---|---|---|---|
| G7.1 | Skills 同步 | diff source vs bundled | ⚠️ WARN |
| G7.2 | Prompts 同步 | diff source vs bundled | ⚠️ WARN |
| G7.3 | Chat commands | package.json chatParticipants | ❌ FAIL |
| G7.4 | Version semver | 格式驗證 | ❌ FAIL |
| G7.5 | TypeScript 編譯 | tsc --noEmit | ⚠️ WARN |
快速修復：cd vscode-extension &&./scripts/build.sh
Paper Hooks（偵測到論文變更時）
| Hook | 檢查 | MCP Tools | 判定 |
|---|---|---|---|
| P1 citation-integrity | [[wikilinks]] 可解析 | scan_draft_citations, validate_wikilinks | 0 unresolved = ✅, unknown = ❌ |
| P2 anti-ai-scan | AI 痕跡用詞 | read_draft + Agent 掃描 | 0 = ✅, 1-2 = ⚠️, ≥3 = ❌ |
| P3 concept-alignment | NOVELTY/SELLING POINTS 體現 | read_draft("concept.md") + drafts | 完整 = ✅, 部分 = ⚠️, NOVELTY 缺 = ❌ |
| P4 word-count | 各 section ±20% | count_words | 超 50% = ❌ |
| P5 protected-content | 🔒 區塊存在且非空 | read_draft("concept.md") | 缺失 = ❌ |
| P6 memory-sync | .memory/ 已更新 | sync_workspace_state | 未更新 = AUTO-FIX |
| P7 reference-integrity | 文獻 metadata 完整 | list_saved_references, get_reference_details | 非 VERIFIED = ⚠️ |
| P8 methodology | Methods 可再現 | read_draft + Agent checklist | 項目 <3 = ❌ |
P2 Anti-AI 禁止詞：In recent years, It is worth noting, plays a crucial role, has garnered significant attention, a comprehensive understanding, This groundbreaking, delve into, shed light on, pave the way, a myriad of
P8 與 Copilot Hook B5 互補：B5 寫作時即時修正，P8 提交時最終確認（safety net）。
Hook 效能追蹤（§23 Self-Improving）
每次執行後記錄 projects/{slug}/.audit/precommit-stats.md：觸發率/通過率/警告率/阻止率。
- 通過率 >95%（5次+）→ 可能太鬆
- 阻止率 >50%（5次+）→ 可能太嚴
- 記錄供 auto-paper Hook D 分析
執行模式
| 模式 | 觸發 | 執行 |
|---|---|---|
| 標準 | 「準備 commit」 | Step 0 → G1-G7 → P1-P8（如適用）→ Final |
| 快速 | 「快速 commit」 | G1 + P1 + P5（如適用）→ Final |
| 開發 | 「commit code」 | G1-G7（跳過 Paper Hooks）→ Final |
Git 操作
Commit Message 格式：type(scope): description
- Types: feat, fix, docs, refactor, style, test, chore
- Scope: paper, concept, refs, export, core
Skill 依賴
| Hook | 編排 Skill | 工具 |
|---|---|---|
| G1 | memory-updater | memory_bank_update_progress |
| G2-G4 | readme/changelog/roadmap-updater | read_file, replace_string_in_file |
| G5 | ddd-architect | grep_search, list_dir |
| P1-P4 | draft-writing | read_draft, count_words, validate_wikilinks |
| P3,P5,P8 | concept-development | read_draft("concept.md") |
| P7 | reference-management | list_saved_references, get_reference_details |