# Dev Flow Skill 改进 TODO

## P0：先修正执行稳定性

- [x] 重写 `description`，覆盖需求规划、feature 开发、openspec change、工程文档沉淀等触发场景。
- [x] 将依赖表中的“✅ 已安装”改为“启动时检查”，区分 required、optional、fallback。
- [x] 为子 skill 调用增加 fallback：优先调用 skill，不可调用时读取对应 `SKILL.md`，不存在时执行内置最小协议。
- [x] 明确 `--quick` 模式：允许跳 Phase 1.5 和 Phase 2.5；禁止跳 Phase 2 最小澄清和 Phase 4 轻量归档。
- [x] 增加 `devflow/` 初始化规则：创建 `projects/`、`glossary/`、`compound/`、`reference/`，并处理旧 `CONTEXT.md`。
- [x] 增加 v3 OpenSpec-first 规则：devflow 辅助 OpenSpec，OpenSpec 指挥执行。
- [x] 增加显式子 skill 调用规则：不能调用时必须标记 fallback 降级。
- [x] 增加 devflow 产物分档：micro / standard / complex，避免默认产物过多。

## P1：补齐 Phase 契约和模板

- [x] 为 Phase 0 增加进入条件、退出条件、最小输入质量标准。
- [x] 为 Phase 1 增加 openspec 产物检查：`proposal.md`、`design.md`、`specs/`、`tasks.md`。
- [x] 为 Phase 1.5 增加 PRD/brief 最小模板和完成标准。
- [x] 为 Phase 2 增加 `CONTEXT.md` 更新模板和 ADR 创建判断模板。
- [x] 为 Phase 2.5 增加架构审计输出模板。
- [x] 为 Phase 3 增加 diagnose 触发条件和 TDD 触发条件。
- [x] 为 Phase 4 增加 acceptance report 模板和 openspec 提取规则。

## P2：重构 skill 文件结构

- [x] 将新版本迁移为 `.agents/skills/sm-flow/SKILL.md` 短执行协议。
- [x] 新建 `.agents/skills/sm-flow/references/templates.md`，存放所有文档模板。
- [x] 新建 `.agents/skills/sm-flow/references/phase-contracts.md`，存放 Phase 输入/动作/输出/退出条件。
- [x] 新建 `.agents/skills/sm-flow/references/archive-rules.md`，存放 Phase 4 提取和归档规则。
- [x] 新建 `.agents/skills/sm-flow/references/fallbacks.md`，存放子 skill 不可用时的最小协议。
- [x] 删除或迁移 `SKILL.md` 中过长的理念说明，避免上下文膨胀。

## P3：完善展示和可移植性

- [ ] 评估是否需要 `agents/openai.yaml` 或其他技能展示元数据。
- [ ] 增加一个最小示例项目，验证从 Phase 0 到 Phase 4 的完整流转。
- [ ] 增加“复制到新项目后首次运行”的检查步骤。
- [ ] 明确 Claude 版本与 Codex 版本的差异，避免工具名耦合。

## 建议执行顺序

1. 先改 `SKILL.md` 的触发描述、依赖检查、quick 模式和 fallback 规则。
2. 再拆出 `references/` 模板与 Phase 契约。
3. 最后用一个真实小需求跑通 Phase 0 到 Phase 4，回填发现的问题。