SuperAPI AI 工具集

ask-questions-if-underspecified

智能体与模型

查看项目

更新于 10-16 01:06

技能介绍

该技能用于在开始实现前澄清需求,仅当请求存在多种合理解释,或目标、范围、约束、环境、安全等关键细节不清晰时使用;若请求已明确,或通过一次低风险查看即可补齐信息,则不应使用。目标是用最少的必要问题避免错误工作,在关键问题得到回答或用户明确同意按假设推进前,不开始实现。

判定不充分:参考目标(什么要改、什么不变)、完成标准(验收标准、示例、边界情况)、范围(哪些文件/组件/用户在范围内)、约束(兼容性、性能、风格、依赖、时间)、环境(语言/运行时版本、操作系统、构建/测试运行器)、安全与可逆性(数据迁移、发布/回滚、风险)。仅当不同解释会实质改变结果或风险时才提问,常规且可逆的细节应从现有上下文解决。

提问方法:首轮提 1–5 个必须知道的问题,优先消除整条工作分支。问题要易于回答,短小并编号,尽量给多选项;可给合理默认值并明确标注为默认或推荐,提供快速回复路径(如回复 defaults 接受全部推荐项),必要时提供“不确定—使用默认”选项;可将“必须知道”与“最好知道”分开;让用户用紧凑选择回复(如 1b 2a 3c),随后用平实语言复述确认。

行动前暂停:未获关键回答前,不运行命令、不编辑文件、不产出依赖未知项的详细计划;仅在不会锁定方向时,可进行清楚标注的低风险查看(如检查仓库结构、读取相关配置文件)。若用户明确授权按合理假设推进,简要说明假设并继续,不再重复确认;只保留真正缺失的重大授权或必要输入,同时完成独立安全的工作。

获得回答后,用 1–3 句话复述需求(含关键约束与成功标准)再开始工作。限制:仅适用于明确匹配上述范围的请求;输出不能替代特定环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。