sdd-propose

sdd-propose

创建一份变更提案，明确意图、定义范围并说明技术方案。

触发方式：/sdd-propose <change-name>、创建提案、定义变更、sdd 提案

---

目的

提案在进入技术细节之前定义要做什么以及为什么做。它是变更的范围契约。未经批准的提案，不会有规范或设计。

对于重要提案（涉及跨团队范围、多个利益相关方或面向用户的产品变更），可选择将提案与 PRD 配套，使用 docs/templates/prd-template.md。PRD 记录问题陈述、目标用户、用户故事、NFR 和验收标准，并直接为 sdd-spec 阶段提供输入。内部重构或只有单个利益相关方的变更可跳过 PRD。

技能解析

按顺序：项目本地 → 全局

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

完整算法请参阅 docs/SKILL-RESOLUTION.md。

---

---

Claude 执行连接

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

• 步骤 0a 预加载 — 遵循 skills/_shared/sdd-phase-common.md 第 F 节 （项目上下文加载）。非阻塞。
• 步骤 0c 预加载 — 遵循 skills/_shared/sdd-phase-common.md 第 G 节 （规范上下文预加载）。非阻塞。
• 制品读取 — 使用工具框架的 Read("docs/sdd/{change-name}/explore.md") 工具（以磁盘为主，遵循 _shared/sdd-phase-common.md 第 B 节）。如果磁盘 文件不存在（旧版变更），则回退到 mem_search(query: "sdd/{change-name}/explore") → mem_get_observation(id)。
• 提案持久化 — 以磁盘为主，遵循 _shared/sdd-phase-common.md 第 C 节：先执行 Write("docs/sdd/{change-name}/proposal.md", <full markdown>)， 然后使用 topic_key: sdd/{change-name}/proposal、 type: architecture、project: {project}，通过 mem_save 保存指针和摘要。如果 Engram MCP 无法访问：仍然 写入磁盘制品；仅跳过 engram 指针。Step 3a-bis 门禁 失败路径不得调用 Write 或 mem_save。
• 编排器输出 — 将中立的输出契约作为编排器所需的 JSON 块返回；持久化指针的制品条目为 engram:sdd/{change-name}/proposal。手动后续步骤为 /sdd-spec <change-name> 和 /sdd-design <change-name>（可以并行运行）。