用途:recipe-design 是面向设计阶段的工作流技能,负责从代码库范围分析推进到 ADR(架构决策记录)或设计文档(Design Doc)的创建与审批。
主要能力:先做范围引导(scope bootstrap),按关键词用 rg 或 grep 定位候选文件,分桶为源码、测试、文档与生成/依赖文件,并输出 affectedFiles、affectedLayers、scale、adrRequired、prdRequired 等 requirement_analysis;随后依次调用 codebase-analyzer、technical-designer、code-verifier、document-reviewer、design-sync 等子代理。ADR 仅输出时跳过 code-verifier 和 design-sync。
使用方式:按流程执行 scope bootstrap -> codebase-analyzer -> [停止:范围确认] -> technical-designer -> code-verifier -> document-reviewer -> design-sync -> [停止:设计审批]。每个 [停止] 标记必须等待用户显式确认;每个 spawn_agent 调用使用 fork_turns="none"。使用前需加载 documentation-criteria、implementation-approach、llm-friendly-context 三项技能。关键词搜索命令为 rg -l --glob '!/{node_modules,dist,build,coverage,.git}/' --glob '!**/*.{lock,min.js,map}' '<keyword>'。
适用场景:需要基于现有代码库产出设计阶段文档,包括架构变更、引入新技术或数据流变化时创建 ADR,以及创建包含组件设计、验收标准和 Design Convergence 结果的 Design Doc。
限制:技能范围止于设计文档审批,工作规划及之后步骤不在范围内;当 prdRequired 为 true 且用户既未提供 PRD 路径也未明确批准不提供 PRD 时,流程停止,本技能不创建 PRD;Design Doc 唯一时 design-sync 返回 sync_status: "SKIPPED",须与 NO_CONFLICTS 区分报告;排名种子超过 20 个文件时需用户收窄范围;未提供收费、平台等资料。