SOP — 自评类条款改为「无异常一句话，有异常才展开」¶

主题目录：rule-selfcheck-20261006/
变更日期：2026-10-06
变更对象：~/.trae-cn/user_rules/rule-agent-efficiency.md（4 处）、~/.trae-cn/skills/ops-execution-efficiency/SKILL.md（2 处）、~/.trae-cn/skills/writing-handoff/SKILL.md（2 处）
连带修订：docs/HANDOFF.md、references/measured-baselines.md、references/optimization-backlog.md

1. 背景¶

用户实测反馈：10 月以来加的一批「提示词追问 / 自我报告」条款，在对话中感受不到实际用处。核对台账后该反馈成立，且不是主观印象：

总账第五节「待标定」三项（E 组 8 条是否降漏用 / 只读组收益 / ctx-scout 收益）至今零数据； docs/HANDOFF.md 第 3.2 节亦写明「三处收益尚无数字，不以『已上线』冒充『已见效』」。
E 组样本（MB §二十九）：ctx-scout 漏用在 10-02 / 10-03 / 10-04 / 10-05 每轮都出现，无下降趋势；同一条 LS 根目录违规（4 万字符截断）在规则 10-03 明令后，10-04、10-06 仍复现。
D 组样本（MB §二十六）：DUP 恒 0、只读组几乎恒 0——因为问题本来就不存在（步骤级实测重复读取仅 0.12%），等于长期给一个 0 问题做台账。
结构原因：这些条款要求的是「报告我做了什么」，不是「改变我做什么」；验收方式是「答复里出现某小节 / 某一行字」，属自证，无第三方可验。规则自身已记录最硬反例（「歧义先问」2026-10-03 当场失效）。
成本侧：输出 ¥4/百万 = 命中价 200 倍；每轮把 B 组 6 项 + E 组 8 条对照写进答复，是净输出增量。

结论：保留全部取数口径与异常判据（治理能力不减），只把「每轮铺开报告」改为「无异常一句话、有异常才展开」。

2. 目标¶

变更完成后应达到的可验证状态：

自评类四条款默认只输出一句话：收尾自查：无异常（N 步；A–E 五组均未命中） 等。
无异常时不跑 selfcheck、不贴四段占比 / TOP3 / 五组明细、不回填 MB。
命中任一异常判据即展开——判据以「无异常判据」表列出（客观化，不由模型临场自判）。
条款仍进最终答复：无异常时缺那一行结论 = 任务未完成（验收方保留，只换了形态）。

3. 前置条件¶

已确认：该文件进每轮 system prompt，改动须开新会话生效；在旧会话继续会在失效前缀上重复计费（≈0.35 元/次）。
备份可写：主题目录 rule-selfcheck-20261006/backup/ 已建。
无外部依赖、无需权限提升。

4. 影响范围¶

影响面：所有会话的收尾答复形态（全局规则，非单项目）。
是否需停服：否；本变更不触碰 k8s / Slurm / LSF，无在跑作业受影响。
窗口：无限制，随时可做。
代价提示：改动使上游前缀缓存失效；改完立即开新会话只付 ≈¥0.03。

5. 分步操作¶

步骤 1：备份（5 个文件，改前一次做齐）¶

set -euo pipefail
TS=$(date +%Y%m%d-%H%M%S)
D="$HOME/Documents/services/token_proxy/rule-selfcheck-20261006"
mkdir -p "$D/backup/trae-cn/user_rules" \
         "$D/backup/trae-cn/skills/ops-execution-efficiency/references" \
         "$D/backup/docs"
