name	git-precommit
description	提交前編排器 + Paper-Aware Pre-Commit Hooks。 LOAD THIS SKILL WHEN: commit、提交、推送、做完了、收工 CAPABILITIES: 記憶同步、文檔更新、Paper 品質把關、Git 操作

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`, `workspace_state_action(action="sync")`
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_quality_checks(action="writing_hooks", 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/` 已更新	`workspace_state_action(action="sync")`	未更新 = 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`

Más de este repositorio

mismo repositorio

auto-paper

u9401066/med-paper-assistant

全自動論文撰寫 + 閉環自我改進系統。 LOAD THIS SKILL WHEN: 全自動寫論文、auto write、自動撰寫、幫我寫完整篇、autopilot、從頭到尾、一鍵寫論文 CAPABILITIES: 編排所有研究 Skills + 3 層 Audit Hooks + Meta-Learning 自我改進

2026-05-198

draft-writing

u9401066/med-paper-assistant

2026-05-198

word-export

u9401066/med-paper-assistant

Word 匯出技能 - 將草稿匯出為符合期刊格式的 Word 文件。 LOAD THIS SKILL WHEN: 匯出 Word、export、template、word count、轉成 docx

2026-05-198

literature-review

u9401066/med-paper-assistant

系統性文獻搜尋、篩選、下載、整理。觸發：文獻回顧、找論文、搜尋文獻、systematic review、literature search、PubMed、找文章、搜paper、review、reference、citation、引用、參考文獻、背景調查、background。

2026-05-138

concept-development

u9401066/med-paper-assistant

發展研究概念並驗證創新性。觸發：concept、發展概念、研究概念、novelty、創新點、補充概念、幫我補充、擴展概念、加強、驗證失敗、novelty不夠、怎麼改。

2026-04-238

project-management

u9401066/med-paper-assistant

研究專案的建立、切換、設定管理。 LOAD THIS SKILL WHEN: 新專案、切換專案、專案設定、paper type、start exploration、convert exploration CAPABILITIES: project_action, workspace_state_action

2026-04-148

name	git-precommit
description	提交前編排器 + Paper-Aware Pre-Commit Hooks。 LOAD THIS SKILL WHEN: commit、提交、推送、做完了、收工 CAPABILITIES: 記憶同步、文檔更新、Paper 品質把關、Git 操作

Git 提交前工作流（編排器 + Pre-Commit Hooks）

Copilot Hooks（寫作時即時修正）定義於 auto-paper/SKILL.md。 Pre-Commit Hooks（本檔，git commit 前最終把關）只報告不自動修改。

觸發：「commit」「推送」「做完了」「收工」「快速 commit」

Step 0: 偵測變更範圍

通用 Hooks（每次觸發）

Hook	條件	動作	MCP Tools
G1 memory-sync	必要	更新 Memory Bank + workspace state	`memory_bank_update_progress`, `workspace_state_action(action="sync")`
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_quality_checks(action="writing_hooks", 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/` 已更新	`workspace_state_action(action="sync")`	未更新 = AUTO-FIX
P7 reference-integrity	文獻 metadata 完整	`list_saved_references`, `get_reference_details`	非 VERIFIED = ⚠️
P8 methodology	Methods 可再現	`read_draft` + Agent checklist	項目 <3 = ❌

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`