菜单
Orchestrate pre-commit workflow including Memory Bank sync, README/CHANGELOG/ROADMAP updates, and MCP tool count sync. Triggers: GIT, gc, push, commit, 提交, 準備 commit, 要提交了, git commit, pre-commit, 推送.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/u9401066/pubmed-search-mcp --skill git-precommit命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
| name | git-precommit |
| description | Orchestrate pre-commit workflow including Memory Bank sync, README/CHANGELOG/ROADMAP updates, and MCP tool count sync. Triggers: GIT, gc, push, commit, 提交, 準備 commit, 要提交了, git commit, pre-commit, 推送. |
協調多個 Skills 完成 Git 提交前的所有準備工作。 本專案同時使用 pre-commit framework 自動執行程式碼品質檢查，以及 AI orchestrator 處理文檔同步。
本專案的品質守門是一個自我演化的閉迴系統：
┌─────────────────────────────────────────────────────────────┐
│ 自演化循環 (Self-Evolution Cycle) │
├─────────────────────────────────────────────────────────────┤
│ │
│ ① Instructions (copilot-instructions.md) │
│ │ 定義規範、引導 AI 使用 Skills │
│ ▼ │
│ ② Skills (SKILL.md 檔案) │
│ │ 確保建構完整、創建新 Hook │
│ ▼ │
│ ③ Hooks (.pre-commit-config.yaml + scripts/hooks/) │
│ │ 自動執行檢查、自動修正 │
│ ▼ │
│ ④ Validate (check_evolution_cycle.py) │
│ │ 驗證 ①②③ 的一致性 │
│ ▼ │
│ ⑤ Feedback → 更新 Instructions & Skills │
│ │ 處理驗證失敗、補齊文檔、更新套件版本 │
│ └────→ 回到 ①（循環完成） │
│ │
└─────────────────────────────────────────────────────────────┘
| 事件 | 觸發動作 |
|---|---|
| 新增 Hook | Skill 創建 hook → evolution-cycle 驗證文檔及 instruction 是否同步 |
| 修改 Instruction | evolution-cycle 驗證 skill/hook 是否仍一致 |
pre-commit autoupdate| 套件版本更新 → 自動演化 |
| 驗證失敗 | 報告不一致處，強制修復後才能 commit |
┌─────────────────────────────────────────────────────────────┐
│ Git Commit 防護架構 │
├──────────────────────┬──────────────────────────────────────┤
│ Layer 1: 自動化 │ Layer 2: AI 編排器 │
│ (pre-commit hooks) │ (agent orchestrator) │
├──────────────────────┼──────────────────────────────────────┤
│ ✅ ruff + ruff-format│ ✅ Memory Bank 同步 │
│ ✅ bandit security │ ✅ CHANGELOG 更新 │
│ ✅ vulture deadcode │ ✅ ROADMAP 更新 │
│ ✅ deptry deps │ ✅ README 更新 │
│ ✅ file-hygiene │ ✅ 架構文檔檢查 │
│ ✅ commit-size-guard│ ✅ Commit 訊息建議 │
│ ✅ file-hygiene │ │
│ ✅ commit-size-guard│ │
│ ✅ async-test-checker│ │
│ ✅ tool-count-sync │ │
│ ✅ skills-frontmatter│ │
│ ✅ evolution-cycle │ │
│ ✅ future-annotations│ │
│ ✅ no-print-in-src │ │
│ ✅ ddd-layer-imports│ │
│ ✅ no-type-ignore-bare│ │
│ ✅ docstring-tools │ │
│ ✅ no-env-inner-layers│ │
│ ✅ tenant-scoped-storage│ │
│ ✅ source-counts-guard│ │
│ ✅ todo-scanner │ │
│ ✅ instruction-drift│ │
│ ✅ yaml/toml/json │ │
│ ✅ no large files │ │
│ ✅ no debug stmts │ │
│ ✅ no private keys │ │
│ ✅ BOM / symlinks │ │
│ ✅ case conflicts │ │
│ ✅ Windows names │ │
│ ✅ mixed line ending│ │
│ ✅ no-commit-to-branch│ │
│ ✅ name-tests-test │ │
│ ── Pre-push ──────── │ │
│ ✅ mypy (pre-push) │ │
│ ✅ semgrep (pre-push)│ │
│ ✅ pytest (pre-push) │ │
├──────────────────────┼──────────────────────────────────────┤
│ 🔧 自動修復： │ 🔧 自動修復： │
│ trailing whitespace │ tool-count-sync (auto-stage) │
│ end-of-file newline │ │
│ ruff --fix │ │
│ ruff format │ │
│ future-annotations │ │
└──────────────────────┴──────────────────────────────────────┘
uv sync # 安裝所有依賴 (含 pre-commit)
uv run pre-commit install # 安裝 pre-commit hook
uv run pre-commit install --hook-type pre-push # 安裝 pre-push hook (跑測試)
uv run pre-commit autoupdate # 更新所有 hook 版本 (ruff, pre-commit-hooks 等)
uv run pre-commit run --all-files # 驗證更新後所有 hook 正常
uv run python scripts/hooks/check_evolution_cycle.py # 手動執行一致性檢查
此腳本驗證：
當需要新增一個 hook 時，必須完成整個循環：
scripts/hooks/<name>.pyuv run python scripts/hooks/check_evolution_cycle.py⚠️ 如果只做了步驟 1-2 而沒有 3-5，evolution-cycle hook 會在 commit 時報錯。
💡 建議每月執行一次
autoupdate，自動取得最新的 ruff 規則、安全性檢查等。
當 AI agent 被要求「準備 commit」時，執行以下額外步驟：
┌─────────────────────────────────────────────────┐
│ AI Pre-Commit Orchestrator │
├─────────────────────────────────────────────────┤
│ Step 1: memory-sync [必要] Memory Bank 同步 │
│ Step 2: pre-commit-run [必要] 執行所有 hooks │
│ Step 3: readme-update [可選] README 更新 │
│ Step 4: changelog-update[可選] CHANGELOG 更新 │
│ Step 5: roadmap-update [可選] ROADMAP 更新 │
│ Step 6: arch-check [條件] 架構文檔檢查 │
│ Step 7: commit-prepare [最終] 準備提交 │
└─────────────────────────────────────────────────┘
Step 2 會執行
uv run pre-commit run --all-files，涵蓋 ruff、file hygiene、tool docs sync 等所有自動化檢查。mypy 和 semgrep 已移至 pre-push 階段以防 OOM。
由 pre-commit hook tool-count-sync 自動處理。也可手動執行：
uv run python scripts/count_mcp_tools.py --update-docs
此腳本會自動更新：
README.md - 工具數量README.zh-TW.md - 工具數量.github/copilot-instructions.md - 工具數量 + 完整列表src/.../TOOLS_INDEX.md - 完整工具索引| 參數 | 說明 | 預設 |
|---|---|---|
--skip-readme | 跳過 README 更新 | false |
--skip-changelog | 跳過 CHANGELOG 更新 | false |
--skip-roadmap | 跳過 ROADMAP 更新 | false |
--skip-hooks | 跳過 pre-commit hooks | false |
--dry-run | 只預覽不修改 | false |
--quick | 只執行必要步驟 (memory-sync + hooks) | false |
「準備 commit」 # 完整流程
「快速 commit」 # 等同 --quick
「commit --skip-readme」 # 跳過 README
SKIP=mypy git commit -m "quick fix" # 跳過 mypy (較慢)
git commit --no-verify -m "emergency" # 跳過所有 hooks (慎用!)
🚀 Git Pre-Commit 工作流
[1/7] Memory Bank 同步 ✅
└─ progress.md: 更新 2 項
└─ activeContext.md: 已更新
[2/7] Pre-commit Hooks ✅
└─ ruff lint: passed (auto-fixed 3 issues)
└─ ruff format: passed
└─ mypy: passed
└─ file hygiene: passed
└─ tool docs sync: passed (2 files updated)
[3/7] README 更新 ✅
└─ 新增功能說明
[4/7] CHANGELOG 更新 ✅
└─ 添加 v0.2.0 條目
[5/7] ROADMAP 更新 ⏭️ (無變更)
[6/7] 架構文檔 ⏭️ (無結構性變更)
[7/7] Commit 準備 ✅
└─ 建議訊息：feat: 新增用戶認證模組
📋 Staged files:
- src/auth/...
- docs/...
準備好了！確認提交？
| 檔案 | 用途 |
|---|---|
.pre-commit-config.yaml | pre-commit hooks 定義 |
pyproject.toml [tool.ruff] | ruff lint + format 規則 |
pyproject.toml [tool.mypy] | mypy type check 規則 |
pyproject.toml [tool.pytest] addopts | 強制多核測試 |
pyproject.toml [tool.bandit] | bandit 安全掃描規則 |
pyproject.toml [tool.deptry] | deptry 依賴衛生規則 |
vulture_whitelist.py | vulture 死碼掃描白名單 |
scripts/hooks/check_file_hygiene.py | 檔案衛生檢查 |
scripts/hooks/check_tool_sync.py | MCP 工具文檔同步 |
scripts/hooks/check_skills_frontmatter.py | .claude/skills YAML frontmatter 驗證 |
scripts/hooks/check_evolution_cycle.py | 自演化循環一致性驗證 |
scripts/hooks/check_commit_size.py | Commit 檔案數限制 (≤30) |
scripts/hooks/check_future_annotations.py | future annotations 強制 |
scripts/hooks/check_no_print.py | 禁止 src/ 使用 print() |
scripts/hooks/check_ddd_layers.py | DDD 層級依賴檢查 |
scripts/hooks/check_type_ignore.py | 禁止裸 type: ignore |
scripts/hooks/check_docstring_tools.py | MCP tool docstring 檢查 |
scripts/hooks/check_env_config.py | 禁止內層使用 os.environ |
scripts/hooks/check_tenant_scoped_storage.py | presentation 層儲存路徑須經 tenant_data_dir() |
scripts/hooks/check_source_counts.py | 確保每來源 API 回傳量顯示 |
scripts/hooks/check_todo_scanner.py | TODO/FIXME 掃描 |
scripts/hooks/check_instruction_drift.py | 工具 docstring 變更偵測 |
scripts/check_async_tests.py | async/sync 測試一致性 |
unicode-mojibake uses scripts/hooks/check_unicode_mojibake.py to block newly staged corrupted emoji/UTF-8 artifacts while allowing valid emoji.Complete reference for all 45 PubMed Search MCP tools. Triggers: 工具列表, all tools, 完整功能, tool reference, 有哪些工具
Deep exploration from a key paper using related, citing, reference, and citation tree tools. Triggers: 這篇論文的相關研究, 誰引用這篇, 類似文章, related articles, citation tree, paper exploration
Persistent, versioned research evolution with build_research_chronicle. Triggers: 研究脈絡, 研究演變, 研究編年史, research chronicle, 領域怎麼演進, 上次之後有什麼新的, 追蹤主題, 里程碑, milestone, timeline, 主題比較