Bernstein

这个 Agent 能做什么，适合哪些场景？

Bernstein 是面向 Claude Code、Codex CLI、Gemini CLI 等 CLI 编码代理的确定性编排器。它先将目标拆解为任务，随后以普通 Python 调度执行；编码任务各自在独立 Git worktree 中运行，产物型任务则使用独立工作目录。系统通过 lint、类型检查和测试等具体信号验证任务，再将通过验证的代码合并到主分支。每次运行都会写入 lineage spine 与 replay journal；启用 BERNSTEIN_AUDIT=1 时，还会生成可离线验证的 HMAC 审计链与收据。它提供 CLI、TUI 实时视图、Web UI、MCP server mode、YAML 工作流，以及 air-gap 安装配置。

运行 bernstein init 会创建 .sdd/ 工作区和 bernstein.yaml。使用 bernstein -g "..." 时，Bernstein 将目标拆解为带角色、文件归属和完成信号的任务，在每个编码任务的 Git worktree 中调用已配置的 CLI 代理，并以测试、文件存在性、lint 和类型检查作为门禁；验证通过后合并结果。bernstein run plan.yaml 可直接执行声明式多阶段计划，计划可包含 agent、command 与 loop 节点。它将运行记录写入 replay journal 和 lineage spine；bernstein replay latest --verify、bernstein lineage verify <run_id>、bernstein audit verify 可重新核验记录，bernstein verify run 可生成 Ed25519 签名的可携带运行收据，bernstein verify receipt 可仅凭收据文件离线验证。

1. 需要让 Codex CLI、Claude Code 或 Gemini CLI 并行修改同一代码库的工程团队，可为每个编码任务分配独立 Git worktree，避免默认共享可变文件状态。
2. 需要可复核变更过程的安全、合规或评审团队，可启用 BERNSTEIN_AUDIT=1，并将审计链与签名运行收据交给离线审阅者验证。
3. 已有明确任务 DAG、不想在计划阶段调用模型的开发负责人，可用 bernstein run plan.yaml 执行 YAML 多阶段计划。
4. 要定位一次自动化任务在哪个验证步骤失败的维护者，可运行 bernstein audit diagnose <run_id> --signal gate --sign-key KEY 生成签名诊断收据。
5. 在隔离网络或不使用第三方数据平面的环境中部署编码自动化的团队，可采用其文件式状态和 air-gap 安装配置。

这个 Agent 有哪些优点和局限？

如何安装或部署这个 Agent？

运行环境需要 Python 3.12+ 和 Git。安装命令：

pipx install bernstein

随后进入目标项目并初始化：

bernstein init

还需在机器上安装可用的受支持 CLI 编码代理；README 列举了 Claude Code、Codex CLI、Gemini CLI 等，并提供 bernstein integrations list --installed 查看本机可用集成。README 未给出各代理的认证凭据配置步骤。

如何使用这个 Agent？

在已初始化的项目中执行首个目标：

bernstein -g "fix the failing test in tests/test_foo.py"

查看进度可运行 bernstein live。若已有计划文件，运行：

bernstein run plan.yaml

要为运行保留可核验审计记录，可执行：

BERNSTEIN_AUDIT=1 bernstein -g "fix the failing test in tests/test_foo.py"

之后可用 bernstein replay latest --verify 和 bernstein lineage verify <run_id> 验证记录。

常见问题