sdd-explore

sdd-explore

在提交更改之前，调查并分析一个想法或代码库中的某个领域。

触发条件：/sdd-explore <topic>、探索、调查代码库、更改前分析、研究功能

---

目的

EXPLORE 是任何继续推进的 SDD 周期都必须经过的强制关卡。它在 propose、spec、design、tasks 和 apply 之前运行，并生成一份已持久化且附带引用的产物。在 EXPLORE 将其产物写入磁盘之前，不得开始任何后续阶段。它不创建代码，也不修改任何内容——只负责读取和分析。

技能解析

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

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

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

---

---

Claude 执行接线

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

• 步骤 0 预加载 — 遵循 skills/_shared/sdd-phase-common.md 第 F 节 （项目上下文加载）和 第 G 节（Spec 上下文预加载）。两者均为非阻塞操作。EXPLORE 专属覆盖逻辑（必须尝试读取 ai-context/features/<domain>.md 和 ai-context/architecture.md，若文件不存在则输出可见的 INFO: 提示）是有意设计的，且不会修改 _shared/sdd-phase-common.md 的第 G 节。
• 交接上下文预加载 — 使用 mem_search(query: "sdd/<slug>/proposal") 检查 engram 中是否存在预先提供的提案；若存在，则通过 mem_get_observation(id) 获取。记录 Handoff context loaded from engram: sdd/<slug>/proposal。此操作为非阻塞。
• 先前尝试扫描 — 使用 mem_search(query: "sdd/archive-report", project: "{project}") 搜索 engram，然后通过 mem_get_observation(id) 获取每个相关结果，以检查结果。
• 产物持久化（步骤 8，以磁盘为主） — 根据 skills/_shared/sdd-phase-common.md 第 C 节：先执行 Write("docs/sdd/{change-name}/explore.md", <full exploration markdown>)，然后使用 topic_key: sdd/{change-name}/explore、 type: architecture、project: {project} 执行 mem_save，保存指针和摘要。如果 Engram MCP 无法访问，仍需写入磁盘产物（事实来源），仅跳过 engram 指针。
• 编排器输出 — 返回编排器所需的 JSON 块形式的中性输出契约；artifacts 同时报告 engram:sdd/{change-name}/explore 和磁盘路径，手动执行的下一步为 /sdd-propose。