SuperAPI AI 工具集

clarify-spec

智能体与模型

查看项目

更新于 10-16 04:36

技能介绍

用途

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 个问题同时提出),不要逐个提问,也不要分散到多条消息中。问题优先级:

  1. 目标(ZIEL):目标本身有歧义——是哪种解释?
  2. 范围(SCOPE):不可逆操作时——具体影响什么?
  3. 信息(INFO):缺少仓库中任何地方都没有的信息。

“什么/哪里”类问题(“哪个文件?”“前端还是后端?”)不属于此处——这些由阶段 1 回答。

阶段 4:得到回答后——自主推进

一旦得到回答,就一路做完。不再追问,不设每步审批检查点,不重新澄清。只有真正此前不可见的阻塞才值得再问一次。

逃生舱(Escape Hatches)

以下情况完全跳过澄清:“直接做”/“你自己决定”/“不要追问”、“无所谓,只要 X 能用就行”/“Just do it”。此时以最佳判断执行,并在结尾简要说明所做的假设。

与其他技能的关系

prompt-architect 不再在本技能之后自动触发。若需要结构化提示,由用户显式调用 /prompt-architect。

适用场景

适用于使用 Claude Code 进行开发任务时,需要在“直接开工”与“向用户澄清”之间做出判断的场景,尤其适合希望减少无谓追问、提高自主推进效率的工作流。

限制

该技能本身不提供具体代码实现或安装命令,资料中未提供安装方式、平台要求、收费信息等。其成功标准为:助手不陷入提问循环;日常任务无需追问即可完成;仅在真正歧义时提问且只问一次;不出现“我不是这个意思”的情况,因为阶段 1 已提供上下文。