no-mistakes 完全指南：如何让编码代理自己跑完 AI 门禁

no-mistakes 完全指南如何让编码代理自己跑完 AI 门禁【免费下载链接】no-mistakesgit push no-mistakes项目地址: https://gitcode.com/GitHub_Trending/no/no-mistakesno-mistakes是一个本地 Git 门禁工具把分支推给no-mistakes而不是origin它会在一个用完即弃的 worktree 里跑完 9 步 AI 校验流水线评审、测试、文档、Lint、推送、PR、CI只有全部检查通过才会把代码发出去并自动开出干净的 PR。而它的agent 技能/no-mistakes能让 Claude Code、Codex 等编码代理自己驱动整条门禁流水线只在需要你拍板的地方停下来问你。下面这份指南带你从零上手让编码代理替你跑门禁。3 步装好 no-mistakes5 分钟初始化核心关键词回顾/no-mistakes技能依赖三步准备——安装、体检、初始化。第 1 步安装macOS / Linux 用户执行官方安装脚本docs/install.shcurl -fsSL https://gitcode.com/GitHub_Trending/no/no-mistakes/raw/main/docs/install.sh | sh安装器会把二进制放到~/.no-mistakes/bin链接到~/.local/bin并重启后台 daemon。第 2 步体检no-mistakes doctor它逐项检查 git、daemon、各 agent 二进制claude、codex、grok、opencode、pi、copilot、antigravity等最后一行gate validation是决定性结论只要有一个可运行的流水线 agent 即可。第 3 步初始化仓库no-mistakes init这一步会创建本地网关 bare 仓库、安装 Git hooks、添加no-mistakesremote并为用户级安装/no-mistakes技能——之后在任何仓库里你的编码代理都能直接调用它。升级后重跑一次no-mistakes init可刷新技能文件。两种调用方式先干活再校验或只校验技能文件位于 skills/no-mistakes/SKILL.mdno-mistakes init会把它安装到你的 agent 环境如.agents/skills、.claude/skills。/no-mistakes有两种模式模式用法适用场景Task-first先任务后校验/no-mistakes 给 status 命令加一个 --json 参数让代理先完成编码任务再自动提交到功能分支并跑流水线Validate-only仅校验裸输入/no-mistakes工作已提交到功能分支只想让现有代码过一遍门禁Task-first 模式下代理会遵循一套严谨的动作清单先查范围—— 改动前检查git status保留无关的未提交内容只提交属于本任务的部分干活并提交—— 如果当前在默认分支先创建功能分支再提交门禁只校验非默认分支上的已提交历史带意图校验—— 用你的任务原文作为--intent启动流水线。意图不是 diff 摘要而是用户要达成的目标 沿途做过的取舍评审步骤靠它区分有意为之和写错了。门禁九步流水线代理替你跑完哪些关卡无论哪种模式代码都要通过同一套顺序固定的流水线详见 docs/src/content/docs/concepts/pipeline.mdIntent → Rebase → Review → Test → Document → Lint → Push → PR → CIReviewAI 评审对 diff 做代码评审产出带严重级别的 findingTest / Lint / Document定向测试 证据采集、静态检查、文档补齐Push → PR → CI全部本地检查通过后才推送、自动创建 PR并持续盯 CI。关键设计人始终说了算。每一步要么自己通过要么停下来抛出一条finding等你处理。门禁处的 3 种动作approve / fix / skip流水线暂停时gate:每条 finding 都有一个action标记代理按规则处理finding 动作含义代理会怎么做auto-fix机械性、低风险代理可自主判断交给流水线修复后复审no-op仅提示无需处理直接放行ask-user挑战你的意图或影响产品行为必须停下原样转述 finding 给你由你决定批准 / 修复 / 跳过底层命令是非交互的no-mistakes axi命令族详见 internal/cli/axi.gono-mistakes axi run --intent 用户的原始目标 no-mistakes axi respond --action approve # 放行当前步骤 no-mistakes axi respond --action fix --findings r1 # 让流水线修复指定 finding no-mistakes axi respond --action skip # 跳过该步骤三条使用铁律运行期间不要自己动手改代码—— finding 和修复都归流水线管你只负责决策不要在运行中途 abort / rerun—— 那是两次运行之间才允许的动作中途重来会丢弃流水线在途的工作--yes才代表你授权无人值守—— 它会把所有ask-user类 finding 也自动修复只在用户明确要求全程不用问我时使用。结果判读什么时候代理可以收工流水线结束时会返回outcome:✅checks-passed—— 校验全绿、CI 通过但 PR 尚未合并。这是代理的成功终点它会向你汇报PR 已就绪请审查并合并然后后台继续监控。若后续 PR 落后于默认分支或出现合并冲突监控器会自动 rebase、解决冲突、从 Review 重启校验无需任何手动操作✅passed—— PR 已被合并或关闭❌failed/cancelled—— 按输出指向的问题修复后在同一功能分支上重新提交再用no-mistakes rerun或重新发起运行。成功结束时如果流水线替你修掉了你原本没注意到的问题输出里会带一张fixes表代理会逐条列出这些修复方便你复核。进阶技巧选 agent、配 fallback、看日志选哪个 agentno-mistakes 不挑 agentclaude、codex、grok、rovodev、opencode、pi、copilot、antigravity或经acpx走cursor/acp:target详见 docs/src/content/docs/guides/agents.md。常用配置# ~/.no-mistakes/config.yaml agent: auto # 自动选第一个可用的 agent # agent: [codex, grok] # 有序 fallback首选不可用时自动切换仓库级配置.no-mistakes.yaml中的agent字段优先级更高可以为特定项目单独指定 agent。常用状态命令在代理里或终端里都能用no-mistakes axi status # 查看当前运行的完整状态 no-mistakes axi logs --step review --full # 查看某一步完整日志 no-mistakes axi sync --check # 校验分支同步计划卡住了怎么办先跑no-mistakes doctor看配置每个axi响应尾部都带help列表会直接告诉你下一条该执行的命令。常见问题FAQQ代理在门禁处一直不返回是不是卡死了不是。Review、Test、CI 各需几分钟axi run和respond是同步阻塞的运行到gate:停下等你响应才算正常。想看进度而不干扰运行另开一次no-mistakes axi status。Q为什么有时代理停下来等我有时自己就解决了看 finding 的actionauto-fix/no-op代理可以自主处理ask-user涉及你的意图判断按技能规则必须停下来向你转述原文再等你的决定。QPR 合到一半遇到别人的合并导致冲突要手动 rebase 吗不用。checks 通过后的 CI 监控器仍在后台运行发现真实冲突会自动 rebase 并重新走校验只有当监控器已失效PR 被关闭、运行被中止等才用no-mistakes rerun恢复。Q不想让代理全程自动修怎么限制Review 的自动修复默认就是关闭的auto_fix.review: 0阻塞性和ask-userfinding 都会停下来等你决策test/lint 等步骤才允许流水线内部先自动修复再运行。完整清单从装好到跑通步骤命令说明1. 安装curl ... install.sh \| sh二进制 daemon2. 体检no-mistakes doctor确认有可运行 agent3. 初始化no-mistakes init建网关 安装/no-mistakes技能4. 开跑对代理说/no-mistakes 任务代理完成编码并自动过门禁5. 决策批准 / 修复 / 跳过 findings只有ask-user会问到你6. 收尾审查 PR 并合并代理汇报 fixes 表供复核把推代码变成过门禁你只需要做一件事在代理需要拍板的地方给出你的决定。【免费下载链接】no-mistakesgit push no-mistakes项目地址: https://gitcode.com/GitHub_Trending/no/no-mistakes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考