ai-dev-loop

AI 开发循环

跨多个 AI 平台自主执行任务，并设置 QA 检查关卡。

概述

AI 开发循环支持完全自主的功能开发，其中：

• AI Agent 从队列中领取并实现任务
• 你只需执行 QA（在 Testing 列中批准或拒绝）
• 多个平台（Claude CLI、Cursor、Codex）可以并行工作
• 通过切换平台，最大限度地利用速率限制额度

架构

┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   BACKLOG   │────▶│   TO DO     │────▶│  TESTING    │────▶│    DONE     │
│             │     │             │     │             │     │             │
│  PRDs ready │     │ Agent picks │     │ YOU review  │     │  Shipped    │
│             │     │ & builds    │     │ & approve   │     │             │
└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘
                          │                   │
                    ┌─────┴─────┐       ┌─────┴─────┐
                    │  Claude   │       │  Reject   │
                    │  Cursor   │       │  → To Do  │
                    │  Codex    │       └───────────┘
                    └───────────┘

任务生命周期

1. 创建任务

任务存放在 .agents/TASKS/[task-name].md 中，并包含结构化元数据：

## Task: [Feature Name]

**ID:** feature-name-slug
**Status:** Backlog | To Do | Testing | Done
**Priority:** High | Medium | Low
**PRD:** [Link](../PRDS/prd-file.md)

### Agent Metadata

**Claimed-By:** [platform-session-id]
**Claimed-At:** [timestamp]
**Completed-At:** [timestamp]

### Progress

**Agent-Notes:** [real-time updates]
**QA-Checklist:**

- [ ] Code compiles/lints
- [ ] Tests pass (CI)
- [ ] User acceptance
- [ ] Visual review

### Rejection History

**Rejection-Count:** 0
**Rejections:** [list of rejection notes]

2. 领取任务

当 Agent 运行 /loop 时：

1. 扫描 .agents/TASKS/，查找 Status: To Do 的任务
2. 按优先级排序（High > Medium > Low）
3. 跳过有未过期认领记录的任务（认领时间不足 30 分钟）
4. 更新任务，填写 Claimed-By 和 Claimed-At

3. 实现

Agent 开始处理任务：

1. 阅读任务文件和关联的 PRD
2. 检查 .agents/SESSIONS/ 中是否有相关的历史工作
3. 实现功能或修复
4. 更新 Agent-Notes，记录进度
5. 创建分支并提交

4. 质量检查

移至 Testing 前：

1. 运行 qa-reviewer 技能
2. 更新 QA-Checklist 项目
3. 确保代码可以编译并通过 lint 检查

5. 完成

Agent 完成收尾工作：

1. 设置 Status: Testing
2. 设置 Completed-At 时间戳
3. 在 Agent-Notes 中添加最终摘要
4. 提示下一步操作

6. QA 检查关卡（轮到你了）

在 Kaiban.md 中：

1. 查看 Testing 列
2. 点击任务，查看 PRD 预览
3. 检查关联的 PR
4. 批准：将任务拖到 Done
5. 拒绝：点击拒绝，添加备注 → 任务返回 To Do

7. 处理拒绝

任务被拒绝时：

1. 状态返回 To Do
2. Rejection-Count 递增
3. 拒绝备注会添加到历史记录
4. 下一次 /loop 会携带完整上下文领取任务

多平台策略

平台优势

平台	最适合的工作
Claude CLI	复杂逻辑、后端、架构
Cursor	UI 组件、样式、视觉设计
Codex	批量重构、迁移、文档

并行执行

多个平台可以同时工作：

• 每个平台领取不同的任务
• 认领机制可避免冲突（30 分钟锁定）
• 通过任务文件共享状态

速率限制处理

遇到速率限制时：

1. Agent 将进度保存到 Agent-Notes
2. 释放认领（清除 Claimed-By）
3. 建议切换平台
4. 用户改用其他平台继续

每日工作流

早间 QA 环节

1. 在 VS Code 中打开 Kaiban.md 扩展
2. 查看 Testing 列
3. 批准合适的工作 → Done
4. 添加备注并拒绝 → To Do

全天工作

# Claude CLI
claude
> /loop   # Process task
> /loop   # Next task
# Rate limited? Switch to Cursor

速率限制策略

Claude limit? → Switch to Cursor
Cursor limit? → Switch to Codex
All limited? → QA time (review Testing)

集成点

Kaiban.md 扩展

• 为 .agents/TASKS/ 提供可视化看板
• 拖放即可更改状态
• PRD 预览面板
• 带备注输入框的拒绝按钮
• Agent 认领状态徽章

现有技能

• qa-reviewer：6 阶段质量验证
• session-documenter：自动记录已完成的工作
• rules-capture：从拒绝反馈中学习

Git 工作流

• 每个任务对应一个分支：feature/[task-id]
• 提交信息清晰明了
• 在任务文件中关联 PR

不是守护进程

重要提示：/loop 不是后台进程。

• 每次调用只处理一个任务
• 随后将控制权交还给用户
• 用户决定继续还是停止
• 遵守“绝不运行后台进程”的规则

认领过期

认领会在 30 分钟后过期：

• 应对 Agent 崩溃
• 应对速率限制导致的中断
• 之前的 Agent-Notes 可为后续处理提供上下文
• 支持在多个平台之间交接

最佳实践

创建任务时

• 编写清晰、可执行的任务描述
• 链接 PRD，说明需求
• 设置合适的优先级
• 包含测试标准

Agent 注意事项

• 开始前仔细阅读任务和 PRD
• 定期更新 Agent-Notes
• 完成前运行 qa-reviewer
• 创建简洁、专注的提交

面向 QA（你）

• 对照实现审查 PRD
• 提供具体的拒绝反馈
• 逐步批准（不要批量批准）
• Testing 列保持简短