用途
Clarify-Spec v3.0 是一个任务澄清技能,用于判断何时应当向用户提问、何时应当自行调研后直接开工。它的设计目标是防止因过度追问而陷入“提问循环”——即助手只顾打字提问而不推进实际工作。
其基本立场是:先自己查看,再做出资深工程师式的决定;只有当存在真正的目标歧义时,才一次性集中提问。
主要能力
该技能定义了明确的触发与不触发条件。
触发条件(高门槛)——仅在自行调研后仍满足以下至少一项时才触发:
- 目标本身不清晰或自相矛盾,例如“按之前说的做”,但没有任何关于“之前说了什么”的记录。
- 存在多个根本不同的解释,例如“清理一下 Auth”,可能指重构、日志、令牌轮换或测试,且都说得通。
- 缺少仓库中任何地方都找不到的信息,例如“用新 API”,但代码、文档、Issue 中都没有该 API。
- 不可逆操作且范围不明,例如“删掉旧分支”,但具体是哪些?且不可恢复。
不触发条件——以下情况不应提问,而应调研并工作:
- 简短任务(“修复导出 Bug”)→ 查找 Bug 并修复。
- 模糊动词(“把页面做得更好”)→ 若上下文已能说明问题(明显 Bug、布局损坏)则直接修复;若确实开放,则在查看页面后,用一个集中问题询问“更好”具体指什么。
- 未给出文件名 → 用 Glob/Grep 找到文件。
- “照旧”/“老样子” → 通过 Git 历史和现有模式判断“照旧”的含义。
使用方式
该技能按四个阶段工作:
阶段 1:先自行调研(始终、静默、无需用户参与)
在提出任何问题之前:用 Glob/Grep 查找并阅读相关文件;检查 CLAUDE.md / AGENTS.md / Memory;查看 Git 历史与类似的现有实现;识别不可触碰区域。阶段 1 之后,绝大多数情况下问题已被解答,此时直接工作,跳过阶段 2-4。
阶段 2:歧义真实性检查
若阶段 1 后仍有未决事项,判断它是真正的目标歧义,还是仅属可由资深判断处理的细节。可合理自行决定的细节 → 自行决定,在结果中记录假设,继续工作。真正的目标歧义 → 进入阶段 3。
阶段 3:一个集中的问题块
若必须提问,则通过 AskUserQuestion 工具一次性提出所有未决点(最多 4 个问题同时提出),不要逐个提问,也不要分散到多条消息中。问题优先级:
- 目标(ZIEL):目标本身有歧义——是哪种解释?
- 范围(SCOPE):不可逆操作时——具体影响什么?
- 信息(INFO):缺少仓库中任何地方都没有的信息。
“什么/哪里”类问题(“哪个文件?”“前端还是后端?”)不属于此处——这些由阶段 1 回答。
阶段 4:得到回答后——自主推进
一旦得到回答,就一路做完。不再追问,不设每步审批检查点,不重新澄清。只有真正此前不可见的阻塞才值得再问一次。
逃生舱(Escape Hatches)
以下情况完全跳过澄清:“直接做”/“你自己决定”/“不要追问”、“无所谓,只要 X 能用就行”/“Just do it”。此时以最佳判断执行,并在结尾简要说明所做的假设。
与其他技能的关系
prompt-architect 不再在本技能之后自动触发。若需要结构化提示,由用户显式调用 /prompt-architect。
适用场景
适用于使用 Claude Code 进行开发任务时,需要在“直接开工”与“向用户澄清”之间做出判断的场景,尤其适合希望减少无谓追问、提高自主推进效率的工作流。
限制
该技能本身不提供具体代码实现或安装命令,资料中未提供安装方式、平台要求、收费信息等。其成功标准为:助手不陷入提问循环;日常任务无需追问即可完成;仅在真正歧义时提问且只问一次;不出现“我不是这个意思”的情况,因为阶段 1 已提供上下文。