SuperAPI AI 工具集

clarification

通用与其它

查看项目

更新于 10-16 04:53

技能介绍

用途:当用户请求含糊、范围不清或可能影响现有代码结构时,该技能通过“先探索、后提问”的迭代流程,把模糊需求收敛为明确的工作范围。它本身不写代码,终点是让“用户想要什么”和“代码库现状”都清晰可验证。

主要能力:先派发 Explore 子代理做侦察,梳理文件结构、既有模式、接口边界、近期改动与测试覆盖;随后基于发现提出有依据的问题,独立问题可一轮最多4个,依赖问题迭代追问,直到歧义消除。每轮同步更新已确认内容,并继续按需探索新区域。最终产出 Context Brief,包含目标、范围(含/不含)、技术背景、约束、成功标准、未决问题,以及按范围广度、文件影响、接口边界、依赖深度、风险面五项信号打分的复杂度评估(5-15分)。

使用方式:适用于用户说“我想做……”但范围不清、实现方向可能多样、或需避免与现有结构冲突的场景。不适用于需求已明确、简单修复或配置变更,以及用户明确要求不要提问的情况。流程为:收到模糊请求后立即派发侦察子代理,返回后再组织第一轮问题;用户回答期间并行派发后续探索;循环直至歧义消除,展示 Context Brief,用户批准后保存到 docs/engineering-discipline/context/YYYY-MM-DD-<topic>-brief.md(用户可指定其他位置)。

路由与限制:复杂度评分5-8建议进入 plan-crafting,9分由用户选择,10-15建议 milestone-planning;用户可覆盖路由。该技能不自行调用下一技能,只展示并保存 Context Brief 并建议下一步。若同一主题追问3次以上、发现与现有代码冲突、或请求可拆为多个独立子任务,需停下重新校准。禁止在探索前提问、把依赖问题打包一轮、向用户倾倒原始探索结果,或未经确认单方面开始实现。具体命令与安装方式资料未提供。