# 三段完整编写的 SCRATCH-6 流程

这些是彼此独立的虚构流程，从相同的修改前源码与空笔记开始。步骤标签是顺序标记，不是日志。scratch-fixture.md 完整提供预期缓冲区与笔记；没有真实系统产生这些状态。

## A：听写提供文字；人编辑源码

| 步骤 | 目标与行动 | 故事中的预期可见状态 | 下一决定 |
| --- | --- | --- | --- |
| A0 | 识别源码缓冲区和独立空笔记 | 六行修改前源码；笔记空 | 将源码与笔记分开 |
| A1 | 将插入点放入笔记，口述要求的那一行 | 出现可编辑笔记草稿 | 依赖它之前先检查文字 |
| A2 | 视需要修正或粘贴精确标识符 | 笔记精确为 `replace freeSeats with availableSeats`；源码不变 | 听写只完成了笔记部分 |
| A3 | 手动只选中 L2 声明标识符，输入／粘贴 `availableSeats` | L2 改名；L3 仍为 `freeSeats`；L6 不变 | 源码暂时不完整，不当成已完成 |
| A4 | 手动只选中 L3 引用标识符，输入／粘贴 `availableSeats` | L2／L3 符合预期源码；L6 不变 | 比较完整源码与笔记 |
| A5 | 检查精确的两处标识符 diff 和保留字符串 | 预期源码加预期笔记 | 文字编辑练习完成；没有执行 |

不假定任何听写产品完成过改名。A 的编辑选择由人作出。A3 中间状态刻意不完整，不应误认为最终结果。

## B：配置好的编辑器动作加字面笔记

故事前提：假设有一个命令系统，已针对所选编辑器配置为能选中精确显示的标识符、用精确给定文字替换选区，并在独立笔记中输入字面文字。操作者能在替换前检查目标和选区。这些是声明的场景能力，不是 Talon、IDE、操作系统或已安装命令的事实。本文件给出动作意图，不提供可执行语音语法。

| 步骤 | 预期操作，不是语音口令教程 | 故事中的预期可见状态 | 下一决定 |
| --- | --- | --- | --- |
| B0 | 识别源码缓冲区及其修改前文字 | 六行修改前源码；笔记空 | 确立当前目标 |
| B1 | 用配置好的选择动作选中 L2 的 `freeSeats`；检查选区 | 只选中声明标识符 | 如果无法确立映射／选区，转手动备用路线 |
| B2 | 用配置好的替换，将选区改为 `availableSeats` | 只有 L2 改名；源码暂时不完整 | 选择第二个代码标识符 |
| B3 | 只选中并检查 L3 的 `freeSeats`，再替换为 `availableSeats` | 预期源码；L6 guidance 不变 | 检查完整源码 |
| B4 | 聚焦独立笔记；选择配置中的字面文字输入路线 | 识别出笔记目标，且为空 | 不把笔记句子解释为编辑命令 |
| B5 | 输入精确笔记行并检查 | 预期源码加笔记 `replace freeSeats with availableSeats` | 与共同目标比较 |
| B6 | 检查两处标识符 diff 与保留的 L6 | 与 A 相同的完整文字产物 | 不声称真实命令已执行或表现更好 |

如果 B1 或 B3 选区未知，不假定已发生替换。保留当前缓冲区，用手动选择／打字完成剩余的明确标识符，再与共同目标比较。如果 B2 已发生，L2 保持改名后的状态；不要重新开始盲目全局替换，也不要抹掉笔记。这条回退保留有效任务范围；仅改变输入方式不需要重新申请权限。

N2 的 Talon 源参考记录了不同的文字输入／按键／模式定义，不能确立 B 所需的精确标识符选择或任意已安装编辑器中的语义改名。适配时，应先填写真实能力卡，再将意图变成口令教程。

## C：AI 任务产生候选文字补丁

| 步骤 | 目标与行动 | 故事中的预期状态 | 下一决定 |
| --- | --- | --- | --- |
| C0 | 保留修改前源码与空笔记作为参考 | 两者都未编辑 | 使用完整任务材料 |
| C1 | 在 AI 请求草稿中口述或输入解释；粘贴 delegation-request.txt 中的精确源码、名称与字面笔记 | 完整可检查的请求草稿 | 检查任务含义和精确字符串 |
| C2 | 在预期对话中提交可供比较的请求 | 请求以文字返回补丁／笔记，不操作工作区 | 等待候选，不推断已编辑 |
| C3 | 检查符合 expected-change.patch 和 expected-note.txt 的候选 | 在此编写故事中，候选只改 L2／L3，保留 L6 | 候选本身不是已应用的改动 |
| C4 | 根据固定任务，比较每行 diff 和字面笔记 | 只有两处预期源码标识符；有精确笔记 | 如有需要，手动采用到可丢弃的临时缓冲区 |
| C5 | 将采用后的文字与共同预期源码及笔记比较 | 与 A／B 相同的最终文字产物 | 故事中任务完成；没有运行时／测试声明 |

C3 是编写的预期候选，不是捕获的模型回答。没有调用真实智能体。实际使用时，缺失或多余改动都要回到同一个两处标识符任务。合理的解释不能代替检查补丁。

## 三种具体的错误走向

| 错误走向 | 为什么不符合 SCRATCH-6 | 限定范围的应对 |
| --- | --- | --- |
| 笔记有短语，但没有源码标识符改变 | 听写输入了文字；改名部分未完成 | 手动选择两处明确源码标识符并编辑，或选择配置动作／委派路线 |
| 全局替换将 L6 改为 `replace availableSeats with availableSeats` | 字面 guidance 不是改名目标 | 从固定修改前源码恢复 L6；检查剩余 diff，不进行广泛撤销 |
| 语音动作针对未知选区 | 预期操作未识别接收改动的标识符 | 不发出不确定操作；检查当前缓冲区，使用手动回退 |

如果实际已发出操作、结果却未知，应先检查当前文字再重复。切换输入方式不能证明操作取消，也不会恢复原始缓冲区。