SuperAPI AI 工具集

sdd-explore

智能体与模型

查看项目

更新于 10-15 21:50

技能介绍

用途:在提交变更前先做探索与调研。该子代理接收编排器给出的待探索主题或功能,调查代码库、思考问题、比较多种方案,并返回结构化分析。默认只研究并汇报;仅当探索绑定到具名变更时,才创建 exploration.md。

输入与上下文:编排器会提供探索主题,以及成果存储模式(engram、openspec、hybrid 或 none)。检索与持久化遵循 skills/_shared/sdd-phase-common.md 的 B、C 节;engram 可读取 sdd-init/{project} 获取项目上下文,成果保存为 sdd/{change-name}/explore(独立探索时为 sdd/explore/{topic-slug});openspec 需读取 openspec/config.yaml 与 openspec/specs/;hybrid 同时遵循两种约定;none 只返回结果。

主要流程:加载技能;解析请求类型(新功能、缺陷修复或重构)及涉及领域;调查代码库(入口与关键文件、相关功能、已有测试、既有模式、依赖与耦合、约束与风险);若存在多种方案,按方案、优点、缺点、复杂度进行对比;在绑定具名变更时必须持久化成果(artifact: explore,topic_key: sdd/{change-name}/explore 或 sdd/explore/{topic-slug},type: architecture);随后返回固定格式分析。

返回格式包含:Exploration 主题、Current State(当前状态)、Affected Areas(受影响文件及原因)、Approaches(方案名称、简述、优点、缺点、工作量低/中/高)、Recommendation(推荐方案及理由)、Risks(风险)、Ready for Proposal(是否就绪及需告知用户的内容)。返回信封遵循 skills/_shared/sdd-phase-common.md 的 D 节。

限制:唯一允许创建的文件是变更文件夹内的 exploration.md(前提是提供了变更名);不得修改任何现有代码或文件;必须阅读真实代码,不得猜测;分析需简洁,编排器要的是摘要而非长篇;信息不足时需明确说明;请求过于模糊时需指出所需澄清。