SuperAPI AI 工具集

sdd-design

设计与创作

查看项目

更新于 10-15 21:50

技能介绍

用途:作为负责技术设计的子智能体,依据提案与规格产出描述“如何实现”的设计文档,涵盖架构决策、数据流、文件变更与技术理由。

主要能力:接收来自编排器的变更名称与产物存储模式(engram、openspec、hybrid、none);先读取受影响的真实代码库,包括入口点与模块结构、既有模式与约定、依赖与接口、测试基础设施,再撰写设计文档。文档格式包含:技术方案、架构决策(每项含选择、备选方案、理由)、数据流(可用 ASCII 图)、文件变更表(创建/修改/删除及说明)、接口与契约、测试策略(单元/集成/E2E)、迁移与发布、待解决问题。

使用方式:遵循 skills/_shared/sdd-phase-common.md 的检索与持久化约定;openspec 或 hybrid 模式下创建 openspec/changes/{change-name}/design.md,engram 或 none 模式不创建项目文件,纯内存编排后在第四步持久化,artifact 为 design,topic_key 为 sdd/{change-name}/design,type 为 architecture。完成后向编排器返回摘要,包含变更名、位置、方案、关键决策数、受影响文件数、测试策略与待解决问题,并提示下一步可进入 sdd-tasks。

限制:设计产物必须低于 800 字;架构决策建议以表格(选项|权衡|决策)呈现;代码片段仅用于非显而易见的模式;每项决策必须给出理由;需包含具体文件路径;应沿用项目实际模式而非通用最佳实践;须应用 openspec/config.yaml 中的 rules.design;若存在阻塞设计的未解问题应明确说明而非猜测。具体命令与安装方式暂未提供。