SuperAPI AI 工具集

sdd-clarify

编程与开发

查看项目

更新于 10-15 16:47

技能介绍

用途:作为 SDD 流程的入口,在用户提出功能或缺陷修复(add、build、fix 等)时,先不要直接写规格或改代码,而是先做一轮简短、精准的澄清,把含糊需求转为范围明确的 SDD 变更。

主要能力:先低成本收集上下文,只读理解代码与规格中已决定的内容,不问仓库能回答的问题;按维度扫描歧义,如功能范围与边界、数据模型与持久化、集成与依赖、边界情况与失败行为、非功能要求、术语与领域歧义,仅保留真正未决且会改变实现的问题。提问遵循决策树:范围问题优先,独立问题合并为一次 AskUserQuestion 调用,每题 2–4 个可选项,推荐项在前并标注;只有答案开启新依赖分支时再做一轮,整个澄清约两轮。答案写入 OpenSpec 提案或规格,不在聊天中留存。

使用方式:小改动或单文件、缺陷修复,走 /opsx:propose 再 /opsx:apply;大型、跨切面或涉及聊天界面的需求,带着澄清后的目标启动 sdd-feature-flow 工作流。若请求本身无歧义,则跳过提问直接进入后续步骤。PR 阶段的评审不属于本技能,由 pre-pr-greptile 负责。

适用场景:适用于需要先明确目标再进入规格与实现的功能开发或修复流程。

限制:避免过度提问,最多 3–4 个关键问题,清晰时为零;不得为补空缺编造事实,未知但关键应提问,未知且次要可选合理默认并在规格中说明;澄清结果必须写入 OpenSpec 产物;生产源码修改仍需由此产生的活跃变更授权。其他收费、平台等信息暂未提供。