代理 运行
PRD输入。提交代码输出。没有人在循环中。
agentloop是一个CLI，它协调一组AI代理自主构建软件。你给它一份产品需求文件。它计算出执行顺序，引发测试编写者、构建者和代码审查者的并行浪潮，直到每个任务都被提交或尝试了六次后放弃，它才会停止。
你不照看它。你不批准中期公关。你按下进入键，然后走开。
______________________________________________________________________
问题
AI编码助手速度很快，但他们仍然需要你坐在椅子上。你提示，你复习，你课程正确，你再提示。对于一个包含10个任务的功能，这意味着需要来回数小时，而你就是瓶颈。
agentloop将您完全从循环中删除。它运行整个软件开发生命周期——测试、构建、审查、提交——作为一个检查彼此工作的专业代理管道。
______________________________________________________________________
运作原理
prd.json
│
▼
┌──────────────────────────────────────┐
│ Planner (Claude, no tools) │
│ Reads tasks, builds dependency graph│
│ Groups into parallel waves │
└──────────────┬───────────────────────┘
│
┌─────────▼─────────┐
│ Wave 1 │
│ ┌───────────────┐ │
│ │ Task A │ │ Each task runs the full pipeline:
│ │ Task B │ │
│ │ (parallel) │ │ test-writer ──▶ builder(s) ──▶ reviewer
│ └───────────────┘ │ │
└─────────┬──────────┘ ┌─────────────┤
│ │ SHIP IT │ CHANGES NEEDED
┌─────────▼─────────┐ ▼ ▼
│ Wave 2 │ committer rebuild + re-review
│ (depends on W1) │ (up to 6 attempts)
└─────────┬──────────┘
│
┌─────────▼─────────┐
│ PM Agent │
│ Writes sprint │
│ summary │
└────────────────────┘代理人
每个代理都是一个克劳德子流程，有自己的角色、工具和约束：
| 代理 | 作业 | 关键约束 |
|---|---|---|
| 测试编写器 | 在任何代码存在之前写入失败的测试 | 如果测试在写入时通过，则硬停止 |
| 建造者 | 写入代码，直到所有测试都通过 | 从不触碰测试——标记它，如果有一个测试似乎错误，则停止 |
| 代码审查员 | 已完成工作的只读审计 | 排放 SHIP IT 或 CHANGES NEEDED 有特定的修复 |
| git提交者 | 审核人批准后提交 | 仅在审核后运行 SHIP IT |
| 下午 | 在所有任务完成后编写冲刺摘要 | 最后运行一次 |
审查循环是质量门。如果评论者说 CHANGES NEEDED，agentloop将反馈发送回构建器并重试——最多6个周期。这不是重试和希望。审阅者给出了具体的修复说明，构建者对其进行了处理。
实时仪表板
当所有这些运行时，全屏终端仪表板会显示实时进度——哪些代理处于活动状态，它们在做什么，写入的字节数，经过的时间和波形进度。完成后，您将获得已发货和未发货的最终摘要。
GitHub集成
如果你设置了一个 .claude/task-issues.json 将任务ID映射到GitHub问题编号，agentloop实时更新问题标题和状态表情符号，并在运行完成时将冲刺摘要发布到史诗问题。如果文件不在那里，GitHub集成就会悄无声息地关闭——什么都不会中断。
______________________________________________________________________
快速启动
# Build the CLI
cd loop && bun install && bun build src/index.ts --compile --outfile=dist/agentloop
# From your project root (where prd.json lives)
agentloop # new run
agentloop --resume # resume a previous run
agentloop --branch feature # specify a feature branch您需要：
- 包子 用于建筑
- Claude CLI (
claude)在你的路上 - A.
prd.json在项目根目录中 - 中的代理定义
.claude/agents/
______________________________________________________________________
项目结构
loop/ # The CLI itself (TypeScript + Bun)
src/
index.ts # Entry point
commands/run.ts # Main execution engine
lib/prd.ts # PRD reader
lib/state.ts # Run state persistence
lib/github.ts # GitHub integration (fire-and-forget)
ui/dashboard.ts # Terminal dashboard
ui/theme.ts # Colors, icons, box-drawing
.claude/agents/ # Agent definitions (per project)
.agentloop/ # Runtime artifacts (created during runs)
state.json # Current run state
logs// # Per-task, per-agent logs______________________________________________________________________
为什么这种架构
首先通过设计进行测试。 测试编写器在任何实现存在之前运行。构建者编写代码是为了使测试通过，而不是相反。这意味着在编写单行生产代码之前，验收标准被编码为可执行检查。
特工们互相检查。 构建者无法标记自己的作业。一个单独的审阅者代理（使用只读工具）会审核作业并将其发送回去。这捕捉到了当一个模型同时编写和评估代码时发生的那种“在我看来很好”的漂移。
在安全的地方并行。 规划器使用Claude来推理任务依赖关系并构建拓扑排序。独立任务以并行波的形式运行。在一个任务中，后端和前端构建器可以同时运行。没有人为序列化。
失败是头等大事。 如果一个任务在6次尝试后仍无法通过审查，则将其标记为失败，而不是默默地忽略。仪表板准确显示发生了什么，日志捕获每个代理的完整输出以进行调试。