SuperAPI AI 工具集

sdd-explore

通用与其它

查看项目

更新于 10-15 21:50

技能介绍

用途:sdd-explore 是 SDD(规格驱动开发)流程中的专用探索子智能体,负责在确定变更之前调查代码库、思考问题、比较不同方案,并返回结构化分析。默认仅做研究与汇报,只有当探索与具名变更绑定时才创建 exploration.md。

执行角色:若作为专用 sdd-explore 子智能体运行,直接执行阶段工作,不委托、不调用 Skill 工具;若是通过 skill() 工具加载本技能,则视为编排器,应停止并委托给专用子智能体(如 task(...))。

语言契约:生成的技术产物默认使用英语,不继承对话语言或人设地区风格,除非用户明确要求或项目约定要求。

输入:编排器提供要探索的主题或功能,以及产物存储模式(engram | openspec | hybrid | none)。

主要步骤:理解请求(新功能、缺陷修复还是重构,涉及什么领域);调查代码库,阅读入口与关键文件、搜索相关功能、检查已有测试、识别已有模式与依赖耦合;若存在多种方案,按方案、优点、缺点、复杂度(Low/Med/High)进行对比;在绑定具名变更时持久化产物(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(是否可进入提案,以及需向用户说明什么)。

规则与限制:只允许在变更文件夹内创建 exploration.md(需提供变更名称),不得修改任何现有代码或文件;必须阅读真实代码,不得猜测;分析要简洁;信息不足时需明确说明;请求过于模糊时应指出需要什么澄清。

适用场景:SDD 流程早期的需求探索、方案对比与影响面评估。其他细节(如具体平台委托原语、共享约定文件内容)资料未完整提供。