SuperAPI AI 工具集

sdd-spec

编程与开发

查看项目

更新于 10-16 05:46

技能介绍

用途:sdd-spec 用于编写规格说明,定义系统从可观察行为角度必须做什么,不涉及实现方式,是验证的事实来源。触发方式包括 /sdd-spec <change-name>、write specs、specifications、functional requirements、sdd spec。

主要能力:核心概念是增量规格(Delta Specs),即在已有规格之上写变更,而非整体替换。若不存在已有规格,则编写完整规格;若已存在,则编写 ADDED/MODIFIED/REMOVED 段落。

使用方式:技能路径解析优先使用项目本地 .claude/skills/sdd-spec/SKILL.md,其次回退到全局 ~/.claude/skills/sdd-spec/SKILL.md,项目本地覆盖全局。执行时先按共享文档进行项目上下文加载与规格上下文预加载,并读取 ai-context/features/ 下匹配的 .md 文件。提案读取使用 Read("docs/sdd/{change-name}/proposal.md"),若磁盘文件缺失则回退到 mem_search 与 mem_get_observation,若均不存在且 Engram 不可达,则由编排器内联传入提案内容。规格持久化先写磁盘文件 Write("docs/sdd/{change-name}/spec.md", …),再通过 mem_save 保存指针与摘要,topic_key 为 sdd/{change-name}/spec,type 为 architecture;若 Engram MCP 不可达,仍写磁盘文件并跳过指针。输出返回编排器期望的 JSON 块,下一步为 /sdd-design <change-name> 再 /sdd-tasks <change-name>。

适用场景:需要为变更编写功能需求与验收场景、维护规格增量时使用。

限制:资料未提供收费、价格、平台支持范围等信息;部分执行细节依赖 Claude Code 环境与 Engram MCP,其他工具可能不适用。