| name | auto-developer |
| description | 自动化开发编排 - 顶层流程编排器，协调整个开发流程：PRD生成 → 架构设计 → 开发计划 → 任务执行 → 测试审计。支持全自动交付。 |
Auto Developer - 自动化开发编排
顶层流程编排器，协调从需求到交付的完整开发流程。
核心理念
固定的三板斧流程
┌─────────────────────────────────────────────────────────────┐
│ 自动化开发流程 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 第一板斧: PRD + 架构 │
│ ┌───────────────┐ ┌───────────────┐ │
│ │ prd-builder │ ─▶ │ architecture │ │
│ │ (行业研究) │ │ -designer │ │
│ │ (竞品分析) │ │ (架构+规约) │ │
│ └───────────────┘ └───────────────┘ │
│ │
│ 第二板斧: 开发计划 │
│ ┌───────────────┐ │
│ │ dev-plan- │ │
│ │ builder │ │
│ │ (前端+后端 │ │
│ │ +测试计划) │ │
│ └───────────────┘ │
│ │
│ 第三板斧: 执行 + 审计 │
│ ┌───────────────┐ ┌───────────────┐ │
│ │ task-executor │ ─▶ │ test-auditor │ │
│ │ (原子化任务) │ │ (测试审计) │ │
│ │ (断点续跑) │ │ (质量门禁) │ │
│ └───────────────┘ └───────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
执行模式
| 模式 | 描述 | 适用场景 |
|---|
| 手动模式 | 每个阶段需用户确认 | 复杂项目、首次开发 |
| 单阶段自动 | 当前阶段自动执行 | 熟悉项目、快速迭代 |
| 连续执行 | 全流程自动执行 | 标准化项目、紧急交付 |
唯一真相来源（SSOT）
- PRD文档是需求的唯一真相来源
- 所有下游文档严格对齐PRD
- 任何变更必须追溯到PRD
触发条件
用户输入包含以下内容时触发：
- "启动项目"、"执行项目"、"开发项目"
- "完整开发"、"自动交付"
- "从头开始"、"完整流程"
- 或任何需要完整开发流程的请求
技能协调
技能清单
| 技能 | 职责 | 输入 | 输出 |
|---|
| prd-builder | PRD文档生成 | 用户需求 | PRD文档 |
| architecture-designer | 架构设计+规约 | PRD文档 | 架构文档+技术规约 |
| dev-plan-builder | 开发计划生成 | 架构文档 | 开发计划+任务文档 |
| task-executor | 任务执行 | 开发计划 | 代码+执行报告 |
| test-auditor | 测试审计 | 代码 | 测试报告 |
协调流程
流程编排:
1. prd-builder:
input: 用户需求
output: docs/v{N}/01-prd.md
validation: PRD完整性检查
2. architecture-designer:
input: docs/v{N}/01-prd.md
output: docs/v{N}/02-architecture/
validation: 100%覆盖检查
3. dev-plan-builder:
input: docs/v{N}/02-architecture/
output: docs/v{N}/03-dev-plan/
validation: 任务大小检查
4. task-executor:
input: docs/v{N}/03-dev-plan/
output: docs/v{N}/04-execution/
validation: 测试通过检查
5. test-auditor:
input: 代码
output: docs/v{N}/05-test-report/
validation: 质量门禁检查
工作流程
阶段 1: 项目初始化
1.1 创建项目结构
docs/
└── v{N}/
├── 01-prd.md # PRD文档
├── 02-architecture/ # 架构设计
│ ├── 00-coverage-report.md
│ ├── 01-overview.md
│ ├── 02-layers.md
│ ├── 03-*.md (模块文档)
│ ├── 04-api-spec.md
│ ├── 05-data-spec.md
│ ├── 06-state-spec.md
│ └── 07-boundary-spec.md
├── 03-dev-plan/ # 开发计划
│ ├── 00-overview.md
│ └── *.md (计划文档)
├── 04-execution/ # 执行记录
│ ├── state.json
│ ├── logs/
│ └── evidence/
└── 05-test-report/ # 测试报告
└── report.md
1.2 确定版本号
检查 docs/ 目录下的 v* 文件夹:
- 当前最大版本: v3
- 新版本: v4
1.3 确定执行模式
询问用户选择执行模式:
请选择执行模式:
1. 手动模式 - 每个阶段需确认（推荐新项目）
2. 单阶段自动 - 当前阶段自动执行
3. 连续执行 - 全流程自动执行（推荐标准化项目）
阶段 2: 第一板斧 - PRD + 架构
2.1 调用 prd-builder
技能: prd-builder
输入:
- 用户需求描述
执行:
- 行业研究
- 竞品分析
- PRD文档生成
输出:
- docs/v{N}/01-prd.md
验证:
- 完整性检查
- 对标物追溯检查
执行示例:
=== 第一板斧: PRD生成 ===
调用技能: prd-builder
【阶段1】需求理解与对标物识别
- 识别对标物: 瑞幸咖啡小程序
- 增量需求: 会员积分功能
- 核心功能: 8个
【阶段2】行业研究与竞品分析
- 分析瑞幸咖啡功能模块
- 分析星巴克小程序
- 生成竞品对比矩阵
- 输出最佳实践建议
【阶段3】PRD文档生成
✅ docs/v1/01-prd.md
文档包含:
- 12个功能需求 (FR-001 ~ FR-012)
- 25个用户故事 (US-001 ~ US-025)
- 48个验收标准
- 8个数据实体
- 5个业务流程
✅ PRD生成完成
2.2 调用 architecture-designer
技能: architecture-designer
输入:
- docs/v{N}/01-prd.md
执行:
- 有效信息提取
- 覆盖映射表生成
- 架构设计生成
- 技术规约生成
输出:
- docs/v{N}/02-architecture/
验证:
- 100%覆盖检查
- 自包含检查
执行示例:
=== 第一板斧: 架构设计 ===
调用技能: architecture-designer
【阶段1】有效信息提取
- 功能需求: 12个
- 用户故事: 25个
- 数据实体: 8个
- 业务流程: 5个
- 验收标准: 48个
【阶段2】覆盖映射表生成
✅ 所有PRD需求已映射
【阶段3】架构设计生成
✅ 01-overview.md
✅ 02-layers.md
✅ 03-mod-01-用户模块.md
✅ 03-mod-02-订单模块.md
... (5个模块)
【阶段4】技术规约生成
✅ 04-api-spec.md (32个接口)
✅ 05-data-spec.md (8个实体)
✅ 06-state-spec.md (5个状态机)
✅ 07-boundary-spec.md (48个边界条件)
【阶段5】覆盖验证
✅ 00-coverage-report.md
✅ 覆盖率: 100%
✅ 架构设计完成
阶段 3: 第二板斧 - 开发计划
3.1 调用 dev-plan-builder
技能: dev-plan-builder
输入:
- docs/v{N}/02-architecture/
执行:
- 架构解析
- 模块开发计划生成
- 任务拆分
输出:
- docs/v{N}/03-dev-plan/
验证:
- 任务大小检查
- 覆盖完整性检查
执行示例:
=== 第二板斧: 开发计划 ===
调用技能: dev-plan-builder
【阶段1】架构解析
- 模块数: 5个
- 接口数: 32个
- 数据实体: 8个
【阶段2】开发计划生成
✅ 00-overview.md
模块开发计划:
✅ 01-backend-mod-01.md (8个任务)
✅ 02-frontend-mod-01.md (8个任务)
✅ 03-backend-mod-02.md (12个任务)
✅ 04-frontend-mod-02.md (8个任务)
✅ 05-integration-mod-02.md (8个任务)
... (共15个计划文档)
【阶段3】任务拆分验证
✅ 所有任务符合大小限制
✅ 覆盖率: 100%
统计:
- 总任务数: 120个
- 预估工时: 45天
✅ 开发计划完成
阶段 4: 第三板斧 - 执行 + 审计
4.1 调用 task-executor
技能: task-executor
输入:
- docs/v{N}/03-dev-plan/
执行:
- 任务执行循环
- 测试运行
- 契约门控
- 状态追踪
输出:
- 代码
- docs/v{N}/04-execution/
验证:
- 测试通过检查
- 契约一致检查
执行示例:
=== 第三板斧: 任务执行 ===
调用技能: task-executor
【阶段1】初始化
- 创建状态文件: docs/v1/04-execution/state.json
- 执行模式: 连续执行
- 总任务数: 120个
【阶段2】任务执行循环
[进度: 10%] 执行 01-backend-mod-01
T-01: 数据模型定义 ✅
T-02: 数据访问层 ✅
T-03: 业务逻辑层-创建 ✅
...
[进度: 25%] 执行 02-frontend-mod-01
T-01: API层 ✅
T-02: 状态管理 ✅
...
[进度: 50%] 执行 03-backend-mod-02
...
[进度: 75%] 执行 04-frontend-mod-02
...
[进度: 100%] 所有任务完成
✅ 任务执行完成
执行统计:
- 成功: 118个
- 失败: 2个（已修复）
- 总耗时: 12小时
4.2 调用 test-auditor
技能: test-auditor
输入:
- 代码
执行:
- 单元测试
- 集成测试
- E2E测试
- 覆盖率分析
输出:
- docs/v{N}/05-test-report/
验证:
- 质量门禁检查
执行示例:
=== 第三板斧: 测试审计 ===
调用技能: test-auditor
【阶段1】测试计划
- 分析测试范围: 5个模块
- 确定测试策略
【阶段2】测试执行
=== 单元测试 ===
结果: 450 passed, 0 failed
覆盖率: 87.5%
✅ 通过
=== 集成测试 ===
结果: 120 passed, 0 failed
覆盖率: 82.3%
✅ 通过
=== E2E测试 ===
结果: 35 passed, 0 failed
✅ 通过
【阶段3】测试报告
✅ docs/v1/05-test-report/report.md
质量门禁:
✅ 单元测试覆盖率 ≥ 80%: 87.5%
✅ 集成测试通过率 100%: 100%
✅ E2E测试通过率 100%: 100%
✅ 严重缺陷数 0: 0
✅ 质量门禁通过
✅ 测试审计完成
阶段 5: 交付报告
5.1 生成交付报告
输出: docs/v{N}/06-delivery/DELIVERY_REPORT.md
# 项目交付报告
## 项目概况
- **项目名称**: [项目名称]
- **版本**: v{N}
- **交付日期**: [日期]
- **总体状态**: ✅ 成功交付
## 执行摘要
### 时间统计
| 阶段 | 开始时间 | 结束时间 | 耗时 |
|-----|---------|---------|------|
| PRD生成 | [时间] | [时间] | [X]小时 |
| 架构设计 | [时间] | [时间] | [X]小时 |
| 开发计划 | [时间] | [时间] | [X]小时 |
| 任务执行 | [时间] | [时间] | [X]小时 |
| 测试审计 | [时间] | [时间] | [X]小时 |
| **总计** | - | - | **[X]小时** |
### 交付物清单
| 类型 | 数量 | 位置 |
|-----|------|------|
| PRD文档 | 1 | docs/v{N}/01-prd.md |
| 架构文档 | 12 | docs/v{N}/02-architecture/ |
| 开发计划 | 15 | docs/v{N}/03-dev-plan/ |
| 代码文件 | [N] | src/ |
| 测试文件 | [M] | tests/ |
| 测试报告 | 1 | docs/v{N}/05-test-report/ |
## 功能完成情况
| PRD编号 | 功能名称 | 状态 | 验证结果 |
|---------|---------|------|---------|
| FR-001 | 用户注册登录 | ✅ | 通过 |
| FR-002 | 订单管理 | ✅ | 通过 |
| FR-003 | 支付功能 | ✅ | 通过 |
... | ... | ... | ...
**完成率**: 100% (12/12)
## 质量指标
| 指标 | 目标值 | 实际值 | 状态 |
|-----|-------|-------|------|
| 代码覆盖率 | ≥ 80% | 87.5% | ✅ |
| 测试通过率 | 100% | 100% | ✅ |
| 严重缺陷数 | 0 | 0 | ✅ |
| 代码规范符合率 | ≥ 95% | 98% | ✅ |
## 技术债务
| 类型 | 描述 | 优先级 | 计划处理时间 |
|-----|------|-------|------------|
| 无 | - | - | - |
## 遗留问题
| 问题 | 严重程度 | 处理建议 |
|-----|---------|---------|
| 无 | - | - |
## 下一步建议
1. 部署到测试环境验证
2. 进行用户验收测试
3. 准备生产环境发布
## 附录
### 文档索引
- PRD: docs/v{N}/01-prd.md
- 架构: docs/v{N}/02-architecture/00-coverage-report.md
- 开发计划: docs/v{N}/03-dev-plan/00-overview.md
- 执行记录: docs/v{N}/04-execution/report.md
- 测试报告: docs/v{N}/05-test-report/report.md
命令参考
启动项目
auto-developer --mode=manual
auto-developer --mode=stage
auto-developer --mode=continuous
从特定阶段开始
auto-developer --start=architecture
auto-developer --start=dev-plan
auto-developer --start=execution
恢复执行
auto-developer --resume
auto-developer --status
使用示例
示例1：全自动交付
用户: "帮我开发一个类似瑞幸咖啡的点单小程序，增加会员积分功能，全自动执行"
AI: 正在启动自动化开发流程...
【项目初始化】
- 项目名称: 点单小程序
- 版本: v1
- 执行模式: 连续执行
═══════════════════════════════════════
第一板斧: PRD + 架构
═══════════════════════════════════════
[prd-builder] 生成PRD文档...
✅ docs/v1/01-prd.md (12个功能需求, 25个用户故事)
[architecture-designer] 生成架构设计...
✅ docs/v1/02-architecture/ (5个模块, 32个接口)
═══════════════════════════════════════
第二板斧: 开发计划
═══════════════════════════════════════
[dev-plan-builder] 生成开发计划...
✅ docs/v1/03-dev-plan/ (120个任务, 45天)
═══════════════════════════════════════
第三板斧: 执行 + 审计
═══════════════════════════════════════
[task-executor] 执行开发任务...
[████████████████████████████████] 100%
✅ 118个任务成功
[test-auditor] 执行测试审计...
✅ 覆盖率: 87.5%, 全部通过
═══════════════════════════════════════
交付完成
═══════════════════════════════════════
✅ docs/v1/06-delivery/DELIVERY_REPORT.md
项目已成功交付！
- 代码位置: src/
- 文档位置: docs/v1/
- 质量门禁: ✅ 通过
示例2：断点续跑
用户: "继续执行"
AI: 检测到未完成的项目...
【状态恢复】
- 项目: 点单小程序
- 当前进度: 50%
- 阶段: 任务执行
- 当前任务: T-60
从 T-60 继续执行...
[task-executor] 继续执行任务...
[████████████░░░░░░░░░░░░░░░░░░] 50% → 100%
...
检查清单
项目启动前
第一板斧完成后
第二板斧完成后
第三板斧完成后
注意事项
- SSOT原则: 所有决策必须追溯到PRD
- 原子化执行: 任务大小严格限制
- 测试先行: 每个任务必须测试通过
- 断点续跑: 支持中断恢复
- 质量门禁: 必须通过才能交付
三板斧 · 全自动 · 高质量 🚀
