用途:在 Git 提交前编排所有准备工作,形成一个双层防护加自演化的质量守门流程。Layer 1 由 pre-commit hooks 自动执行代码质量检查,Layer 2 由 AI 编排器处理文档同步。\n\n主要能力:自动执行 ruff lint/format、bandit 安全扫描、vulture 死码、deptry 依赖、文件卫生、commit 大小限制、async/sync 测试一致性、MCP 工具数量同步、skills frontmatter、evolution-cycle、future annotations、no-print-in-src、DDD 层依赖、type ignore、docstring、TODO 扫描、instruction drift 等检查。mypy、semgrep、pytest 移至 pre-push 阶段。AI 编排器按顺序执行 memory-sync、pre-commit-run、readme-update、changelog-update、roadmap-update、arch-check、commit-prepare,其中前两步为必要步骤。\n\n必要用法:一次性安装依赖并启用 hook,命令为 uv sync、uv run pre-commit install、uv run pre-commit install --hook-type pre-push。可执行 uv run pre-commit autoupdate 更新 hook 版本,并用 uv run pre-commit run --all-files 验证。手动一致性检查为 uv run python scripts/hooks/check_evolution_cycle.py。工具数量同步可手动执行 uv run python scripts/count_mcp_tools.py --update-docs。支持参数 --skip-readme、--skip-changelog、--skip-roadmap、--skip-hooks、--dry-run、--quick。可用 SKIP=mypy git commit -m "quick fix" 跳过特定 hook,或 git commit --no-verify 跳过全部。\n\n适用场景:使用 pre-commit framework 与 AI 编排器的 Git 项目,需要在提交前同步文档、工具数量并执行多层检查。限制:新增 hook 必须同步更新 .pre-commit-config.yaml、copilot-instructions.md、SKILL.md、CONTRIBUTING.md 并执行验证,否则 evolution-cycle 会报错;其他平台与收费信息暂未提供。
git-precommit
通用与其它
更新于 10-16 09:44