Open-source meta-harness for coding agents. Define your own workflows, reviewers and repair loops. zeroshot enforces the process you configure.

zeroshot – 自动化 AI 智能体编码与审查流水线

简介 – zeroshot 是一个 CLI 驱动的引擎，允许您将 AI 编码智能体（Codex、Claude Code、GitHub Copilot、Pi 等）编排到审查、修复和交付步骤的图中。您可以定义工作流（有向图），指定哪个智能体负责工作、哪些独立审查者必须批准、允许的重试次数以及被拒绝输出的处理方式。引擎在运行时强制执行该图，将所有内容记录到 SQLite 账本中，并可在本地、Docker 或托管的 zeroshot Cloud 中运行。

核心概念

概念	说明
Agent / Harness	实际编写或修改代码的编码模型（例如 OpenAI Codex、Anthropic Claude、GitHub Copilot、Pi）。
Graph	描述节点（工作者、审查者、测试者、交付）和边（通过/失败路由、重试限制）的声明式工作流。
Profile	保存的图 + 每个节点的运行时配置（模型、工作量级别、会话范围）的组合。
RuntimePlan	告知每个节点要使用哪个模型、工作量以及任何节点特定选项的 JSON。
交付标志	`--push`、`--pr`、`--ship` 控制结果保留在本地、推送到分支、作为 PR 打开还是 CI 后合并。
Ledger	持久化 SQLite 数据库（`.zeroshot/`），记录每个事件、决策和构件以供审计。

主要功能（根据 README 描述）

独立审查循环 – 工作者生成代码，然后一个或多个审查者并行运行。拒绝会自动路由回工作者并附上反馈进行修复。
每个节点模型灵活 – 每个节点可以使用不同的 LLM 提供商和规模；您可以混合使用 Codex、Claude、Copilot 等。
重试限制和有界运行 – 图可以指定在整体运行被视为失败之前节点可以重试的次数。
内置模板 – software-change、auto-research 等为常见任务提供现成的图。
自托管 Docker 目标 – 通过 zeroshot-target 容器在您自己的基础设施上运行引擎及其状态。
本地 UI – zeroshot ui 启动 Web UI（默认 http://127.0.0.1:4173/ui/）以监控运行、查看日志和编辑配置文件。
CLI 优先工作流 – 所有操作（运行、列表、状态、日志、模板显示）都可通过命令行使用。
开源，MIT 许可 – 核心引擎、UI 和 Python SDK 均以 MIT 许可发布。

典型用例

带有安全门控的自动化代码更改 – 开发人员要求 LLM 实现功能；引擎在提交之前运行安全、验收和代码审查智能体。
研究循环 – auto-research 模板运行多个“侦察 → 规划 → 评判”迭代来探索解决方案，并自动归档成功的候选方案。
团队范围的审查策略 – 组织可以编码强制性的审查步骤（例如安全审计 + UI 审计），并针对每个 AI 生成的更改强制执行。
成本效益扩展 – 在审查循环中放置小巧、便宜的模型，以更低成本实现更大模型的品质（如 ProgramBench 任务所示）。
适用于受监管环境的自托管 CI – 在安全网络内运行 Docker 目标，将所有代码和日志保留在本地。

入门（快速开始）

# 全局安装 CLI（需要 Node 18+）
npm install -g @the-open-engine-company/zeroshot

创建任务描述 – 带有 task 字段的 input.json。
定义运行时 – 选择 harness（例如 codex）和模型 ID 的 runtime.json。

运行 –

zeroshot run \
  --title "Add JSON status output" \
  --template software-change \
  --input input.json \
  --uniform-runtime-config runtime.json

查看进度 – 打开另一个终端并运行 zeroshot ui（或访问 http://127.0.0.1:4173/ui/）。
可选交付 – 添加 --push、--pr 或 --ship 以将更改推送到远程仓库。

对于云使用，请连接 GitHub 并通过 Zeroshot Cloud UI 提供您的模型 API 密钥。

架构概览

CLI（Node.js） – 解析命令、构建运行计划、启动原生引擎、提供 UI。
原生引擎（Rust） – 执行图、与模型 harness CLI 通信、写入 SQLite 账本，并在自托管时运行 Docker 目标。
Harness CLI – 围绕 Codex、Claude、Copilot、Pi 的轻量包装器，为引擎提供统一 API。
Python SDK – 允许以编程方式与集群 API 交互（未在 README 中涵盖，但已列出）。

社区与支持

Discord 社区、GitHub Issues 和公开路线图。
文档网站：https://zeroshot.sh/docs/
自托管 Docker 镜像：ghcr.io/the-open-engine/zeroshot-target:latest。

许可证

MIT – 请参阅仓库的 LICENSE 文件。

the-open-engine/zeroshot