sdd-spec

sdd-spec

编写包含需求和 Given/When/Then 场景的增量规格说明。

触发方式：/sdd-spec <change-name>、编写规格说明、规格说明、功能需求、sdd 规格

---

用途

规格说明从可观察行为的角度定义系统必须做什么。它们不说明如何实现，是验证的事实来源。

核心概念 — 增量规格说明： 规格说明是基于现有内容的增量（变更），而不是完整替换。

• 如果没有现有规格说明：编写完整规格说明
• 如果规格说明已存在：编写 ADDED/MODIFIED/REMOVED 部分

---

技能解析

协调器启动此子 Agent 时，会使用以下方式解析技能路径：

1. .claude/skills/sdd-spec/SKILL.md     (project-local — highest priority)
2. ~/.claude/skills/sdd-spec/SKILL.md   (global catalog — fallback)

项目本地技能优先于全局目录。完整算法请参阅 docs/SKILL-RESOLUTION.md。

---

---

Claude 执行接线

这些说明将上述与工具无关的逻辑绑定到 Claude Code 执行框架。它们属于无法移植到其他工具的执行层。

• Step 0a/0c 预加载 — 遵循 skills/_shared/sdd-phase-common.md Section F （项目上下文加载）和 Section G（规格说明上下文预加载）。非阻塞。
• Step 0b 领域预加载 — 列出 ai-context/features/ 中的 .md 文件，并 Read 每个匹配的文件。读取错误视为未命中（静默跳过）。
• 提案读取 — 使用执行框架的 Read("docs/sdd/{change-name}/proposal.md") 工具。如果磁盘文件不存在（旧版变更），则回退到 mem_search(query: "sdd/{change-name}/proposal") → mem_get_observation(id)。 如果两者都不存在且 Engram 不可访问，协调器会内联传递提案 内容。
• 规格说明持久化 — 首先将磁盘文件写入 Write("docs/sdd/{change-name}/spec.md", …)，然后使用 mem_save 保存指针和 摘要，参数为 topic_key: sdd/{change-name}/spec、type: architecture、 project: {project}，内容为 "path: docs/sdd/{change-name}/spec.md\n\n{1-3 sentence summary}"。如果 Engram MCP 不可访问，仍须写入磁盘文件（事实来源），仅跳过 engram 指针。
• 协调器输出 — 将中立的输出契约作为协调器预期的 JSON 块返回；手动后续步骤为 /sdd-design <change-name> 然后 /sdd-tasks <change-name>。如果预加载了领域上下文，则在 artifacts 中列出已加载的 ai-context/features/*.md 文件（已读取，未写入）。