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`

git-precommit