SuperAPI AI 工具集

sdd-design

设计与创作

查看项目

更新于 10-16 01:06

技能介绍

用途 sdd-design 是 SDD/AgentSpec 工作流的 Design 阶段技能,读取 Brainstorm 与 DEFINE 两个 Markdown 文档(可选 UX Review),产出可实现的技术设计文档,结束处指向 SDD Build by RDD。

主要能力 按优先级整合需求来源(用户最新明确回答 > UX Review > DEFINE > Brainstorm),在项目上下文可用时检查代码与约定;识别阻塞架构的技术缺口并按需提问;生成 Architecture Overview(ASCII 图)、Components、以 ADR 形式记录的 Key Decisions、File Manifest(编号、路径、动作、用途、owner/agent、依赖)、Code Patterns、Data Flow、Integration Points、Testing Strategy、Error Handling、Configuration/Security/Observability,并按条件处理 LLM Prompts 章节。

必要用法 需要 Brainstorm(建议 BRAINSTORM_{FEATURE_NAME}.md)与 DEFINE(建议 DEFINE_{FEATURE_NAME}.md)两个文件,提问前须先完整阅读;产出按 assets/DESIGN_TEMPLATE.md 结构填写并去除占位符。有文件系统与 Python 时执行:python scripts/validate_design.py <DESIGN.md>。保存为 sdd/DESIGN_{FEATURE_NAME}.md(若项目已有 .claude/sdd/ 则存该处),不静默覆盖已有文件。文档最后一段固定为:## Next Step 与 Execute o SDD Build by RDD。

适用场景与限制 适用于已有 Brainstorm 与 DEFINE、需要落地技术设计的特性开发;可选输入包括项目目录树、仓库技术约定、API/数据库/基础设施文档、真实测试与 lint 命令、可用 agent 目录、用户澄清回答。不要求联网;若无法访问仓库、代码、agent 或基础设施,不得声称已检查。缺少 Brainstorm 或 DEFINE 时应先索要文件,不从单一文档强行产出最终 Design。若存在阻塞性未决项,应交付 Draft/Needs Clarification,而非标记 Ready for Build。validate_design.py 只校验结构与基本一致性,不替代架构评审。