SOP：补齐 D 组（工具与子智能体）自我迭代闭环¶

主题：selfcheck-d-loop-20261002 ｜变更类型：C 类（改全局规则，进每轮 system 前缀）备份台账：selfcheck-d-loop-20261002/backup/README.md（规则文件备份见 ~/.trae-cn/user_rules/backup/README.md）相关：~/.trae-cn/user_rules/rule-agent-efficiency.md、 ~/.trae-cn/skills/ops-execution-efficiency/references/{measured-baselines,optimization-backlog}.md、 ~/.trae-cn/skills/ops-execution-efficiency/SKILL.md

1. 背景¶

2026-10-02 三修新增 D 组后，D 组每轮被取数与判定，但判定结果不沉淀： measured-baselines.md（下称 MB）§二十五里只有「改规则这件事」的变更样本，没有「逐轮 D 组指标」（子智能体调用 / 漏用、DUP、只读组、大输出步）的可比序列。后果是无法回答"下一轮漏用 / DUP 有没有降"——这正是 optimization-backlog.md 开头点名的病灶「写下压缩点 ≠ 执行压缩点」的翻版：「判了 ≠ 沉淀成可比样本」。

2. 目标¶

规则 D 组新增「指标回填」项：判定结果须回填 MB「D 组指标样本」节并追加可比行；
MB 新开 §二十六「D 组指标样本」，含可比模板与首个基准样本；
总账同步登记：已做 #18、挂账 #24/#25（两项收益标定）、过账 +1；
SKILL.md 收尾清单补 D 组回填项，口径仍指回规则为单一源（不另立定义）。

可验证状态：规则 / MB / SKILL 三处均出现「D 组指标样本」节且相互一致。

3. 前置条件¶

项	要求
权限	以 `rain` 用户改写 `~/.trae-cn/` 下规则与 skill references，无需 sudo
依赖	MB / optimization-backlog / SKILL.md 均存在且可读写
数据	`logs/usage.jsonl`、`logs/req_shape.jsonl`（D 组取数来源）
意识	规则文件进每轮 system 前缀，改完必须开新会话（旧会话续跑 ≈0.35 元 vs 新会话 ≈0.03 元）

4. 影响范围¶

主机：仅本机（rain），单机。是否停服：否。窗口期：无（对在途会话立即生效，代价是当轮前缀重建）。
组件：全局规则 1 个文件（进每轮前缀）+ skill references 2 个文件 + SKILL.md 1 个文件 + HANDOFF.md。
用户可感变化：此后每轮收尾的 D 组多一行「指标回填」，并把该轮 D 组数字追加进 MB §二十六。

5. 分步操作¶

步骤 1：备份（高危前置）¶

规则文件进每轮前缀，写坏会影响所有后续会话；references 是技能唯一正文来源，改前必须先备份。

cd ~/Documents/services/token_proxy
TS=$(date +%Y%m%d-%H%M%S); D=selfcheck-d-loop-20261002
mkdir -p "$D/backup"
cp -p ~/.trae-cn/skills/ops-execution-efficiency/references/measured-baselines.md   "$D/backup/measured-baselines.md.bak.$TS"
cp -p ~/.trae-cn/skills/ops-execution-efficiency/references/optimization-backlog.md "$D/backup/optimization-backlog.md.bak.$TS"
cp -p ~/.trae-cn/skills/ops-execution-efficiency/SKILL.md                           "$D/backup/SKILL.md.bak.$TS"
cp -p docs/HANDOFF.md                                                               "$D/backup/HANDOFF.md.bak.$TS"
cp -p ~/.trae-cn/user_rules/rule-agent-efficiency.md \
      ~/.trae-cn/user_rules/backup/rule-agent-efficiency.md.bak.$TS
chmod 600 ~/.trae-cn/user_rules/backup/rule-agent-efficiency.md.bak.$TS

预期：$D/backup/ 出现 4 个备份；~/.trae-cn/user_rules/backup/ 出现 1 个（权限 600）。失败判断：目录不存在或任一 cp 返回非 0 → 终止，不要继续编辑。 本次实际备份时间戳：20261002-195412。

步骤 2：改规则 D 组（新增「指标回填」项）¶

文件：~/.trae-cn/user_rules/rule-agent-efficiency.md。两处改动： 1. D 组表格追加一行「指标回填」——回填 MB「D 组指标样本」节、追加可比行（7 列）、与上行对照写明升降、只判不沉淀视为未完成； 2. 文件末尾修订注记追加「2026-10-02 四修」说明。

坑：该文件进每轮前缀——编辑要一次性整体替换，不要在文内留临时标记或分步试探，否则每改一次都可能触发一次前缀重建。

grep -c "指标回填" ~/.trae-cn/user_rules/rule-agent-efficiency.md          # 预期 1
grep -c "2026-10-02 四修" ~/.trae-cn/user_rules/rule-agent-efficiency.md    # 预期 1

