用途:激活 Idea-to-Spec 工作流,将原始想法转成一份规范的临时功能规格文档,位于 docs/specs/{Bucket}/README.{Feature}.md。流程在评审并同步后的功能规格处停止,不产出 PBI 待办;需待办可后续链接 workflow-spec-to-pbi,一次性完成可使用 workflow-idea-to-pbi,代码反推规格使用 workflow-code-to-spec。
主要能力与步骤:必选步骤依次为 $web-research、$deep-research、$brainstorm、$spec-discovery、$domain-analysis、$why-review、$idea、$spec [mode=draft]、$spec [mode=tests]、$artifact-review --type=spec-tests、$artifact-review、$design-spec、$spec-clarify、$why-review、$docs-update、$feature-presentation、$workflow-end、$watzup。其中 $brainstorm 负责收敛出要规格化的单一能力;$spec-discovery 检查已有规格与代码,阻塞式决定新建、扩展或拆分;$why-review 作为门禁校验问题本身是否值得做;$spec [mode=draft] 产出无技术细节的八段式规格,前置标记 provisional: true;$spec [mode=tests] 编写 §8 行为测试用例,证据为 TBD、状态为 Planned。
使用方式:以 $start-workflow workflow-idea-to-spec 激活,并把用户提示作为上下文。在 Codex 中以 $skill-name 调用仓库技能。必须在执行步骤前创建并同步任务追踪,按顺序逐步执行并报告证据,不得跳过、重排或合并步骤。
适用场景:PO/BA 有原始产品愿景或问题陈述、团队希望在写代码前以规格先行方式固化预期行为、需要一份经过评审且可供 AI 实现的功能规格作为事实来源。
限制:不在此处分解 PBI/故事/待办;无界面纯后端想法跳过 $design-spec;若无新领域实体可跳过 $domain-analysis;若用户已确认理由且无替代方案可跳过 $why-review 门禁;规格在代码落地前保持临时状态,证据为 TBD,需后续用 spec [mode=update] 升级。其他未提供的细节暂未提供。