cp "$HOME/.trae-cn/user_rules/rule-agent-efficiency.md"                                   "$D/backup/trae-cn/user_rules/rule-agent-efficiency.md.bak.$TS"
cp "$HOME/.trae-cn/skills/ops-execution-efficiency/SKILL.md"                              "$D/backup/trae-cn/skills/ops-execution-efficiency/SKILL.md.bak.$TS"
cp "$HOME/.trae-cn/skills/ops-execution-efficiency/references/measured-baselines.md"      "$D/backup/trae-cn/skills/ops-execution-efficiency/references/measured-baselines.md.bak.$TS"
cp "$HOME/.trae-cn/skills/ops-execution-efficiency/references/optimization-backlog.md"    "$D/backup/trae-cn/skills/ops-execution-efficiency/references/optimization-backlog.md.bak.$TS"
cp "$HOME/Documents/services/token_proxy/docs/HANDOFF.md"                                 "$D/backup/docs/HANDOFF.md.bak.$TS"
find "$D/backup" -type f -name '*.bak.*' -exec chmod 600 {} +

坑：chmod 逐文件执行，不要 chmod -R 600——目录会失去 x 位，后续 cd 失败，若命令链用 ; 衔接还会在错误目录继续执行（2026-10-02 已踩：误改项目根权限 700 并全库列举，未命中 TOP2 = 21223 B）。

预期：5 个 .bak.* 文件存在、权限 -rw-------。失败判断：任一 cp 非 0 → 停止，不继续编辑（未备份不得执行）。

步骤 2：改写 `rule-agent-efficiency.md` 四处¶

位置	原文	改为
「歧义先问」验收方	「最终答复须含『开场澄清』一行……该行缺失视为任务未完成」	默认写一句 `开场澄清：唯一解读，无需提问`；存在 ≥2 种合理解读时（无论问没问）才展开写明
「收尾自查」节头	「必须输出『收尾自查』小节，按下面五组逐条给出判定」	节名加「默认一句话，有异常才展开」；给出「无异常判据」表（A–E 各组异常判据）；五组详表标注为「展开时才逐项写」
「HANDOFF 落点自检」	改了 HANDOFF 必须报落点自检结论	结论为「全部属现状」时只写一句；仅当需搬移 / 需同步 BASELINE 时才展开
「过账响应」	收到提醒必须包含过账结论	默认一句 `过账：本会话不推进（理由……）`；只有推进了挂账项才展开

坑：四处必须同时改——只改收尾自查而不改落点自检 / 过账，会留下三套并列口径（后两者物理上嵌在收尾自查节内）。

步骤 3：同步 `SKILL.md` 两处¶

ops-execution-efficiency/SKILL.md 的「收尾自查清单」节：引导句改为「默认一句话」，清单标注「异常命中后才逐条过」；「实时消耗自查」节末尾的引用名同步为「收尾自查（硬门禁；默认一句话，有异常才展开）」。理由：该节自称以全局规则为单一源，不同步就出现两处矛盾口径。

另外同步 writing-handoff/SKILL.md 两处：《落点自检》节的「验收」句改为「默认一句话」（结论为「全部属现状」时只写一句，仅需搬移 / 需同步 BASELINE 时才展开）；收尾清单中同一条同步。理由：该 skill 是「落点自检」的判据源，不同步则 skill 与规则对同一动作给出两套验收标准。

步骤 4：登记备份台账¶

写 rule-selfcheck-20261006/backup/README.md，逐条登记 5 个备份（备份文件 / 原路径 / 产生时间 / 原因 / 回滚内容 / 何时可删）。

步骤 5：连带留痕（顺序在最后，使档案反映终态）¶

总账 optimization-backlog.md：「二、已做」追加一行；「四、过账记录」追加一行。
MB measured-baselines.md：按新规则，本任务无异常 → 只写一句话结论，不回填五组样本行（本任务即新形态的第一个执行样本）。
docs/HANDOFF.md：定点修订第 2 节「本轮」、第 3.2「待观察」、第 5 节备份台账，并做落点自检。

6. 验证¶

grep -n "默认一句话\|无异常一句话\|开场澄清：唯一解读\|均视为任务未完成\|七修" \
  ~/.trae-cn/user_rules/rule-agent-efficiency.md
