dev - 端到端开发工作流
总览
dev 是一个轻量级端到端开发工作流，包含 7 个阶段：需求澄清、技术分析、开发文档生成、并行执行、覆盖率验证、部署、监控。通过 /dev 命令启动，自动进行后端路由选择和并行任务执行。
工作流阶段
| 阶段 | 说明 | 关键操作 |
|---|---|---|
| Step 0 | 后端选择 | 确定允许使用的 AI 后端 |
| Step 1 | 需求澄清 | 通过提问明确功能边界、输入输出、约束 |
| Step 2 | 技术分析 | 使用 pinable 进行深度代码库分析 |
| Step 3 | 开发文档 | 生成 dev-plan.md 开发计划 |
| Step 4 | 并行执行 | 通过 pinable --parallel 并行开发 |
| Step 5 | 覆盖率验证 | 验证测试覆盖率 ≥90% |
| Step 6 | 完成总结 | 输出完成情况、覆盖率、关键变更 |
Step 0 - 后端选择（必选）
启动时必须先询问用户选择允许的后端：
| 后端 | 特点 | 默认场景 |
|---|---|---|
codex | 稳定、高质量、性价比高 | 大多数任务 |
claude | 快速、轻量 | 快速修复、配置变更 |
gemini | UI/UX 专长 | 前端样式和组件 |
特殊规则：若用户只选择 codex，则所有任务（包括 UI/快速修复）都必须使用 codex。
Step 1 - 需求澄清（必选）
通过提问明确：
- 功能边界
- 输入/输出
- 约束条件
- 测试要求
- 覆盖率要求
澄清完成后创建任务跟踪列表。
Step 2 - 技术分析
使用 pinable 进行深度分析：
bash
pinable --backend {analysis_backend} - <<'EOF'
Analyze the codebase for implementing [feature name].
Requirements:
- [requirement 1]
- [requirement 2]
Deliverables:
1. Explore codebase structure and existing patterns
2. Evaluate implementation options with trade-offs
3. Make architectural decisions
4. Break down into 2-5 parallelizable tasks
5. Classify each task with type: default / ui / quick-fix
6. Determine if UI work is needed
EOF分析输出结构：
- Context & Constraints
- Codebase Exploration
- Implementation Options
- Technical Decisions
- Task Breakdown
- UI Determination
Step 3 - 开发文档
生成 dev-plan.md，包含：
- 任务数量和 ID
- 每个任务的类型
- 每个任务的文件范围
- 任务间的依赖关系
- 测试命令
向用户确认后执行。
Step 4 - 并行执行
关键约束：
- 所有代码变更必须通过
pinable --parallel执行 - 禁止直接使用 Edit/Write 工具修改代码
后端路由规则：
| 任务类型 | 优先后端 | 备选后端 |
|---|---|---|
default | codex | claude → gemini |
ui | gemini | codex → claude |
quick-fix | claude | codex → gemini |
Step 5 - 覆盖率验证
- 所有任务 ≥90% → 通过
- 任何任务 <90% → 请求补充测试（最多 2 轮）
Step 6 - 完成总结
输出：
- 完成的任务列表
- 每个任务的覆盖率
- 关键文件变更
集成其他技能
dev 工作流与其他技能配合：
| 技能 | 集成方式 |
|---|---|
/do | 执行具体开发任务 |
/code-review | 代码审查 |
/test-cases | 生成测试用例 |
pinable | 并行任务执行 |
错误处理
| 错误类型 | 处理方式 |
|---|---|
| pinable 失败 | 重试一次，仍失败则询问用户 |
| 覆盖率不足 | 请求补充测试（最多2轮） |
| 循环依赖 | 检测并报告，重新分解任务 |
| 后端不可用 | 回退到 allowed_backends 中的其他后端 |
质量标准
- 代码覆盖率 ≥90%
- 任务基于自然功能边界（通常 2-5 个任务）
- 每个任务有明确的
type: default|ui|quick-fix - 后端按类型路由，带 allowed_backends 回退机制