git-learn/devflow/projects/2026-05-19-dev-flow-skill-evaluation/todo.md

Dev Flow Skill 改进 TODO

P0：先修正执行稳定性

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

P1：补齐 Phase 契约和模板

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

P2：重构 skill 文件结构

• 将新版本迁移为 .agents/skills/sm-flow/SKILL.md 短执行协议。
• 新建 .agents/skills/sm-flow/references/templates.md，存放所有文档模板。
• 新建 .agents/skills/sm-flow/references/phase-contracts.md，存放 Phase 输入/动作/输出/退出条件。
• 新建 .agents/skills/sm-flow/references/archive-rules.md，存放 Phase 4 提取和归档规则。
• 新建 .agents/skills/sm-flow/references/fallbacks.md，存放子 skill 不可用时的最小协议。
• 删除或迁移 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，回填发现的问题。