rule-agent-efficiency.md 修订史（一修 ~ 十三修）

2026-10-08 从常驻规则 ~/.trae-cn/user_rules/rule-agent-efficiency.md 原文迁出（第 344–397 行）， 原地只留一行指针。

迁出理由：这 7 800 B 是「为什么改」的历史，不是「现在要做什么」；而规则正文每一步都随上下文重放， 历史常驻纯属成本。每条的原因在全局台账 ~/.trae-cn/user_rules/backup/README.md 里也各有一行。

回滚：把本文件内容原样贴回规则原位置即可（迁出前的备份见 ../backup/）。

---

2026-10-01 一修：此前已连续两次漏执行 skill 里的收尾清单——根因是清单只写在按需加载的 skill 正文里，没有触发点、也没有验收方；而 HANDOFF 的更新从不漏，靠的是 Hook 注入 + 规则硬要求。故把结论挪到「必须出现在最终答复里」，让漏执行立刻可见。 2026-10-01 二修：一修只列了五个效率项，「成本」被压缩成「回填」一行， 结果首轮执行就只报效率、把成本丢在一边；且引用了局部窗口的数字冒充整任务。 故拆成效率 / 成本 / 积累三组并列，并锁定取数窗口口径——成本是要被量化、被压缩、 被跨轮对照的，不是顺带一提。 2026-10-02 三修：新增 D 组「工具与子智能体」——用户的两项效率手段（子智能体做上下文隔离、 工具调用合并取数）此前只写在 HANDOFF 与 skill 里，没有验收方：用了没、有没有漏用、 有没有该合并的碎步，全凭自觉。D 组三项均有现成取数——req_shape 的 tool_names 含 Task 可辨子智能体调用，step_profile.py 给出重复读 / 只读组 / 大输出步。 2026-10-02 四修：三修只给了取数与判定，判完不沉淀——MB 里只有「改规则这件事」的变更 样本，没有「逐轮 D 组指标」的可比序列，无法回答"下轮漏用 / DUP 有没有降"。故补「指标回填」 一项，与 C 组同款：D 组判定结果须回填 MB「D 组指标样本」节并追加可比行， 让"判了"必须落成"可比样本"。 2026-10-02 五修：新增「过账响应」——过账此前同款毛病（有约定、无触发点、无验收方）。 现由 SessionStart Hook 到点注入 [过账提醒]，规则要求「注入必回应」， 把过账从「靠人想起来」提升为「到点必提醒 + 必回应」。上限须知：这仍不是自动过账， 决策与执行由人/AI 做；Hook 只解决触发，规则只解决回应，无法强制"做了"。 2026-10-02 六修：B 组此前只有「四段占比」与「输出 TOP3」，三处退化只报编号——① 时间分布 （墙钟 / 步间隔）自 2026-10-01 起 selfcheck 已在输出，却没进 B 组要求，答复里就丢了； ② 未命中只报百分比、无归因；③ 输出只有百分比、看不出思考占多少。故 B 组扩为六项 （并入时间分布 / 未命中归因 / 输出构成，selfcheck 同步补「输出构成」与「未命中 TOP3」两行）， 并新增 E 组「效率手段对照」——把此前只在被追问时才补得出的「功能哪些真用上 / 该用没用」 变成固定 8 条清单的必答项；靠「固定清单（漏项可见）+ 硬门禁（缺失即未完成）+ 机器对账 （自评不得与 step_profile/selfcheck 矛盾）+ 回填样本（可跨轮比）」四重保证默认出现， 不靠追问。 2026-10-06 七修：把自评类条款（收尾自查五组 / HANDOFF 落点自检 / 过账响应 / 歧义先问验收行）由 「每轮逐项必报」改为「无异常一句话，有异常才展开」。动因（用户实测反馈 + MB 样本）： E 组漏用连续 4 轮未降、同一条 LS 根目录违规在规则明令后 10-04 仍复现、D 组 DUP / 只读组恒 0 无信息量， 而每轮自评是净输出成本（输出 = 命中价 200 倍）。展开判据见本节「无异常判据」表。 见 token_proxy rule-selfcheck-20261006/SOP.md。 2026-10-06 八修：删除「歧义先问（硬门禁）」整节（含「开场澄清」验收方），表格「任务范围或验收不清」 行回退为原表述。动因：用户实测几天后判定该机制无用（触发的是"开口先问"，未带来预期确认收益）。 留存见 token_proxy rule-ambiguity-removal-20261006/SOP.md；原机制档案见 rule-ambiguity-20261003/SOP.md。 2026-10-06 九修：可并组口径扩为全覆盖——D 组主口径由「疑似可并组」（连续 ≥3 步且末尾 <2000 B） 改为「未合并块」（连续单工具步 ≥2，不设大小门槛）并新增「已合并率」；「执行方式」表补 「跨轮 / 等待期 / 单命令内批处理」一行。动因：旧口径实测只覆盖约一半可并步（1985/3953），既不认 2 步组（+179 组 / 358 步），又把「末尾结果大」的步骤整段排除——而那恰是最该合并的一类。旧口径 保留为跨轮可比项。实现见 token_proxy cost_audit/step_profile.py；档案见 merge-coverage-20261006/SOP.md。 2026-10-06 十修：动作类型扩为全集并要求全覆盖合并——实测动作不止增删改查：另有 编排（Task/Skill/run_mcp）/ 计划（TodoWrite）/ 等待（CheckCommandStatus/StopCommand）/ 交互（AskUserQuestion）/ 展示（PureShowWidget）等， 约 504 次调用（占工具调用 7.6%）此前既无规则条款、也无分列口径，全落 other；「增（Write）」「删（DeleteFile）」 亦无专项条款。故新增「动作类型 × 合并性」全覆盖矩阵（12 类 + 可合并性 + 强制语），step_profile.py 分列同步 扩为 12 类并给出「可并类合计」（旧 5 类聚合保留可比），另增 merge-guard PreToolUse Hook 做实时提醒。 档案见 token_proxy merge-coverage-all-20261006/SOP.md。 2026-10-07 十一修：收尾自查新增 「任务侧效率」（条件触发）——此前五组（A 效率 / B 成本 / C 积累 / D 工具 / E 手段） 与 selfcheck / wrapup 的口径全部是 agent 侧（步数、token、工具合并、子智能体），规则里出现的"墙钟"指的都是 轮次墙钟（轮内首步→末步）；被测系统自身的执行效率（远端命令数、重复探测数、建连数、任务墙钟） 既无口径、也无验收方。动因：2026-10-07 实测发现 slurm_ins 单次 --dry-run 下发 864 条远端命令、 其中同一主机重复下发的可省 483 条（56%），且 2026-09-30 的连接复用改造因本地副本遮蔽共享库 失效约 3 个月 —— 这两类问题在旧口径下完全不可见。新组只进效率、不进成本（省的是墙钟与目标端资源， 不直接省 token），效率优先、保效率的前提下再谈成本。取数工具： deployment-tool-engineering/references/scripts/remote_cmd_profile.py。 2026-10-09 十二修：瘦身（保约束、删冗余）——用户判定规则「写得很细、很碎」，把正文里的 过程考证、实测样本、历史处置、背景论证删出（如「攒批重启」一格的 380 字实测对照、「为什么」四行、 「上限须知」段、收尾自查的脚本实现细节与空转率实测），语义与约束数不减： 163 行 / 19982 字节 → 121 行 / 12106 字节（约束锚点 26 条全在）。同步改语义一条： 「同一共享服务的多处改动」由强制攒批重启改为可直接重启（不打断对话输出流）——旧顾虑已实测推翻， 「攒批」失去理由。备份与回滚见 ~/.trae-cn/user_rules/backup/README.md。 待办：skill 侧（ops-execution-efficiency 的 SKILL.md、references/optimization-backlog.md、 references/lessons-and-retractions.md、references/execution-playbook.md）仍含旧「攒批重启」表述，待同步。 2026-10-10 十三修：补「外派阈值」一行——《执行方式》表新增「多步探索 / 翻找（≥2 步、且只要结论）→ 优先外派 （ctx-scout / general_purpose_task）；1 步能做完的自己动手」。依据（数据）：tool_timing 显示 10-07~10-10 四天里子智能体占 15% 的调用（ctx-scout 491 / general_purpose_task 332 / spec-planner 83）， 已是常态；而外派在主对话只占 1 步、省掉原本 N 步，且子智能体走 Trae 通道、不进 API 账， 故 2 步以上的活外派即净省。原表述只有「大量检索、多份文件」这种模糊尺度。 同轮：docgen/backup_ledger.py 补 --ledger（user_rules 下台账必须 .txt）与 ALT 备份命名兼容。

