mcpField
C
clarifying-question-discipline

clarifying-question-discipline

github.com/fudesign2008Agent 工作流671 次安装1 天前更新
代码仓库

关于 clarifying-question-discipline

供 Agent 工作流使用的决策澄清技能,通过逐轮提问处理未决事项,并要求先达成共识再行动。它强调先调查可查证事实,避免过早给出方案。

主要功能

  1. 01每轮只问一个问题,并可多轮澄清
  2. 02提供推荐选项及简要理由
  3. 03提问前先查找可确认的事实
  4. 04达成共识后再采取行动
  5. 05强调先调查再提出建议

适用场景

  1. 01实施前澄清需求
  2. 02按依赖顺序解决决策
  3. 03提问前调查代码库事实

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/fudesign2008/open-skills --skill clarifying-question-discipline

安装后在 Claude Code 中输入/clarifying-question-discipline确认已加载。

详细介绍

澄清问题规范

内部共享技能。宿主必须在 frontmatter dependencies 中声明此技能,若缺失,则在启动时中止——不得静默回退。

对未决事项坚持不懈地向用户提问,直到达成共识。逐一梳理决策树的每个分支,依次解决依赖关系,让前面的答案重塑后续问题。一次提出多个问题会令人困惑。

硬性规则

  1. 每条消息只问一个问题——等用户回答后再问下一个。多轮进行,直到问题明确;这不是“整个会话只问一个问题”。优先使用口号 每轮一个问题 + 多轮直到明确;不要使用会让人理解为“问完就立即解决”的说法。
  2. 先澄清,后作答——关键未知事项尚未明确时,不要急于给出解决方案、结论或完整答案。只有当用户明确要求跳过进一步澄清时,才可提前继续(为其余事项记录假定的默认值)。
  3. 提供推荐答案——如果存在合理的默认选项,每个问题都应包含一个推荐选项或明确说明默认值,并用一行解释理由。用户可以只回复选项字母(“A”)。
  4. 区分事实与决策——如果某个事实可以在环境中(仓库、引用的文件、此前的消息、工具)查到,就去查;不要占用提问机会。决策由用户作出——逐项询问并等待回答。
  5. 提问前先了解上下文——提出第一个澄清问题之前(以及陷入困境时),先浏览相关文件、文档和近期提交。如果请求涉及多个相互独立的子系统,先帮助拆分范围;不要浪费轮次去细化一个必须拆分的项目。
  6. 共识门槛——除非用户确认你们对已澄清的计划/设计/实现路径达成共识,或明确要求跳过进一步澄清,否则不要采取行动。

无条件适用:此规范始终生效,不取决于是否安装了可选增强技能。

选择下一个问题:优先遵循决策树中的依赖关系;存在多个未决根节点时,优先询问目的 → 约束 → 成功标准。

问题形式(平台无关)

描述意图;由 Agent 选择原生能力——不要硬编码特定平台工具,也不要罗列“平台 X 使用 A,平台 Y 使用 B”。

  • 优先采用结构化单选(一个问题 + 选项 + 推荐答案);如果固定选项会造成虚假的确定性,也可以开放式提问。
  • 如果无法使用结构化界面,则使用普通文字。
[One sentence stating the question clearly]
- A option one
- B option two
Recommended: A (brief rationale)

先调查

  1. 先调查,再给建议——没有调查,就不要发表意见。
  2. 基于证据表达;避免无根据的假设。

宿主集成(仅三个接入点)

引用此工作流的内容必须恰好保留以下三个接入点;完整规范仅在此处定义:

  1. 醒目提示——一行带标记的文字,指出此技能,并说明每轮一个问题 + 多轮直到明确 + 先澄清。建议使用:⚠️ Follow clarifying-question-discipline (one question per turn; multi-round until clear; clarify first, do not rush to answer). 宿主可以添加对应的本地化单行说明;不要在宿主内容中重述完整的决策树规则。
  2. 入口处说明数量——在每个向用户提问的步骤,说明:本轮只问一个最关键的问题;回答后再问下一个。
  3. 危险信号——一次倾倒多个问题/未决事项;在澄清期间急于作答。

未在依赖项中内联声明此技能的技能,必须在自身内容中完整写出上述要点(提示 + 数量要求 + 危险信号 + 平台无关措辞)。

评论

支持 Markdown