用途
workflow-optimizer 用于引导用户完成 8 层 SDD 工作流(BRD → PRD → EARS → BDD → ADR → SPEC → TDD → IPLAN → Code)。它根据已完成产物定位当前所处的位置,推荐带有理由的优先下一步,呈现可以并行推进的工作,并报告进度,从而省去手动决定下一步构建什么的摩擦。
何时使用
在以下情况使用 workflow-optimizer:
- 你刚完成一个产物,需要下一步指导。
- 你正在开始编写文档,想要一个工作流概览。
- 你想寻找并行工作机会或获取进度报告。
不要用它来为特定任务挑选技能(应使用 ../skill-recommender/SKILL.md),不要用它来收集项目上下文(应使用 ../context-analyzer/SKILL.md),也不要用它来验证产物(应使用 ../trace-check/SKILL.md 或 ../quality-advisor/SKILL.md)。
行为
给定一个 project_root(以及可选的刚完成的产物和一个焦点过滤器),该技能会:
-
分析项目状态——发现产物并从 Document Control 中提取状态(Draft、In Review、Approved、Superseded、Deprecated),按类型生成计数。
-
确定工作流位置——将产物映射到第 1–8 层(根据累积链条,每层都有单层前置条件),将各层标记为已完成、进行中、就绪或阻塞,并计算进度百分比。
-
识别必需的下一步——使用依赖链列出强制性的下一个产物,按 P0/P1/P2 优先级排列,并附上理由以及每个产物能解锁什么。
-
寻找并行机会——独立的 BRD/PRD 轨道、可以同时起草的 ADR,以及一旦 EARS 需求存在就可以开始的 BDD 场景;注明因缺少上游层而被阻塞的项。
-
计算进度指标——各层状态以及关键路径(EARS → BDD → ADR → SPEC → TDD → IPLAN)。
-
生成建议——具体的下一步行动,指明要运行的层技能(例如 ../doc-ears/SKILL.md)、并行建议、带解除阻塞路径的阻塞项,以及进度摘要。
相关资源
- 层注册表(层与前置条件):framework/registry/LAYER_REGISTRY.yaml
- 可追溯性:framework/governance/TRACEABILITY.md
- 层技能:../doc-brd/SKILL.md … ../doc-iplan/SKILL.md
- 相关技能:../context-analyzer/SKILL.md · ../skill-recommender/SKILL.md · ../doc-flow/SKILL.md