SuperAPI AI 工具集

sdd-explore

写作与研究

查看项目

更新于 10-15 21:41

技能介绍

用途:sdd-explore 是 SDD 循环中任何继续推进的流程都必须经过的强制关卡,运行在 propose、spec、design、tasks、apply 之前。它只读取和分析,不创建代码、不修改任何内容,并产出一份持久化、带引用的探索产物;在 EXPLORE 将产物写入磁盘前,下游阶段不得开始。

触发方式:/sdd-explore <topic>,或使用 explore、investigate codebase、analyze before changing、research feature 等触发词。

技能解析:编排器启动该子代理时按优先级解析技能路径:1. .claude/skills/sdd-explore/SKILL.md(项目本地,最高优先级);2. ~/.claude/skills/sdd-explore/SKILL.md(全局目录,回退)。项目本地技能覆盖全局目录,完整算法见 docs/SKILL-RESOLUTION.md。

执行接线(Claude Code 环境):Step 0 预加载遵循 skills/_shared/sdd-phase-common.md 的 Section F(项目上下文加载)与 Section G(规格上下文预加载),两者均非阻塞;EXPLORE 本地覆盖会强制尝试读取 ai-context/features/<domain>.md 和 ai-context/architecture.md,缺失时输出可见的 INFO: 提示,且不修改 Section G。交接上下文预加载会检查 engram 中是否已有预置提案,使用 mem_search(query: "sdd/<slug>/proposal"),若存在则通过 mem_get_observation(id) 获取,并记录日志,非阻塞。先前尝试扫描使用 mem_search(query: "sdd/archive-report", project: "{project}"),再逐个用 mem_get_observation(id) 检索以检查结果。

产物持久化(Step 8,磁盘优先):先 Write("docs/sdd/{change-name}/explore.md", <完整探索 markdown>),再以 topic_key: sdd/{change-name}/explore、type: architecture、project: {project} 执行 mem_save 保存指针与摘要。若 Engram MCP 不可达,仍写入磁盘产物(事实来源),仅跳过 engram 指针。

输出:返回编排器期望的中立 Output Contract JSON 块;artifacts 同时报告 engram:sdd/{change-name}/explore 与磁盘路径,手动下一步为 /sdd-propose。

限制:仅做研究,不写代码、不做修改;依赖 Claude Code 执行环境与 Engram MCP(后者不可达时可降级为仅磁盘产物)。其他工具的可移植性、收费与价格信息暂未提供。