one-by-one:逐题裁决模式
一句话:用户要裁决多件事时,不弹窗,用通俗汉语一次讲一题,裁一题、落盘一题,再进下一题。
为什么存在:弹窗式提问在 CLI / 桌面 / IDE 插件多端存在遮挡 bug(弹窗盖住上方解释文字,用户被迫盲选);批量抛问题加 AI 式表达会把重点淹没。本 skill 只固定「怎么问、怎么记」;问什么、问几个仍由原流程决定——总控、lightweight-design、adversarial-review、plan-goal 等流程的实质步骤与问题内容不受影响。
0. 触发纪律
- 仅用户输入
/one-by-one触发;AI 永不主动激活(建议在 settings.json 用skillOverrides把本 skill 设为 user-invocable-only 兜底)。 - 触发时先判断入口场景:
| 入口场景 | 第一步动作 |
|---|---|
| 用户刚取消了一个弹窗 | 把弹窗里那批问题按本模式重新提出 |
| 用户看不懂刚才的解释/提问 | 先按 §2 规范把刚才的内容重讲一遍,再进入逐题流程 |
| 预防性触发(裁决还没开始) | 直接按 §1 流程开始 |
- 生效范围:本会话余下全程,直到用户明说退出(如「恢复弹窗」「退出逐题模式」)。
1. 逐题流程
① 问题总览表:编号 + 一句话主题 + 状态(让用户先看到一共几件事)
② 每次只谈一题:按 §2 结构讲完,纯文本等用户裁决
③ 用户裁决 → 立即按 §3 落盘 → 展示记录原文 → 更新总览状态 → 下一题
④ 全部谈完 → 输出本轮裁决总表
- 全程禁用弹窗式提问工具(Claude Code 的
AskUserQuestion);一切提问、追问、落点确认都用纯文本。 - 等待裁决时,禁止假定某个选项成立而继续推进相关工作。
- 用户答复含糊 → 允许追问,但追问同样一次只问一件事。
- 用户主动一次裁决了多题 → 尊重,逐条落盘后继续;但 AI 不得主动把多题打包求一次总体同意。
- 假决策处理(三分):①上游流程列出的决策点一律不吞——AI 论证为唯一解的照样出题,标注「已论证唯一解 + 理由」,用户一句话即可秒批;②AI 在本会话自造的题,讲不出「选 A 和选 B 用户会遇到什么不同」就不出题,在总览表正文列一行告知(不得放表下附注);③「答不出差异」不是吞题理由——那是背景不足,降级为「我没搞懂,请求补背景」。判定标准前后不一致(声称唯一解不占用用户、却又抛唯一解题)视为流程违规。
2. 每题结构与表达规范
每题固定四段,总长控制在一屏内:
| 段 | 要求 |
|---|---|
| 背景 | 1–2 句,只讲这道题必需的前情 |
| 分歧点 | 一句话说清到底在选什么 |
| 选项 | 每项一行:做法 + 代价/后果/不可逆性 |
| 推荐 | 明确推荐哪个 + 一两句理由 |
表达红线:
- 通俗汉语技术方案语言。面向资深工程师:技术概念不必降维,但必须说人话。
- 表述海拔:标识符(类名/表名/字段名/方法名)只作锚点(每个论点至多一个),禁贴代码/伪代码,禁逐方法调用链复述。
- 锚定:会话内部产生的名词(方案名、编号、新标签)默认用户不在场,首次出现必须带一句话锚点(它是什么 + 在哪 + 扮演什么角色)。本模式要求三点:①内部编号(DEC-x、T-x 等)首次引用就地展开,不许要求用户跳转查阅;②任务内新命名的标签/方案名——哪怕字面全由通用技术词构成(如"内容哈希""源指针")——必须锚定到具体对象:它作用于哪份数据、存在哪、谁消费它;通用技术概念本身仍零解释、零降维;③锚点每个至多半句、计入一屏预算,一屏放不下就拆题,不砍锚点、不破一屏。
- 代价落地:选项的代价/后果必须写成用户可感知的结果(会看到什么不同、卡住什么动作)。有可靠依据时给数量级并注明出处;没有依据就写清可感知差异并明确标注「量级未知」,禁止编造数字。禁止只给实现层形容词("写入放大""成本最高")。
- 禁 AI 自造黑话与八股。示例不穷举,同类都算:赋能、抓手、闭环、颗粒度、链路、心智、底层逻辑、护城河;「首先/其次/再次/综上所述」骨架。
- 精简 ≠ 省略:影响裁决的细节(代价、风险、影响面、不可逆性)一个不漏;不影响裁决的过程叙述全部砍掉。
- 试金石:用户不打开 IDE、不追问,能否直接拍板?不能 → 重写这道题。
3. 记录规则(防上下文压缩丢裁决)
落点优先级:
- 当前任务已有
用户裁决记录.md→ 追加 DEC-x(沿用既有编号序列) - 正在编辑的方案/计划文档有「决策记录」节 → 追加该节
- 都没有 → 新建日期命名的记录文件,落点用纯文本问用户一次
记录时机:先记录后推进——记录写进文件并向用户展示原文后,才允许进入下一题。
自包含要求:每条记录含背景、选项、裁决、理由(必要时加影响面)。达标标准:压缩上下文后只重读记录文件就能完整恢复裁决语义,不依赖会话记忆。
进度可恢复:问题总览表随第一条记录一起落盘到同一文件,每裁一题更新状态;会话中断或压缩后凭此恢复进度。
记录模板:
### DEC-N:{一句话主题}(YYYY-MM-DD)
- 背景:…
- 选项:A …;B …
- 裁决:{选了什么}
- 理由:…
- 影响:{涉及的文件/文档/后续动作,无则省略}
4. 边界
- 本 skill 不新增任何决策权:该停机问用户的照样停机,该走评审的照走原流程。
- 与
plan-goal「决策点禁止打包成一次总体同意」同向,不冲突。 - 给本 skill 加新规则必须经用户裁决(反棘轮纪律)。