用途:这是一个组合式元技能(Meta-Skill),在提交代码前对当前已暂存(staged)的 diff 并行运行三道独立质量门,最后仲裁出一个统一的“是否可发布”结论(BLOCK 或 APPROVE)。
主要能力:并行执行 ruff(代码检查)、mypy(类型检查)、pytest(测试)三道质量门,并汇总为单一裁决。
使用方式:可通过说出“pre-commit quality gate”或 frontmatter 中列出的本地化触发词来触发。该技能也设计为可通过软路径(meta_invoke)从 git pre-commit 钩子调用,但钩子安装属于单独的手动步骤。
回退方案:若编排器失败(子 Agent 报错、超时等),调用方应按顺序手动运行:uv run ruff check src tests、uv run mypy src/opensquilla --show-error-codes、uv run pytest -q。这三条命令同时也是 .github/workflows/ci.yml 中的 CI 质量门。
适用场景:提交代码前的本地质量检查,以及 CI 中的质量门。
限制:钩子安装需手动完成;编排器失败时需手动执行回退命令。其余细节暂未提供。