预期：两条各命中 1。失败判断：未命中 → 编辑未落盘，重做本步。

步骤 3：MB 新开「D 组指标样本」节¶

文件：.../references/measured-baselines.md，在 §二十五之后新开 §二十六，含三部分： - 口径来源与限制说明（req_shape.tool_names 覆盖率低，子智能体调用以人判读为主、Task 计数仅辅助）； - 表格 7 列：日期 / 任务对象 / 子智能体调用（漏用）/ DUP / 只读组 / 大输出步 / 单轮最多步 / 备注； - 首个基准样本 = 本次变更任务的 D 组数字。

grep -n "^## 二十六" ~/.trae-cn/skills/ops-execution-efficiency/references/measured-baselines.md
tail -c 400 ~/.trae-cn/skills/ops-execution-efficiency/references/measured-baselines.md

预期：命中 §二十六标题；文件尾为新节表格。失败判断：未命中 → 新建节未落盘。

步骤 4：总账与 SKILL.md 同步¶

optimization-backlog.md：挂账节加 #24 / #25（两项收益标定）、已做节加 #18、过账表加一行；
SKILL.md：收尾清单「已回填」项补 D 组回填；正文「三组」改为「四组」。

grep -c "D 组指标样本" ~/.trae-cn/skills/ops-execution-efficiency/references/optimization-backlog.md  # ≥1
grep -c "D 组指标另回填" ~/.trae-cn/skills/ops-execution-efficiency/SKILL.md                           # 1

预期：分别 ≥1 / 1。失败判断：未命中 → 重做本步。

6. 验证¶

# ① 规则含 D 组回填项与四修注记
grep -c "指标回填\|2026-10-02 四修" ~/.trae-cn/user_rules/rule-agent-efficiency.md    # 预期 ≥2
# ② 规则文件完整（首行标题、无截断）
head -1 ~/.trae-cn/user_rules/rule-agent-efficiency.md; wc -l ~/.trae-cn/user_rules/rule-agent-efficiency.md
# ③ MB 新节存在且含可比列
grep -n "D 组指标样本\|单轮最多步" ~/.trae-cn/skills/ops-execution-efficiency/references/measured-baselines.md
# ④ 总账状态一致
grep -n "已做 #18\|#24\|#25" ~/.trae-cn/skills/ops-execution-efficiency/references/optimization-backlog.md

预期：① ≥2；② 首行为 # 执行效率与输出成本约束；③ 命中新节标题与表头；④ 三项均命中。

生效判据：开新会话后，收尾答复的 D 组出现「指标回填」并指向 MB §二十六；只在本会话验证不算生效（规则进每轮前缀，需新会话重新加载）。

7. 回滚¶

备份位置：本目录 backup/（4 个文件）+ ~/.trae-cn/user_rules/backup/（规则文件），明细见 backup/README.md。

cd ~/Documents/services/token_proxy
cp -p selfcheck-d-loop-20261002/backup/measured-baselines.md.bak.20261002-195412 \
      ~/.trae-cn/skills/ops-execution-efficiency/references/measured-baselines.md
cp -p selfcheck-d-loop-20261002/backup/optimization-backlog.md.bak.20261002-195412 \
      ~/.trae-cn/skills/ops-execution-efficiency/references/optimization-backlog.md
cp -p selfcheck-d-loop-20261002/backup/SKILL.md.bak.20261002-195412 \
      ~/.trae-cn/skills/ops-execution-efficiency/SKILL.md
cp -p ~/.trae-cn/user_rules/backup/rule-agent-efficiency.md.bak.20261002-195412 \
      ~/.trae-cn/user_rules/rule-agent-efficiency.md
grep -c "指标回填" ~/.trae-cn/user_rules/rule-agent-efficiency.md    # 预期 0

更轻的回滚：只删规则 D 组「指标回填」一行与 MB §二十六（保留其余改动）。回滚规则后需再开一次新会话（该文件进每轮前缀）。

8. 风险说明¶

风险	缓解
规则文件被写坏（进每轮前缀，影响所有会话）	先备份；改后 grep 校验关键串；异常立即按第 7 章覆盖回滚
三处口径漂移（规则 / MB / SKILL）	口径以规则为单一源；SKILL 只写「指回规则」，不另立定义
回填变负担、收尾变长	回填只 1 行、字段固定 7 列；取数与 selfcheck 同一命令，不增步数
D 组指标口径被高估	MB 新节写明 `tool_names` 覆盖限制；子智能体调用以人判读为主
误以为规则已生效	第 6 章写明「只在本会话验证不算生效」，须开新会话
两项收益仍无数字（挂账 #24/#25）	明确写为「待标定」，不以「已上线」冒充「已见效」

来源：/home/rain/Documents/services/token_proxy/selfcheck-d-loop-20261002/SOP.md ｜最后更新：2026-10-02 19:55（由 build/sync.py 同步，请勿在站点侧修改）