关于 clarifying-question-discipline
供 Agent 工作流使用的决策澄清技能,通过逐轮提问处理未决事项,并要求先达成共识再行动。它强调先调查可查证事实,避免过早给出方案。
主要功能
- 01每轮只问一个问题,并可多轮澄清
- 02提供推荐选项及简要理由
- 03提问前先查找可确认的事实
- 04达成共识后再采取行动
- 05强调先调查再提出建议
适用场景
- 01实施前澄清需求
- 02按依赖顺序解决决策
- 03提问前调查代码库事实
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ fudesign2008/ open-skills --skill clarifying-question-discipline安装后在 Claude Code 中输入/clarifying-question-discipline确认已加载。
详细介绍
澄清问题规范
内部共享技能。宿主必须在 frontmatter
dependencies中声明此技能,若缺失,则在启动时中止——不得静默回退。
对未决事项坚持不懈地向用户提问,直到达成共识。逐一梳理决策树的每个分支,依次解决依赖关系,让前面的答案重塑后续问题。一次提出多个问题会令人困惑。
硬性规则
- 每条消息只问一个问题——等用户回答后再问下一个。多轮进行,直到问题明确;这不是“整个会话只问一个问题”。优先使用口号 每轮一个问题 + 多轮直到明确;不要使用会让人理解为“问完就立即解决”的说法。
- 先澄清,后作答——关键未知事项尚未明确时,不要急于给出解决方案、结论或完整答案。只有当用户明确要求跳过进一步澄清时,才可提前继续(为其余事项记录假定的默认值)。
- 提供推荐答案——如果存在合理的默认选项,每个问题都应包含一个推荐选项或明确说明默认值,并用一行解释理由。用户可以只回复选项字母(“A”)。
- 区分事实与决策——如果某个事实可以在环境中(仓库、引用的文件、此前的消息、工具)查到,就去查;不要占用提问机会。决策由用户作出——逐项询问并等待回答。
- 提问前先了解上下文——提出第一个澄清问题之前(以及陷入困境时),先浏览相关文件、文档和近期提交。如果请求涉及多个相互独立的子系统,先帮助拆分范围;不要浪费轮次去细化一个必须拆分的项目。
- 共识门槛——除非用户确认你们对已澄清的计划/设计/实现路径达成共识,或明确要求跳过进一步澄清,否则不要采取行动。
无条件适用:此规范始终生效,不取决于是否安装了可选增强技能。
选择下一个问题:优先遵循决策树中的依赖关系;存在多个未决根节点时,优先询问目的 → 约束 → 成功标准。
问题形式(平台无关)
描述意图;由 Agent 选择原生能力——不要硬编码特定平台工具,也不要罗列“平台 X 使用 A,平台 Y 使用 B”。
- 优先采用结构化单选(一个问题 + 选项 + 推荐答案);如果固定选项会造成虚假的确定性,也可以开放式提问。
- 如果无法使用结构化界面,则使用普通文字。
[One sentence stating the question clearly]
- A option one
- B option two
Recommended: A (brief rationale)
先调查
- 先调查,再给建议——没有调查,就不要发表意见。
- 基于证据表达;避免无根据的假设。
宿主集成(仅三个接入点)
引用此工作流的内容必须恰好保留以下三个接入点;完整规范仅在此处定义:
- 醒目提示——一行带标记的文字,指出此技能,并说明每轮一个问题 + 多轮直到明确 + 先澄清。建议使用:
⚠️ Follow clarifying-question-discipline (one question per turn; multi-round until clear; clarify first, do not rush to answer).宿主可以添加对应的本地化单行说明;不要在宿主内容中重述完整的决策树规则。 - 入口处说明数量——在每个向用户提问的步骤,说明:本轮只问一个最关键的问题;回答后再问下一个。
- 危险信号——一次倾倒多个问题/未决事项;在澄清期间急于作答。
未在依赖项中内联声明此技能的技能,必须在自身内容中完整写出上述要点(提示 + 数量要求 + 危险信号 + 平台无关措辞)。
评论
支持 Markdown