2.7 KiB
2.7 KiB
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 版本的差异，避免工具名耦合。
建议执行顺序
- 先改
SKILL.md的触发描述、依赖检查、quick 模式和 fallback 规则。 - 再拆出
references/模板与 Phase 契约。 - 最后用一个真实小需求跑通 Phase 0 到 Phase 4，回填发现的问题。