SuperAPI AI 工具集

recipe-design

编程与开发

查看项目

更新于 10-16 02:25

技能介绍

用途

recipe-design 是一个设计阶段的工作流配方,目标是从仓库证据出发,协调完成一份经审批的设计文档(Design Doc)。它适用于 Medium/Large 规模的工作,设计文档始终是完整的实现设计。若存在符合条件的 ADR 批次,会在设计文档之前先收窄技术选择,而设计文档仍保留完整流程与实现边界。

主要能力

  • 选定治理性需求来源:优先使用已批准的 PRD 路径,否则使用经确认的需求原文。
  • 收集决策材料:调用 dev-workflows:codebase-analyzer,让其发现受影响的路径、职责边界与跨层契约。
  • 确认范围与 ADR 决策:执行 requirement-convergence 技能,判断四个收敛字段,确定 Structural Scale,并对候选决策点应用 documentation-criteria 过滤器,筛选出 adrDecisionPoints。
  • 创建并审批 ADR 批次:当存在 adrDecisionPoints 时,调用 technical-designer 创建 ADRBatch,再由 document-reviewer 评审,通过后经用户审批并将各 ADR 状态更新为 Accepted。
  • 创建设计文档:调用 technical-designer 生成完整 MVP 实现设计。
  • 验证与解决仓库主张:调用 code-verifier 验证当前前提与可行性,对差异应用 Review Resolution。
  • 评审与审批:调用 document-reviewer 评审,调用 design-sync 检查与其他设计文档的一致性,最后提交用户审批。

使用方式

该配方以工作流形式执行,包含多个步骤与 [Stop] 停点。每个停点需等待用户明确确认。执行时按依赖顺序推进:需求来源 -> codebase-analyzer -> 范围/决策确认 [Stop] -> 可选 ADR 批次 -> 批次评审 [Stop] -> Design Doc -> code-verifier -> Review Resolution -> document-reviewer -> design-sync -> 审批 [Stop]。在每次调用时,需将指定来源值机械地复制到对应字段,仅应用声明的序列化,然后立即调用。需求通过 $ARGUMENTS 传入。

适用场景

适用于需要从代码库分析到设计文档审批的完整设计流程,尤其是 Medium/Large 规模、需要 ADR 决策或跨层契约确认的工作。

限制

  • 各 [Stop] 停点必须获得用户明确确认才能继续。
  • ADR 创建仅限通过两个过滤器的决策点。
  • 设计文档无论是否需要 ADR 都必须存在。
  • 具体安装命令、收费、价格、平台等信息暂未提供。