cenmiao/openspec-sp-subagent-dev

Subagent-Driven Development Skill

核心流程： Fresh subagent per task + two-stage review (spec then quality) = high quality, fast iteration

---

工作流程

初始化阶段

1. 读取 plan/tasks，提取所有任务详情
2. 创建 TodoWrite 跟踪进度
3. 确认每个任务的完整描述

每任务循环

对于每个任务，执行以下步骤：

┌─────────────────────────────────────────────────────────┐
│  Task Implementation Loop                               │
├─────────────────────────────────────────────────────────┤
│                                                         │
│   ┌─────────────┐                                      │
│   │ Implement   │ ──▶ 子代理实现、测试、提交、自审      │
│   └─────────────┘                                      │
│         │                                              │
│         ▼                                              │
│   ┌─────────────┐                                      │
│   │ Review 1    │ ──▶ 规格合规审查                     │
│   │ (Spec)      │     ✅ 通过 → 继续                   │
│   │             │     ❌ 失败 → 修复规格缺口           │
│   └─────────────┘                                      │
│         │                                              │
│         ▼                                              │
│   ┌─────────────┐                                      │
│   │ Review 2    │ ──▶ 代码质量审查                     │
│   │ (Quality)   │     ✅ 通过 → 继续                   │
│   │             │     ❌ 失败 → 修复质量问题           │
│   └─────────────┘                                      │
│         │                                              │
│         ▼                                              │
│   ┌─────────────┐                                      │
│   │ Complete    │ ──▶ 标记任务完成                     │
│   └─────────────┘                                      │
│                                                         │
└─────────────────────────────────────────────────────────┘

审查阶段 1：规格合规

目的： 确认实现符合 tasks.md 规格

审查问题：

• 实现是否完成了任务描述的所有要求？
• 是否有遗漏的功能点？
• 是否有超出范围的实现？
• 是否符合 specs 中定义的需求？

通过标准：

• 所有任务要求都已实现
• 没有规格缺口
• 没有过度实现

失败处理：

• 列出规格缺口
• 实现子代理修复
• 重新审查直到通过

审查阶段 2：代码质量

目的： 确认代码质量达到标准

审查维度：

• Code Quality: 错误处理、类型安全、防御式编程
• Architecture: SOLID 原则、设计模式、松耦合
• Documentation: 注释、文档、命名
• Testing: 测试覆盖、测试质量
• Security: 潜在安全漏洞
• Performance: 性能问题

通过标准：

• 无 Critical 问题
• Important 问题已修复或有计划

失败处理：

• 列出质量问题
• 实现子代理修复
• 重新审查直到通过

完成任务

• 在 TodoWrite 标记任务完成
• 提交更改

最终审查

所有任务完成后：

• 调度最终审查子代理进行完整审查
• 使用 openspec-sp-code-review 技能

---

模型选择策略

| 任务类型 | 推荐模型 | |----------|----------| | 简单任务（单文件修改） | 廉价模型 | | 集成工作（多文件） | 标准模型 | | 设计/审查 | 最强能力模型 |

---

关键规则

⚠️ 禁止的行为

• 禁止跳过任一审查阶段
• 禁止在规格审查通过前开始质量审查（顺序错误）
• 禁止接受"差不多"的规格合规
• 禁止强制同一模型重试而不修改

✅ 必须的行为

• 必须按顺序执行审查：规格 → 质量
• 必须独立验证每个审查结果
• 必须修复所有 Critical 问题

---

使用示例

用户：实现任务 3.2 - 添加用户认证

助手：我使用 openspec-sp-subagent-dev 技能来实现。

**初始化**
- 读取任务 3.2 详情
- 创建 TodoWrite

**实现阶段**
[子代理实现代码]

**审查阶段 1：规格合规**
- 检查实现是否符合任务描述
- ✅ 所有要求已实现

**审查阶段 2：代码质量**
- 检查代码质量
- ⚠️ 发现 1 个 Important 问题：缺少错误处理
- 修复后重新审查
- ✅ 通过

**任务完成**
- 标记任务完成

---

与其他技能集成

• openspec-sp-tdd: 每任务内部使用 TDD 循环
• openspec-sp-code-review: 最终完整审查
• openspec-apply-change: 集成到此技能的每任务流程