grep -n "无异常一句话\|默认一句话\|异常命中后" ~/.trae-cn/skills/ops-execution-efficiency/SKILL.md
grep -n "默认一句话\|落点自检：全部属现状\|无搬移时只写一句" ~/.trae-cn/skills/writing-handoff/SKILL.md
wc -c ~/Documents/services/token_proxy/docs/HANDOFF.md

预期：规则文件命中 9 处（验收行 2 + 节头 1 + 未完成句 1 + 落点自检 1 + 过账 1 + 七修 3）； SKILL 命中 3 处；HANDOFF ≤ 10240 B。 最终验收须开新会话：跑一个多步任务，检查答复是否默认一句话、以及命中异常时是否展开。

7. 回滚¶

备份位置：rule-selfcheck-20261006/backup/，台账见该目录 README.md。
回滚步骤：

D="$HOME/Documents/services/token_proxy/rule-selfcheck-20261006/backup"
TS=20261006-163921   # 取实际备份时间戳
cp -p "$D/trae-cn/user_rules/rule-agent-efficiency.md.bak.$TS"                                ~/.trae-cn/user_rules/rule-agent-efficiency.md
cp -p "$D/trae-cn/skills/ops-execution-efficiency/SKILL.md.bak.$TS"                           ~/.trae-cn/skills/ops-execution-efficiency/SKILL.md
cp -p "$D/trae-cn/skills/ops-execution-efficiency/references/measured-baselines.md.bak.$TS"   ~/.trae-cn/skills/ops-execution-efficiency/references/measured-baselines.md
cp -p "$D/trae-cn/skills/ops-execution-efficiency/references/optimization-backlog.md.bak.$TS" ~/.trae-cn/skills/ops-execution-efficiency/references/optimization-backlog.md
cp -p "$D/docs/HANDOFF.md.bak.$TS"                                                            ~/Documents/services/token_proxy/docs/HANDOFF.md
cp -p "$D/trae-cn/skills/writing-handoff/SKILL.md.bak.20261006-164201"                        ~/.trae-cn/skills/writing-handoff/SKILL.md

回滚后验证：grep -c "七修" 应为 0；HANDOFF 恢复原大小；随后开新会话生效。

8. 风险说明¶

风险	缓解
「无异常」仍是模型自判 → 该展开的不展开，治理退化	「无异常判据」表把各组异常条件逐条列举（失败请求 / 零输出步 / 返工 / 无理由空档 / 步数超量级 / 单步 >5000 tok / 漏用 / 该用未用），命中即展开，不写「我判断无异常」
样本断档：不回填 MB 后无法跨轮比较	仅无异常时不回填；命中异常仍回填。若日后发现需要基线，改回展开即可（有备份）
新规则尚未生效就被当作已生效引用	本 SOP 与答复显式标注「须开新会话生效」；生效前旧口径仍支配
改 `user_rules` 后旧会话在失效前缀上反复计费	改完立即开新会话

附录：交付物清单¶

交付物	位置
规则变更本体	`~/.trae-cn/user_rules/rule-agent-efficiency.md`
技能同步	`~/.trae-cn/skills/ops-execution-efficiency/SKILL.md`、`~/.trae-cn/skills/writing-handoff/SKILL.md`
本 SOP	`rule-selfcheck-20261006/SOP.md`
备份 + 台账	`rule-selfcheck-20261006/backup/`（含 `README.md`）

不出 RUNBOOK 的理由：本次变更只改规则 / 技能文本，不产生可复用的服务、工具链或脚本等交付物，无日常运行与值班使用场景，属「无交付物留存的一次性动作」。

来源：/home/rain/Documents/services/token_proxy/rule-selfcheck-20261006/SOP.md ｜最后更新：2026-10-06 16:42（由 build/sync.py 同步，请勿在站点侧修改）