| name | devflow |
| description | 开发工作流 skill。一条命令从需求到交付：需求探索 → 规范生成 → 计划拆分 → TDD 执行 → 验证 → 归档。编排 OpenSpec 和 Superpowers 两个框架，不重新实现任何逻辑。 |
| license | MIT |
| compatibility | 需预装 openspec CLI + Superpowers skills |
| metadata | {"author":"Johnson","version":"3.0"} |
DevFlow — 开发工作流 skill。编排 OpenSpec + Superpowers，需求到交付一条命令搞定。编排规则见 .claude/rules/devflow.md。
这是一个编排型 skill——自己不实现任何逻辑，只把 OpenSpec（规范）和 Superpowers（执行）串成 6 阶段流水线。学它的价值不在流程本身，而在 4 个设计手法：①编排不实现 ②恢复判定（断点续传）③覆盖规则（rules 改写底层 skill 默认行为）④渐进式披露（每次只读当前阶段）。
阶段切换
每个阶段完成后，恢复判定会自动检测文件状态，从正确阶段继续。使用 /devflow 继续 <change-name> 即可。
前置条件检查
触发后第一件事检查项目初始化状态：
ls openspec/
项目未初始化时，询问用户：
当前项目未初始化 OpenSpec。
是否自动执行 openspec init --tools claude 初始化？(是/手动)
用户选"是" → 执行 openspec init --tools claude && openspec update，成功后进入 Stage 1。
恢复判定
中断后按优先级判断恢复点，然后读取对应 Stage 文件执行：
-
发现变更名：ls openspec/changes/ — 扫描活跃变更目录。若用户未提供 <name>，据此确定当前变更名。多个活跃变更时询问用户选择。
-
Plan 文件所有 Task 已标记 [x] 且无归档 → Stage 5
-
Plan 文件有部分 Task 已标记 [x] → Stage 4（从中断处继续，异常处理见 guide）
- 如有残留 worktree（
git worktree list 检查）：从 worktree 中未完成 Task 继续
-
docs/superpowers/plans/ 有计划文件但无 Task 标记 [x] → Stage 3，重新生成计划（覆盖）
-
openspec/changes/<name>/ 有工件但无计划 → Stage 3
-
openspec/changes/<name>/ 有部分工件（openspec status --json 检查）
- 用户有补充信息 → 编辑已有工件后重新执行 Stage 2
- 无新信息 → 重新执行 Stage 2，openspec 从 CLI 状态续接
-
docs/superpowers/specs/ 有设计文档但无 OpenSpec 工件 → Stage 2
-
以上都没有 → Stage 1
阶段路由
根据恢复判定或当前进度，仅读取对应 Stage 文件：
| 阶段 | 文件 | 调用技能 | 代码图谱工具 |
|---|
| Stage 1 | stages/stage-1.md | superpowers:brainstorming | — |
| Stage 2 | stages/stage-2.md | openspec-propose | — |
| Stage 3 | stages/stage-3.md | superpowers:writing-plans | impact, locate |
| Stage 4 | stages/stage-4.md | superpowers:subagent-driven-development | 按需 locate/search |
| Stage 5 | stages/stage-5.md | superpowers:verification-before-completion | detect_changes |
| Stage 6 | stages/stage-6.md | openspec-archive-change | — |
所有 Stage 文件位于 stages/ 下。每次只读取当前执行的 Stage 文件（渐进式披露）。代码图谱（如 codebase-memory-mcp / code-lens）仅在 Stage 3（影响评估）和 Stage 5（变更验证）强制接入，Stage 4 按需调用，新项目可跳过。
参考
快速/迷你模式、异常处理、使用示例见 .claude/skills/devflow/devflow-guide.md。按需读取，不预加载。
