Zeroshot 工程验证循环
用独立验证者反复审查编码代理的改动，直到通过或给出可复现失败。
- Star 数
- ★ 2.1k
- 最近更新
- 今天
- License
- MIT
- 主语言
- Rust
- FA 评分
- 63/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 维护 GitHub 仓库的工程师，针对编号 issue 实现有明确验收标准的功能，并希望由独立代理审查结果。
- 不适合
- Windows 用户（官方明确暂不支持）
- 需要图形界面而非终端操作的团队
- 源码审查
- 63/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
Zeroshot 是面向自主软件工程的开源多代理编排 CLI。它驱动已安装的 Claude Code、OpenAI Codex、Gemini CLI 或 OpenCode，将实现任务的 executor 与未见过其过程的独立 verifier 分开。conductor 会按任务复杂度和类型选择工作流，执行者在当前目录、Git worktree 或 Docker 中修改代码，验证者给出 APPROVED 或带可复现问题的 REJECTED。运行状态和事件会写入崩溃安全的 SQLite ledger，因此可以用 zeroshot resume <id> 继续中断的任务。默认模式只修改文件、不提交也不推送；--pr 和 --ship 则扩展为 worktree、拉取请求与审批后的自动合并流程。
通过 zeroshot run <input> 接收 GitHub issue 编号、Issue URL、Jira key、Markdown 文件或内联任务文本；Issue 后端会从 git remote 自动识别 GitHub、GitLab、Jira 或 Azure DevOps。conductor 对任务分类并选择 agents 与 validators，executor 调用选定的 provider CLI 实现改动，verifier 在不共享 executor 上下文或历史的条件下检查结果并返回 APPROVED 或 REJECTED。拒绝时，循环携带可操作、可复现的失败信息再次执行；事件写入 SQLite ledger，可用 zeroshot list、zeroshot status <id>、zeroshot logs <id> -f、zeroshot stop <id> 和 zeroshot resume <id> 管理。zeroshot cmdproof check <id> 可复用已验证的精确命令结果；在 --pr 或 --ship 流程中，git-pusher 会在所有配置质量门拥有新鲜的通过证据前失败关闭。
- 维护 GitHub 仓库的工程师，针对编号 issue 实现有明确验收标准的功能，并希望由独立代理审查结果。
- 使用 OpenAI Codex 的团队，需要把现有编码 CLI 放入实现—验证循环，而不是更换模型或托管密钥。
- 准备提交拉取请求的开发者，使用
--worktree --pr在隔离分支中完成修改并在验证通过后创建 PR。 - 运行风险较高实验或并行任务的平台工程师，使用
--docker将每次执行放入容器隔离环境。 - 因重启或中断而暂停自动化开发任务的团队，通过 SQLite ledger 和
zeroshot resume <id>恢复原有运行。
如何安装或部署这个 Agent？
安装 Node.js 18 或更高版本，并安装至少一个支持的 provider CLI。然后执行：
npm install -g @the-open-engine/zeroshot可用 zeroshot providers 查看已安装的 provider；例如选择 Codex：
zeroshot providers set-default codex如需按 Issue 后端读取任务，还需安装相应 CLI：GitHub 使用 gh，GitLab 使用 glab，Jira 使用 jira，Azure DevOps 使用 az。README 说明当前支持 Linux 和 macOS，Windows 尚未支持。
如何使用这个 Agent？
先确保至少一个 provider CLI 已完成其自身认证，再运行一个任务：
zeroshot run 123也可以运行本地规格或内联需求：
zeroshot run feature.md
zeroshot run "Add a --json flag"为单次任务切换提供方：
zeroshot run 123 --provider gemini需要隔离并创建 PR：
zeroshot run 123 --pr查看运行日志：
zeroshot logs <id> -f这个 Agent 有哪些优点和局限？
- 实现者和验证者被明确隔离；验证者不查看 executor 的上下文或历史，避免由同一代理自行批准。
- 支持 Claude Code、OpenAI Codex、Gemini CLI 和 OpenCode，可在已有编码 CLI 外增加编排层。
- SQLite ledger 持久化每一步事件，运行在崩溃或重启后可用
resume继续。 --pr与--ship流程对配置的质量门采用失败关闭，缺少新鲜通过证据时不会交接。
- 需要 Node.js 18+，并且必须预先安装和认证至少一个外部 provider CLI。
- 最佳适用任务需要清晰、可验证的验收标准；“让应用更快”或“改进代码库”等探索性任务不适合。
- 默认模式会直接修改文件但不提交或推送，团队需要自行审阅和管理变更；隔离或 PR 流程需显式启用。
- Docker 模式可能挂载
gh、git、ssh 等凭据目录，采用前需要审查挂载范围；Windows 被明确延期。
这个 Agent 与同类方案有什么区别？
相较于单一编码代理在自行判断完成时停止，Zeroshot 让独立 verifier 审查实际改动和测试结果，并在失败时返回可复现问题；它仍复用 Claude Code、Codex、Gemini CLI 或 OpenCode 作为执行编码的提供方。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Zeroshot 工程验证循环 当前 | 63 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 2.1k | 今天 | Rust | Codex · Claude Code |
| pitwall | 70 · 存在缺口 | — | ★ 18 | 1 天前 | Go | Codex · Claude Code |
| AGRO 沙箱运行时 | 49 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 43 | 6 天前 | TypeScript | Codex · Claude Code |
| MCO | 73 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 550 | 1 个月前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README 明确支持工作树隔离、Docker 隔离、--no-isolation 逃生舱，以及 --pr/--ship 需要用户确认；提供方凭据不存储，由 CLI 管理；有 SECURITY.md 报告漏洞；依赖有 overrides 和 CI 安全审计。扣分：发布者未验证，来源归属仅基于仓库元数据；未提供密钥管理细节。
证据显示：有大量测试（单元、集成、E2E），CI 包含类型检查、lint、安全审计；README 描述崩溃安全 SQLite 日志和恢复命令。扣分：静态审查无法验证测试通过或运行时行为；依赖可用性未完全验证。
证据显示：README 明确目标用户（开发者）、适用场景（有明确验收标准的任务）、支持多种提供方和问题源；有 --no-isolation 等选项适应不同环境。扣分：Windows 未支持，环境适配有限。
证据显示：有 README、LICENSE、SECURITY.md、CONTRIBUTING.md 等；安装说明清晰；版本号自动递增但注明不稳定；有已知限制（无 TUI、Windows 未支持）。扣分：版本号不稳定，变更日志未提供；维护责任未明确。
证据显示：README 声称 100 倍速度、90 分钟运行、5 次迭代，但无基准数据；提供独立验证价值。扣分：成本效益未量化，静态审查无法验证性能声明。
证据显示：README 描述架构和流程，有架构图；测试文件验证具体行为；CI 有 CodeQL 和 Trivy 扫描。扣分：静态审查无法验证运行时结果；部分声明（如速度）无证据支持。
- 发布者未验证，来源归属仅基于仓库元数据。
- 版本号自动递增，不稳定，需固定版本。
- Windows 未支持，环境适配有限。
- 性能声明（如 100 倍速度）无基准数据支持。
- 静态审查无法验证测试通过或运行时行为。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
zeroshot-python-v11.1.0_1 Zeroshot Python SDK 11.1.0.post1
-
v11.1.0 Zeroshot v11.1.0
发布说明摘录
Changes since [v11.0.0](https://github.com/the-open-engine/zeroshot/compare/v11.0.0...v11.1.0). Features Add an opt-out for automatic skill installation ([#1350](https://github.com/the-open-engine/zeroshot/pull/1350)) Add documented ZEROSHOT_SKIP_SKILLS=1 support for npm installation and self-update while preserving default managed-skill protections. Isolate updater tests from the exported setting. Allow disabling workspace checkpoints ([#1344](https://github.com/the-open-engine/zeroshot/pull/1344)) Add workspaceCheckpoints to runtime plans, defaulting to enabled. …在 GitHub 查看 ↗ -
zeroshot-python-v11.0.0_1 Zeroshot Python SDK 11.0.0.post1
常见问题
Zeroshot 会保存我的模型 API 密钥吗？
验证失败后会发生什么？
REJECTED 及可操作、可复现的失败信息，循环会继续，直到通过验证或交回具体无法完成的原因。它会自动提交、推送或合并代码吗？
--pr 会启用 worktree 并创建拉取请求，--ship 在审批后自动合并。