myclaude/dev-workflow/README.md

/dev - 极简开发工作流

概述

全新设计的轻量级开发工作流，无历史包袱，专注快速交付高质量代码。

工作流程

/dev 触发
  ↓
AskUserQuestion（需求澄清）
  ↓
Codex 分析（提取要点和任务）
  ↓
develop-doc-generator（生成开发文档）
  ↓
Codex 并发开发（2-5个任务）
  ↓
Codex 测试验证（≥90%覆盖率）
  ↓
完成（生成总结）

6个步骤

1. 需求澄清

• 使用 AskUserQuestion 直接问用户
• 无评分系统，无复杂逻辑
• 2-3 轮问答直到需求明确

2. Codex 分析

• 调用 codex 分析需求
• 提取：核心功能、技术要点、任务列表（2-5个）
• 输出结构化分析结果

3. 生成开发文档

• 调用 develop-doc-generator agent
• 生成 dev-plan.md（单一开发文档）
• 包含：任务分解、文件范围、依赖关系、测试命令

4. 并发开发

• 基于 dev-plan.md 的任务列表
• 无依赖任务 → 并发执行
• 有冲突任务 → 串行执行

5. 测试验证

• 每个 codex 任务自己：
  • 实现功能
  • 编写测试
  • 运行覆盖率
  • 报告结果（≥90%）

6. 完成

• 汇总任务状态
• 记录覆盖率

使用方法

/dev "实现用户登录功能，支持邮箱和密码验证"

无选项，流程固定，开箱即用。

输出结构

.claude/specs/{feature_name}/
├── dev-plan.md      # 开发文档（agent生成）

仅 2 个文件，极简清晰。

核心组件

工具

• AskUserQuestion：交互式需求澄清
• codex：分析、开发、测试
• develop-doc-generator：生成开发文档（subagent，节省上下文）

核心特性

✅ 全新设计

• 无历史项目残留
• 无复杂评分逻辑
• 无多余抽象层

✅ 极简编排

• orchestrator 直接控制流程
• 只用 3 个工具/组件
• 步骤清晰易懂

✅ 并发能力

• 2-5 个任务并行
• 自动检测依赖和冲突
• codex 独立执行

✅ 质量保证

• 强制 90% 覆盖率
• codex 自己测试和验证
• 失败自动重试

示例

# 触发
/dev "添加用户登录功能"

# 步骤 1: 需求澄清
Q: 支持哪些登录方式？
A: 邮箱 + 密码
Q: 需要记住登录状态吗？
A: 是，使用 JWT token

# 步骤 2: Codex 分析
输出：
- 核心功能：邮箱密码登录 + JWT认证
- 任务 1：后端 API
- 任务 2：密码加密
- 任务 3：前端表单

# 步骤 3: 生成文档
dev-plan.md 已生成 ✓

# 步骤 4-5: 并发开发
[task-1] 后端API → 测试 → 92% ✓
[task-2] 密码加密 → 测试 → 95% ✓
[task-3] 前端表单 → 测试 → 91% ✓

目录结构

dev-workflow/
├── README.md                          # 本文档
├── commands/
│   └── dev.md                         # 工作流定义
└── agents/
    └── develop-doc-generator.md       # 文档生成器

极简结构，只有 3 个文件。

适用场景

✅ 适合：

• 任何规模的功能开发
• 需要快速迭代
• 需要高测试覆盖率
• 希望并发提速

设计原则

1. KISS：保持简单愚蠢
2. 即用即抛：无持久化配置
3. 质量优先：强制 90% 覆盖率
4. 并发优先：充分利用 codex 能力
5. 无历史包袱：全新设计，不受其他项目影响

---

哲学：像 Linus 一样对复杂度零容忍，交付能立刻用的最小方案。