SuperAPI AI 工具集

no-mistakes

测试与质量

查看项目

更新于 10-15 18:31

技能介绍

用途:no-mistakes 是本地门禁,按流水线(意图、rebase、review、test、document、lint、push、PR、CI)校验代码改动,再让其进入上游。通过 no-mistakes axi 命令族驱动,stdout 输出机器可读的 TOON,stderr 显示进度。

调用方式:/no-mistakes 有两种模式。仅校验模式为裸命令,用户改动已提交,直接校验并报告结果。任务优先模式为 /no-mistakes <task>,先自行完成任务再走流水线:检查范围,保留无关的未提交改动,只提交属于任务的内容;在特性分支上提交;若处于默认分支需先建分支;随后校验,并用 --intent 传入用户任务原话。

前置条件:改动必须已提交在分支上,不能在默认分支,仓库需先 no-mistakes init。不满足时 axi run 会报错并给出修复命令;命令缺失或异常可用 no-mistakes doctor 检查。开始前可用 no-mistakes axi 主页视图确认是否已有运行,避免重复启动,可恢复或 axi abort。

用法:启动运行需传 --intent,说明用户目标;写全决策与取舍,评审步骤据此区分有意决定与错误。axi run 与 axi respond 同步阻塞,review、test、CI 可能耗时数分钟,应设长超时,勿因慢取消或重发;另用 no-mistakes axi status 查看进度。输出含 gate: 时等待响应:auto-fix 可自行授权修复,no-op 无需处理,ask-user 须升级给用户。响应命令包括 no-mistakes axi respond --action approve、--action fix --findings <id1,id2> --instructions "<可选指导>"、--action skip。运行中不要自行改代码修复,由流水线负责。respond 还支持 --add-finding '<json>' 与 --step <name>。

结果与检查:outcome 为 checks-passed 表示校验通过、CI 绿但 PR 未合并,应告知用户并让其评审合并,不要等待合并;passed 表示已合并或关闭;failed 或 cancelled 则需读取输出修复后重跑(no-mistakes axi run 或 no-mistakes rerun)。查状态命令:no-mistakes axi、no-mistakes axi status、no-mistakes axi logs --step <name> --full、no-mistakes axi abort。输出为 TOON 格式,错误以 error: 开头并附 help 列表;退出码 0 成功、no-op 或正常决策门,1 失败或取消,2 用法错误。若用户明确同意自动驱动,可传 --yes,将 auto-fix 与 ask-user 均视为同意修复。

限制:必须已提交在非默认分支且仓库已初始化;校验的是已提交历史而非工作区;ask-user 类发现不由代理自行决定;CI 步骤会监视 PR 直至合并或关闭。具体标记、字段与列可能随步骤和版本变化。