生产力
ask-questions-if-underspecified avatar

ask-questions-if-underspecified

在需求不明确时提出必要的澄清问题,从而最大限度地减少错误的实施。

简介

ask-questions-if-underspecified 技能是 AI 代理和开发人员旨在提高效率并减少返工的重要工具。它提供了一种结构化的方法来识别和解决项目请求中的模棱两可,确保代理程序不会在可能导致技术债或错误结果的假设下进行。通过在采取行动前强制暂停,它鼓励针对范围、约束或目标定义不清的复杂任务采取慎重的方法。

此技能专为与 AI 代理交互以执行复杂技术操作的软件工程师、安全审计员和系统架构师而设计。当处理模糊的功能请求、不明确的架构需求或模糊的性能约束时,它特别有价值。代理程序不会盲目猜测,而是会主动向用户询问进行安全操作所需的最低限度信息。

  • 根据关键标准自动评估请求的清晰度:目标、完成状态 (done)、范围、约束、环境与安全性。

  • 实作“先提问”的工作流程,在第一轮中提出 1-5 个具针对性、易于扫描且可执行的问题。

  • 支持多选格式以减少人类操作员的阻力,包括预设行为或“不确定”场景的选项。

  • 强制执行“行动前暂停”策略,防止在解决必要的模糊之处前执行指令或修改代码库。

  • 促进对解释的明确确认,确保代理程序与用户在开始任何工作前就预期结果达成一致。

  • 当遇到涉及多种合理诠释的请求,或关于系统设计或安全需求的关键细节丢失时,请使用此技能。

  • 对于可以通过对现有文档或配置文件进行低风险探索性阅读来解决的琐碎任务,请勿使用此技能。

  • 输入通常包括用户的初始请求和代理程序对代码库内容的内部分析;输出为格式化、易于阅读的澄清问题。

  • 请遵循建议的模板结构:编号问题、字母选项和明确的回复路径(例如:1a 2b),以加快反馈循环。

  • 当被迫在没有答案的情况下进行时,严格遵守将所有假设记录在编号清单中以供用户验证的原则。

仓库统计

Star 数
4,856
Fork 数
421
Open Issue 数
29
主要语言
Python
默认分支
main
同步状态
空闲
最近同步时间
2026年4月28日 12:39
在 GitHub 查看