One By One

---
name: one-by-one
description: 逐题裁决模式（用户级通用）。仅由用户手动输入 $one-by-one 触发，AI 永不主动激活。触发后本会话禁用弹窗式提问，改为纯文本逐题裁决：一题一讲、一裁一记录、记完再下一题；表达用通俗汉语技术方案语言，禁 AI 黑话。典型触发场景：用户取消了弹窗、看不懂 AI 的提问或解释、要求逐个讨论决策点。
---

# 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 落盘 → 展示记录原文 → 更新总览状态 → 下一题
④ 全部谈完 → 输出本轮裁决总表
```

- 全程禁用弹窗式提问工具（包括运行时的弹窗式提问工具）；一切提问、追问、落点确认都用纯文本。
- 等待裁决时，禁止假定某个选项成立而继续推进相关工作。
- 用户答复含糊 → 允许追问，但追问同样一次只问一件事。
- 用户主动一次裁决了多题 → 尊重，逐条落盘后继续；但 AI 不得主动把多题打包求一次总体同意。
- **假决策处理（三分）**：①上游流程列出的决策点**一律不吞**——AI 论证为唯一解的照样出题，标注「已论证唯一解 + 理由」，用户一句话即可秒批；②AI 在本会话自造的题，讲不出「选 A 和选 B 用户会遇到什么不同」就不出题，在总览表**正文**列一行告知（不得放表下附注）；③「答不出差异」不是吞题理由——那是背景不足，降级为「我没搞懂，请求补背景」。判定标准前后不一致（声称唯一解不占用用户、却又抛唯一解题）视为流程违规。

## 2. 每题结构与表达规范

每题固定四段，总长控制在一屏内：

| 段 | 要求 |
|---|---|
| 背景 | 1–2 句，只讲这道题必需的前情 |
| 分歧点 | 一句话说清到底在选什么 |
| 选项 | 每项一行：做法 + 代价/后果/不可逆性 |
| 推荐 | 明确推荐哪个 + 一两句理由 |

**表达红线**：

- 通俗汉语技术方案语言。面向资深工程师：技术概念不必降维，但必须说人话。
- **表述海拔**：标识符（类名/表名/字段名/方法名）只作锚点（每个论点至多一个），禁贴代码/伪代码，禁逐方法调用链复述。
- **锚定**：会话内部产生的名词（方案名、编号、新标签）默认用户不在场，首次出现必须带一句话锚点（它是什么 + 在哪 + 扮演什么角色）。本模式要求三点：①内部编号（DEC-x、T-x 等）首次引用就地展开，不许要求用户跳转查阅；②任务内新命名的标签/方案名——哪怕字面全由通用技术词构成（如"内容哈希""源指针"）——必须锚定到具体对象：它作用于哪份数据、存在哪、谁消费它；通用技术概念**本身**仍零解释、零降维；③锚点每个至多半句、计入一屏预算，一屏放不下就**拆题**，不砍锚点、不破一屏。
- **代价落地**：选项的代价/后果必须写成用户可感知的结果（会看到什么不同、卡住什么动作）。有可靠依据时给数量级并注明出处；没有依据就写清可感知差异并明确标注「量级未知」，**禁止编造数字**。禁止只给实现层形容词（"写入放大""成本最高"）。
- 禁 AI 自造黑话与八股。示例不穷举，同类都算：赋能、抓手、闭环、颗粒度、链路、心智、底层逻辑、护城河；「首先/其次/再次/综上所述」骨架。
- 精简 ≠ 省略：影响裁决的细节（代价、风险、影响面、不可逆性）一个不漏；不影响裁决的过程叙述全部砍掉。
- 试金石：用户不打开 IDE、不追问，能否直接拍板？不能 → 重写这道题。

## 3. 记录规则（防上下文压缩丢裁决）

**落点优先级**：

1. 当前任务已有 `用户裁决记录.md` → 追加 DEC-x（沿用既有编号序列）
2. 正在编辑的方案/计划文档有「决策记录」节 → 追加该节
3. 都没有 → 新建日期命名的记录文件，落点用纯文本问用户一次

**记录时机**：先记录后推进——记录写进文件并向用户展示原文后，才允许进入下一题。

**自包含要求**：每条记录含背景、选项、裁决、理由（必要时加影响面）。达标标准：压缩上下文后**只重读记录文件**就能完整恢复裁决语义，不依赖会话记忆。

**进度可恢复**：问题总览表随第一条记录一起落盘到同一文件，每裁一题更新状态；会话中断或压缩后凭此恢复进度。

**记录模板**：

```markdown
### DEC-N：{一句话主题}（YYYY-MM-DD）
- 背景：…
- 选项：A …；B …
- 裁决：{选了什么}
- 理由：…
- 影响：{涉及的文件/文档/后续动作，无则省略}
```

## 4. 边界

- 本 skill 不新增任何决策权：该停机问用户的照样停机，该走评审的照走原流程。
- 与 `plan-goal`「决策点禁止打包成一次总体同意」同向，不冲突。
- 给本 skill 加新规则必须经用户裁决（反棘轮纪律）。