---

迁出（2026-10-08 第二批）：收尾自查「2026-10-07 修订」块

2026-10-07 修订：此前「默认一句话」在无异常时不报成本，导致每轮拿不到可比数字； 现改为四项无条件固定输出（时间墙 / 步数均取本轮、费用取本会话累计），异常部分照旧展开。 用户同时明确：旧 selfcheck.py --since/--until 是跨轮窗口、含用户回答时间，不得再用于「时间墙」。 2026-10-07 补：新增第 5 项「guard 拦截」——强制拦截的拒绝 / 原样重放事件落 logs/guard_events.jsonl （append-only，勿删），供后续判断"是否放宽某类强制规则"；误报判据 = 「被拦后原样重发」（action=allow_fp）。 2026-10-07 再改三项：① 五项输出固定为 Markdown 表格（一行文字可读性差）； ② miss 阈值 5000 → 20000（5000 命中中段步 7.6%，20000 = 中段步 P99 ≈1.0%），且只看中段步、轮首不计； ③ 落点自检触发条件由「改过 HANDOFF」改为「HANDOFF ≥10 KB 或 ≥5 轮」——改 HANDOFF 是常态，不该触发自检。

迁出时逐句过了一遍，只保留「现行禁令」，纯历史在此归档：

原块中的句子	处置
「旧 selfcheck.py --since/--until 不得再用于时间墙」	属禁令 → 已并入正文「时间墙」口径行
「五项输出固定为 Markdown 表格」	正文「输出形态」节已有 ✔ 不重复留
「miss 阈值 5000→20000、只看中段步」	正文「miss 检测」节已有 ✔
「guard 拦截落 guard_events.jsonl + allow_fp 误报判据」	正文「收尾自查」表 guard 行已有 ✔
「③ 落点自检触发条件 ≥10 KB」	已过期（现行 11.5 KB）→ 作废，仅在此留痕

迁出动因：该块约 1 KB，混着「为什么改」（历史）与少数「不许这么做」（禁令）。 前者随规则每步重放纯属成本，后者才是必须常驻的部分——故拆开：禁令留正文，历史进本文件。

---

来源：/home/rain/Documents/services/token_proxy/rule-slim-20261008/RULE-CHANGELOG.md ｜ 最后更新：2026-10-10 01:49（由 build/sync.py 同步，请勿在站点侧修改）