2026-07-22 6 分钟PRACTICAL_GUIDE

让 AI 编程 Agent 一直跑到检查通过——或者明确停下

用终端 AI 编程 Agent 完成写代码、跑项目检查、审查阻塞项、修复的循环，直到有证据支撑的 Gate 返回 PASS，或返回明确的非 PASS 结论。

> 为什么一轮对话不够

编程 Agent 可能改对了文件，却在仓库真正就绪之前就停下：测试没过、格式化被拒、或者一个只读审查者发现了写代码那一方没注意到的阻塞项。

Wukong Code 把"完成"当成一个循环，而不是模型最后说的一句话：目标保持不变，改一次代码、跑一次项目检查、审查结果，再把阻塞证据喂给下一轮。

> 从终端启动 Loop

装好 Wukong、配置好模型 provider，然后用 --dry-run 预览一个具体的验收目标。在任何 headless Loop 启动之前，先审阅它提出的 workspace、检查项（或版本化的 no-check 决定）、上限、Gate 批准和 provider 去向。

Headless 预检
curl -fsSL https://wukong.today/install.sh | sh
wukong provider
wukong loop "fix all failing tests" --max-iterations 5 --dry-run
# Review “Headless start flags”, then rerun the same command with those exact flags.

> Loop 里到底发生了什么

每一轮都由同一份冻结的验收合同驱动：目标、可选的完成标准、Must not 规则，以及必须跑的检查。写代码的一方不能改这份合同，也不能把失败的检查从计划里悄悄拿掉。

审查用的是全新上下文的只读 reviewer，它看的是改动和检查输出，而不是写代码那一方的自述。

Wukong TUI
wukong
/loop fix all failing tests
/loop status
/loop pause
/loop stop

> 成本与轮次都有上限

迭代次数、writer 与 reviewer 的 provider 调用次数、token 预算都可以单独设上限。触到任何一个上限，Loop 就以非 PASS 结束并说明原因，而不是继续烧钱。

> 结果怎么读

只有 PASS 代表冻结的 Gate 计划真的跑过、且支撑它的证据完整新鲜。其余结论各自说明了不同的事情，处理方式也不同。

> 相关指南

读懂 PASS、NEEDS_WORK、ERROR 与暂停阅读 仓库没有测试时会发生什么阅读

在你的仓库里试一次

Wukong Code 在 macOS、Linux 和 Windows 上均为免费 BYOK。

[下载_WUKONG]