# Clarifying

> 共享澄清纪律（grill 式）——沿决策树一次一题逼近共识：事实自查、每个决策带推荐交用户裁决；独立会话以共识摘要 + 三出口收束（转主流程/就此结束/写入 md），不强制产出。被 requirement-analysis 与 quick-fix 引用作提问纪律。当用户想把一个想法/计划/决定逐题磨清楚时独立使用；发散式的思考陪伴用 exploring；已承诺交付的开发工作直接用 requirement-analysis / quick-fix。

- Skill: `flamemida/clarifying-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add flamemida/clarifying-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/flamemida/clarifying-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: flamemida (https://skillmd.com/u/flamemida)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/flamemida/clarifying-2

---


> 语言协议：以对话语言输出——用户显式指定（含平台 `language` 设置）优先，其次跟随用户近期消息语言；均无法判定时默认英语。落盘产物以创建时对话语言为准，增量修改保持产物既有语言。本 skill 中的固定话术是语义模板，用对话语言表达其意，不逐字照搬。

> **外部搜索统一入口**：需要联网检索（资料、库/框架文档、时效信息）时一律先用 anysearch skill（插件内嵌），不可用再降级 WebSearch/WebFetch；降级链与派发词要求见 requirement-analysis 的 references/exploration-patterns.md。

# 澄清纪律（Clarifying）

沿决策树一次一题，把一个想法、计划或决定磨到共识态。**事实是你的活，决策是用户的**——环境能回答的自己查，需要裁决的逐题交给用户，每题附上你的推荐答案。

**纪律定义以本 skill 为准**：requirement-analysis 阶段 3 与 quick-fix 步骤 3 引用本纪律；引用方文本与本文冲突时以本文为准。

相关术语与历史否决按 [context-reuse.md](../requirement-analysis/references/context-reuse.md) 读取并处理冲突；保存仍沿本角色已有出口与授权，不自动建立知识文件。

## 两种角色

| 角色 | 进入方式 | 流程控制权 | 终点 |
|------|---------|-----------|------|
| **被引用模式** | requirement-analysis / quick-fix 进入澄清环节 | 引用方 | 澄清完成，控制权回引用方下一阶段——**不呈现共识摘要与三出口，不发开场声明** |
| **独立会话模式** | 用户直接调用 clarifying | 本 skill | 共识态 → 共识摘要 → 三出口 |

## 核心纪律（两种角色共用）

- **第 0 条·提问前自我披露**——开出第一题之前，先用三小段向用户披露：(a) 我默认了哪些未说出口的假设；(b) 哪些信息一旦提供会显著改变我的答案或方案；(c) 处理这类问题最容易犯什么错。披露基于已完成的探索事实、不编造；披露后才进入逐题澄清，且披露内容随澄清进展可修订。两种角色（独立会话/被引用）均适用
- **未决决策清单**——三段披露后以陈述句显示当前澄清范围的决策名、未决含义及依赖；裁决后移出未决区或标已决，新解锁项追加，显式挂起与已决分开。不把清单变成批量问卷或持久状态机；无疑点不编造事项。被引用时只覆盖该分岔或环节，结束即归还控制权。
- **一次只问一个问题**——等用户答复再问下一个；一次多题会把人淹没
- **选择题优先**——每题尽量给 2-4 个互斥的具体选项，**推荐项放首位并说明理由**。选项只比较同一个决策维度；若一种实际选择能同时落入两项，先修正边界。上游保证范围与下游实现机制等不同维度分列为依赖事项，不混成一组选项（Claude Code 用 `AskUserQuestion`；没有合适选项的开放式问题用对话直接问）
- **事实自查，决策交用户**——能由环境（代码库、文件系统、已有探索产物、工具）回答的事实性问题自己查证，绝不抛给用户；真正需要用户裁决的才带到对话
- **按决策依赖排序**——沿决策树逐支下行，上游决策未定时不问下游问题（如存储选型未定就不问索引设计），避免上游答案变化令下游澄清作废；同级可决项按重要性排序
- **裁决来源**——推荐、沉默和显式挂起不算回答；依赖决定的动作继续等待。可恢复上下文中同范围已有明确决定且无新冲突时直接消费，不能因清单或会话恢复重问。
- **术语挑战**——用户用词模糊或一词多义时，当场提出规范术语请用户裁决，此后全程沿用
- **不编造问题**——没有疑点就明确说"已清晰、无需澄清"并收束；为走流程而提问和带着错误假设前进同样是浪费

## 独立会话模式

<HARD-GATE>
澄清会话只提问与查证，不实施：可以读文件、搜代码，但绝不编写生产代码、不搭脚手架、不执行实施动作。用户在会话中要求直接实施时，引导走出口 1 转入对应主流程 skill。
</HARD-GATE>

1. **开场**：声明「我正在使用 clarifying skill，逐题把这件事磨清楚。」无参数时先问一句"要磨清楚的是什么"。
2. **先探索后开题**：轻量查证（Grep/Glob/Read；Codex 下 `rg` + 文件阅读）能自答的事实，再开第一题。
3. **逐题下行**：按核心纪律沿决策树推进，直至**共识态**——所有决策支线要么已由用户裁决、要么被显式挂起为未决点，无静默假设。
4. **共识摘要**：呈现达成的理解 + 挂起的未决点。
5. **三出口**（提议制，用户选，未选前不落盘任何文件）：
   - **转主流程**——按承诺状态、任务类型与设计空间建议 requirement-analysis（已承诺、有设计空间）、quick-fix（已承诺、无设计空间）或报告通道（已承诺的非开发交付，约定见 requirement-analysis 阶段 1 任务类型检查），经用户确认后进入；共识结论作为下游输入，**已裁决过的问题不在下游重问**
   - **就此结束**——共识留在对话里，零产物
   - **写入 md**——落盘 `.spec-dev/explorations/<topic>.md`（复用 exploring 的落盘约定，结构从轻：问题、关键结论、未决点），改天转正式流程时由 requirement-analysis 阶段 1 作为输入消费

## 与 exploring 的分界

分界是嵌套而非对立：exploring 默认发散，但其开场披露与关键分岔漏斗以被引用模式复用本 skill 纪律；分岔漏斗结束即归还控制权回发散。

| | exploring | clarifying |
|---|-----------|------------|
| 姿态 | **发散**——开支线让用户挑方向 | **收敛**——沿决策树逼近共识 |
| 提问 | 问题自然涌现，不照脚本（关键分岔漏斗期除外） | 逐题下行，覆盖每条支线 |
| 终点 | 可以没有结论 | 共识态（或显式挂起） |
| 典型措辞 | "帮我想想要不要做 X" | "把这个方案逐题问清楚 / grill me" |

两者都不进行正式实施、都可按授权落盘 explorations 笔记、都能交接主流程；exploring 的受控 spike 仅适用于其自身授权实验，不能扩展为 clarifying 独立会话的实施权限——选错了也能中途换，向用户说明即可。

## Codex 规范

- 提问以普通对话消息进行：保持一次一题，每题 2-3 个互斥选项且推荐项在首位，等待用户明确回复
- 自我披露以一条对话消息完成（三段合一条），不拆多条
- 深度推演无 sequential-thinking skill（插件内嵌）可用时降级为回复内分点推演并注明工具降级原因
- 澄清前探索在沙箱禁网时以 `rg` + 文件阅读完成，不依赖 web_search
- 落盘失败（沙箱 read-only）→ 向用户说明并请其自行保存内容
- 独立会话模式轻量，不强制 `update_plan`

## Red Flags

- "推荐很明显，替用户选了吧" → 不得自代；沉默与挂起不是同意，已有明确决定也不重问
- "背景我都懂，直接开问吧" → 披露先行：三段披露是第一题的前置，不可跳过
- "一次多问几个效率高" → 一次一题
- "这个事实问用户最快" → 环境能答的自己查
- "上游还没定，先把下游问了" → 按决策依赖排序
- "澄清完顺手把代码写了" → HARD-GATE，走出口 1
- "共识达成，自动落盘个笔记" → 三出口是提议制，用户没选就不落盘
- "被引用时也走一遍三出口" → 被引用模式的终点是把控制权还给引用方