sdd-design

sdd-design

制定技术设计，包含架构决策、数据流和文件变更计划。

触发方式：/sdd-design <change-name>、技术设计、变更架构、sdd 设计

---

用途

设计定义了如何实现规范要求系统必须执行的操作。它是需求与代码之间的桥梁，用于记录技术决策及其理由。

技能解析

当编排器启动此子 Agent 时，会按以下顺序解析技能路径：项目本地 → 全局：

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

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

---

---

Claude 执行接线

以下说明将上述与工具无关的逻辑绑定到 Claude Code 执行环境。这些说明属于无法移植到其他工具的执行层。

• 步骤 0 预加载 — 按照 skills/_shared/sdd-phase-common.md 第 F 节 （项目上下文加载）和 第 G 节（规范上下文预加载）执行。非阻塞。
• 制品读取 — 使用执行环境的 Read("docs/sdd/{change-name}/<artifact>.md") 工具读取提案和规范。如果磁盘文件不存在（旧版变更），则回退到 mem_search(query: "sdd/{change-name}/<artifact>") → mem_get_observation(id)。如果两者都不存在且无法访问 Engram， 编排器会以内联方式传递内容。
• 技能注册表交叉引用 — 与工具无关的“项目技术指南”指向 ~/.claude/skills/ 下的全局目录以及任何项目本地的 .claude/skills/。 将项目中未注册的目录技能标记为 [optional — not registered in project; add via /skill-create <name>]。
• 设计持久化 — 首先通过执行环境的 Write("docs/sdd/{change-name}/design.md", <full design markdown>) 写入制品， 然后使用 mem_save 保存一个指针和摘要，参数为 topic_key: sdd/{change-name}/design、 type: architecture、project: {project}，内容为 "path: docs/sdd/{change-name}/design.md\n\n{1-3 sentence summary}"。如果无法访问 Engram MCP，仍需写入磁盘制品；仅跳过 engram 指针。
• ADR 生成（步骤 4） — 使用执行环境的文件工具（Read/Write/Edit）执行复制和编辑；非阻塞，任何失败都只作为警告处理。
• 编排器输出 — 按编排器的预期，以 JSON 块形式返回中立的输出契约；制品列表同时列出 engram 指针 engram:sdd/{change-name}/design 和磁盘路径，手动下一步为 /sdd-tasks <change-name>。