doc-driven-spec-workflow

文档驱动的规范工作流

目的

只选择一个下一阶段技能。不要在此处执行阶段工作。

适用场景

• 仓库遵循此文档驱动工作流
• 用户想要继续工作，但当前阶段不明确
• 新对话需要根据文档和提示恢复工作流状态

首先阅读

1. docs/tasks/index.md
2. docs/tasks/planning-inbox.md
3. docs/tasks/backlog.md
4. docs/tasks/ 下相关的里程碑、模块和任务文档
5. docs/architecture/
6. docs/context/
7. 当前用户提示

缺少文档是路由信号，而不是目标不明确的证明。

负责事项

• 识别当前工作流阶段
• 选择下一阶段技能
• 证据不足时，提出尽可能简短的路由问题
• 移交 Decided、Undecided、Next skill 和 Stop point

不负责事项

• 脚手架创建细节
• 路线图拆分细节
• 编写任务级 spec.md 或 plan.md
• 执行隔离、实施、验证或分支收尾
• 属于所选阶段技能的局部决策

路由表

情况	下一技能
缺少最低限度的文档脚手架	docs-workflow-bootstrap
文档或提示显示目标、约束、成功标准或当前与后续阶段的边界尚未明确	planning-clarification
里程碑形态、模块分组、任务拆分或交付顺序不明确	milestone-planning
已选定具体任务，或能根据已确认的路线图状态明确选出任务	task-preparation

入口检查

• 缺少任何最低限度的脚手架文件时，路由至 docs-workflow-bootstrap：
  • docs/index.md
  • docs/architecture/index.md
  • docs/tasks/index.md
  • docs/tasks/planning-inbox.md
  • docs/tasks/backlog.md
  • docs/context/index.md
• 只有存在明确的歧义证据时，才路由至 planning-clarification。仅仅文档缺失或过时并不足以作为依据。
• 只有满足以下所有条件时，才路由至 task-preparation：
  • 里程碑的 Roadmap confirmed: yes
  • 跨越里程碑时，前一里程碑的收尾问题已解决
  • 任务状态为 planned 或 in_progress
  • 依赖项已满足或已明确豁免
  • 没有未解决的硬性关卡阻碍进度
  • 用户已选定该任务，或文档明确指出该任务是下一项

默认流程

1. 按证据顺序阅读文档，并识别最有力的路由信号。
2. 只选择一个下一阶段技能。
3. 证据不足时，提出一个最简短的路由问题，而不是猜测。
4. 只移交阶段上下文，不移交阶段特定决策。

停止点

• 移交给一个阶段技能
• 或提出一个最简短的路由问题

如果遇到阻碍

• 证据未能确定下一阶段时，提出一个路由问题
• 不要代替用户回答路由问题
• 不要通过起草规范或编造路线图结构来绕过不确定性

移交内容

• Current stage
• Why
• Decided
• Undecided
• Next skill
• Stop point