苏格拉底式提问澄清

解决什么问题

复杂任务最大的风险不是实现难度，而是意图被错误理解。当一句话需求背后还藏着多个关键未知时，模型如果直接动手，很容易在错误方向上快速推进，最后返工。awesome-socrates 把“先确认方向”变成执行前的一个轻量检查点：用苏格拉底式追问暴露不确定，把关键决策权交还用户，再开始实现。

工作方式

它不是一个无差别提问器，而是按触发条件决定是否介入：任务涉及 ≥3 个模块或步骤、需求模糊且隐藏 ≥3 个关键未知、存在多种技术选型、执行删除/发布/付费等不可逆操作、或属于大型重构时，应触发提问；变量改名、读取文件、格式转换这类明确单步任务则不触发。

触发后先识别真正影响结果的未知，聚焦范围、方案选择、约束、预期结果、上下文和风险。随后通过 AskUserQuestion 做结构化提问：单轮最多 4 题，累计不超过 6 题；推荐项放首位并说明理由；选项互斥，不添加“其他”。收到回答后先输出 3-7 行执行计划，再开始执行，并在关键节点复述进度；如果用户回答偏离原任务，先停一下确认新方向。

适用边界

它的价值在于避免过度执行，而不是增加沟通负担。对明确、简单、上下文充分或用户已说“直接做”的任务，应直接执行；能从代码库、文件或记忆查到的信息，要先查再问。不要循环追问同一批问题，也不要让用户替模型做本该模型决定的实现细节。当判断不确定时，默认倾向触发，但要把问题数量压到下限。

配套资料 references/question-dimensions.md、references/anti-patterns.md 和 references/full-scenarios.md 分别给出提问维度、反模式和完整剧本。