SuperAPI AI 工具集

no-mistakes

编程与开发

查看项目

更新于 10-24 17:19

技能介绍

no-mistakes 是一个本地代码变更验证闸门,在代码变更到达配置的推送目标之前,通过一条流水线进行自动化验证。流水线阶段包括:意图(intent)、变基(rebase)、评审(review)、测试(test)、文档(document)、Lint(lint)、推送(push)、PR 和 CI。用户通过 no-mistakes axi 命令族驱动该工具,命令会向 stdout 输出机器可读的 TOON 格式结果,向 stderr 输出进度信息。

主要能力:

  • 自动代码评审、测试、Lint、文档生成、推送、创建 PR 并运行 CI 验证。
  • 通过 no-mistakes axi run 启动验证,通过 no-mistakes axi respond 响应闸门(gate)处的决策点。
  • 支持 --intent 参数传递用户意图,帮助评审步骤区分刻意决策与错误。
  • 提供 no-mistakes axi status、no-mistakes axi logs、no-mistakes doctor 等安全诊断命令。
  • 支持跳过特定步骤,例如 --skip=lint。
  • 在闸门处可选择 approve(批准)、fix(让流水线修复指定发现项)、skip(跳过)等操作。
  • 输出 outcome 包括 checks-passed、passed、passed-with-skips、failed、cancelled 等。

使用方式:

  1. 确保仓库已通过 no-mistakes init 初始化,当前位于功能分支(非默认分支),且变更已提交。
  2. 运行 no-mistakes axi(主页视图)检查当前分支是否有活动运行。
  3. 使用 no-mistakes axi run --intent "<用户目标>" 启动验证。
  4. 若输出包含 gate: 对象,阅读发现项并选择 no-mistakes axi respond --action approve/fix/skip 等响应。
  5. 重复响应直到输出 outcome:,根据结果处理后续(如 checks-passed 时提示用户评审并合并 PR)。

两种调用模式:

  • 仅验证模式:直接运行 /no-mistakes(可带跳过 Lint 等标志),验证已提交的变更并报告结果。
  • 任务优先模式:/no-mistakes <任务>,先执行任务并在功能分支提交,然后以任务描述作为 --intent 进行验证。

适用场景:

  • 在推送代码前进行自动化质量门禁检查。
  • 需要统一执行评审、测试、Lint、文档、PR 和 CI 流程的团队或个人项目。
  • 通过机器可读输出集成到自动化工具或代理工作流中。

限制:

  • 变更必须已提交在功能分支上,闸门验证的是已提交历史,而非未提交的工作区。
  • 仓库必须已用 no-mistakes init 初始化。
  • 守护进程必须配置可运行的流水线代理(支持的本地代理二进制、agent: cursor ACP 别名或通过 acpx 的 acp:<target>),否则运行会在第一步前失败。
  • 在验证步骤代理内部运行时,不得初始化、启动、重新附加、重跑、响应、同步、中止、弹出或直接推送 no-mistakes 流水线;遇到 nested_gate_context 错误应立即停止并返回控制权给外层执行器。
  • 运行期间不要手动编辑代码修复发现项,应通过 axi respond --action fix 让流水线处理。
  • 自动修复评审默认禁用(auto_fix.review: 0),阻塞性评审发现项会暂停等待决策。
  • axi run 和 axi respond 默认等待 8 分钟,超时并非失败,可通过 status 检查并重新附加。
  • 测试质量规则:不得添加仅通过读取、grep、解析或快照实现源代码来断言字符串/令牌/行等的测试;应执行公共或可执行接口并断言可观察行为。
  • 恢复和同步操作需遵循 branch_sync 对象中的 next_action 指引,不得随意使用普通 --recover 或重跑替代。