no-mistakes axi命令详解AI代理的非交互TOON接口完全指南【免费下载链接】no-mistakesgit push no-mistakes项目地址: https://gitcode.com/GitHub_Trending/no/no-mistakesno-mistakes 是一款本地 Git 代码质量门禁工具其axi 命令Agent eXperience Interface专为 AI 代理设计它是一套非交互命令行接口只接受 flag 参数、将机器可读的 TOON 格式输出到 stdout让 Claude Code、Codex 等 AI 代理能像人一样走完代码审查、测试、推送、PR、CI 全流程审批全程无需人工接管终端。为什么 AI 代理需要非交互接口 人类使用 no-mistakes 时直接运行命令打开 TUI终端交互界面即可。但 AI 代理无法点击、无法按键它需要一套严格契约的命令行stdout 只输出 TOON一种键值对 表格的紧凑文本格式token 开销远低于 JSON代理解析零歧义stderr 输出进度run: running、review: fixing等状态行供观察存活但不污染数据错误也是结构化的失败时 stdout 输出error: ...help[N]建议命令列表代理读后直接行动而非解析栈追踪这套契约在 internal/cli/axi.go 中定义官方 CLI 参考见 docs/src/content/docs/reference/cli.md。axi 子命令速查表命令作用一句话说明no-mistakes axi主页视图显示仓库、当前分支、守护进程状态、活动 run 与下一步建议no-mistakes axi run启动验证触发当前分支的流水线阻塞到第一个审批门或最终结果no-mistakes axi respond应答审批门发送approve/fix/skip继续驱动 runno-mistakes axi status查看详情按当前分支范围解析 run含步骤状态与branch_sync对象no-mistakes axi logs读步骤日志--step name指定步骤默认尾部 40 行--full看全量no-mistakes axi sync分支同步应用结构化的守卫式同步/恢复方案绝不私自 reset 或 rebaseno-mistakes axi abort取消 run取消当前分支活动 run--run id可在任意位置按 ID 收割孤儿 run核心实现分布在 internal/cli/axi_drive.gorun / respond / abort 驱动逻辑与 internal/cli/axi_query.gostatus / logs 查询逻辑。典型验证工作流四步拿到绿色 PR 第 1 步axi run启动验证no-mistakes axi run --intent 给用户添加 --json 输出标志--intent传的是用户的目标而不是 diff 描述——代理最了解上下文直接告诉它比从会话记录推断更快更准。命令会阻塞到第一个审批门期间长耗时是正常的review、test、CI 每步可能数分钟不是卡死。第 2 步axi respond处理审批门返回内容中出现gate:对象时说明流水线在等待决策。每条 finding 都带action分类auto-fix—— 机械低风险代理可自行授权修复no-op—— 仅信息性无需处理ask-user—— 挑战用户明确意图必须升级给用户代理不能代答no-mistakes axi respond --action approve no-mistakes axi respond --action fix --findings r1 --instructions 补充错误处理 no-mistakes axi respond --action skip⚠️ 关键纪律run 进行中不要自己改代码。流水线同时拥有 finding 和修复权自行abort或rerun会丢弃在途工作、触发全量重验。--yes则代表用户已授意无人值守自动解析所有门。第 3 步axi status/axi logs观察进度no-mistakes axi status no-mistakes axi logs --step review --fullstatus严格限定在当前分支本分支没有 run 就如实报告runs_on_current_branch: 0绝不把其他分支的 run 张冠李戴--run id显式查看时对象会改挂在other_branch_run:键下防止误读。第 4 步分支归属与收尾输出里的branch_sync对象是分支归属的权威说明next_action.code决定下一步sync→ 运行no-mistakes axi sync守卫式同步recover_custody→ 运行no-mistakes axi sync --recover取回被终态 run 留下的未发布提交user_owned→ 分支完全归你无需任何操作CI 检查全绿后axi run返回outcome: checks-passed代理的职责到此结束应提示用户评审并合并 PR后台监视器会继续盯着 PR 直到合并、关闭或超时。退出码与错误处理速查退出码含义0成功、幂等 no-op或正常的审批门决策点1操作失败、failed/cancelled终态结果2用法错误参数缺失或不合法错误输出永远形如error: 原因加help[N]建议列表——例如在默认分支启动 run 会被拒绝并直接告诉你先git switch -c branch。这种拒绝并给出下一条命令的模式正是代理可自驱的基础。新手常见问题 Q和 TUI 是什么关系同一套审批流程的两个入口人用 TUI代理用 axi。no-mistakes init会为 Claude Code 等代理安装/no-mistakesskillskill 底层驱动的就是 axi 命令族完整驱动规则见 skills/no-mistakes/SKILL.md。Q代理能替代流水线里干活的 agent 吗不能。调用 axi 的代理是审批驱动者验证工作仍由配置的流水线 agent 执行缺少可用 runner 时 run 会在第一步前失败no-mistakes doctor可诊断。QTOON 长什么样就是key: value、findings[N]{id,severity,file,action,description}:表格、help[N]:建议列表三种元素例如一个 review 门会输出gate: review行、findings 表格和 6 条 help 命令——完整示例见 skills/no-mistakes/SKILL.md。延伸阅读入门指引docs/src/content/docs/start-here/quick-start.md代理驱动指南docs/src/content/docs/guides/agents.md项目总览README.md输出文章【免费下载链接】no-mistakesgit push no-mistakes项目地址: https://gitcode.com/GitHub_Trending/no/no-mistakes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考