跳转至

SOP — /cost 命令正文口径对齐 BASELINE §2.1(2026-10-07)

1. 背景

~/.trae-cn/commands/cost.md 是 /cost 审查命令的正文,规定取数、四段输出、深挖衔接与判断口径。 其「判断口径」第 4 条仍写「会话首条的未命中量与是否改了 skill 或规则强相关」, 而 docs/BASELINE.md §2.1 已于 2026-10-07 实测证伪该说法(#13:改 user_rules / skill description / hook 脚本后各步 miss 仅 0.1~1.6%,不打断前缀);同节另有多条禁止重犯的结论 (切会话真实代价 ≈0.58 元/次、Hook 阈值「降到 15 万」已作废、思考档位不降等)未进入命令正文。

触发条件:2026-10-07 用户要求「了解当前的最新结论,把 /cost 的逻辑对应修改」。

2. 目标

  1. /cost 的判断口径与 BASELINE §2.1 一致,不再输出与该节冲突的归因;
  2. 新增「已证伪结论」黑名单,禁止提出切会话 / 降 Hook 阈值 / 降思考档位等建议;
  3. 深挖范围设上限,避免逐轮展开全部触发会话导致的上下文成本;
  4. 命令正文自身不超必要长度,不引入与 cost-deep-review 技能的重复描述。

可验证状态:grep 命中四处新增内容;/cost 下次执行时 ③ 评估与 ④ 建议不再出现已证伪表述。

3. 前置条件

  • ~/.trae-cn/commands/ 可写(用户目录,无需提权);
  • 备份目录 cost-command-20261007/backup/.trae-cn/commands/ 已建立;
  • 无需重启 Trae、无需重载服务——命令正文只在被调用时展开。

4. 影响范围

项 内容
对象 单文件 ~/.trae-cn/commands/cost.md(4623 B → 7791 B)
主机 本机(~/Documents/services/token_proxy 所属工作站)
是否停服 否。不改 proxy.py / config.yaml,不重启 token-proxy
窗口期 无。不影响在途流式回答
生效方式 同会话下一次调用 /cost 即生效(命令正文按调用时展开);对其它命令、Hook、skill 无影响
附带成本 命令正文 +3168 B,每次调用多注入约 0.8 k token(命中价计,可忽略)

5. 分步操作

步骤 1:备份

变更前先做可回滚备份,备份成功即视为获得授权(全局规则 C 类「有备份即免确认」)。

TS=$(date +%Y%m%d-%H%M%S)
mkdir -p cost-command-20261007/backup/.trae-cn/commands
cp -p ~/.trae-cn/commands/cost.md \
      "cost-command-20261007/backup/.trae-cn/commands/cost.md.bak.$TS"
md5sum ~/.trae-cn/commands/cost.md "cost-command-20261007/backup/.trae-cn/commands/cost.md.bak.$TS"

预期:两次 md5 一致(实测 771a94c488fc9ec6af6afb306345fc82)。 失败判断:md5 不一致或目录不可写 → 停止,不进入步骤 2。

步骤 2:编辑四处(编辑工具完成,逐处核对)

坑:四处分散在不同小节,逐处 SearchReplace 时先确认 old_str 在该文件内唯一, 否则会改错位置;本轮第二次编辑曾把「阶段性运行」条挤到新节之下,需专门补一次结构归位。

# 位置 改动
2.1 ③ 评估示例 删去已证伪示例「3 次整段失效全部发生在改完规则继续用旧会话之后」,换为「3 次整段失效集中在轮首边界且下一条 hit 回升(一次性重建,非持续失效)」,并加一句禁止使用已证伪说法
2.2 判断口径 ① 新增「成本结构基准」一行(输出 ≈50%、思考占 59~66%、每步 ≈0.0126 元);② 第 4 条改为「与是否重启代理有关、与是否改 skill/规则/hook 无关(已证伪)」;③ 新增「整段失效按 §2.1 归因表对号入座、不再重跑」一行
2.3 新增节 在「判断口径」之后新增「## 已证伪结论(禁止据此提改进建议)」,含 6 行黑名单表 + 「建议的合法落点」一段
2.4 第四步深挖 「有触发项」下补两条:「深挖范围上限(成本 top3 + 持续失效者,其余各写一行结论)」「建议部分须过『已证伪结论』节」

步骤 3:结构核对

diff -u cost-command-20261007/backup/.trae-cn/commands/cost.md.bak.20261007-091141 \
        ~/.trae-cn/commands/cost.md

预期:仅出现上述四处所在区段的差异;「判断口径」的七条 bullet 连续、未被新节隔断; 文件以「建议的合法落点」一段收尾。

6. 验证

grep -c '已证伪结论(禁止据此提改进建议)' ~/.trae-cn/commands/cost.md   # 预期 1
grep -c '成本结构基准' ~/.trae-cn/commands/cost.md                        # 预期 1
grep -c '深挖范围上限' ~/.trae-cn/commands/cost.md                        # 预期 1
grep -n '改了 skill 或规则' ~/.trae-cn/commands/cost.md                   # 预期无输出(旧口径已清除)
wc -c ~/.trae-cn/commands/cost.md                                        # 预期 7791

预期:前三条各为 1,第四条无输出,第五条为 7791 字节。 失败判断:旧口径仍存在 → 回到步骤 2 定位漏改处;字节数差异过大 → 核对是否有意外删除。

端到端验证:下次执行 /cost(当日或次日)时,确认 ③ 评估与 ④ 改进建议中 不出现「切会话省成本」「调低 Hook 阈值」「降思考档位」等已证伪建议。

7. 回滚

备份位置:cost-command-20261007/backup/.trae-cn/commands/,台账见 cost-command-20261007/backup/README.md。

cp cost-command-20261007/backup/.trae-cn/commands/cost.md.bak.20261007-091141 \
   ~/.trae-cn/commands/cost.md
md5sum ~/.trae-cn/commands/cost.md   # 预期 771a94c488fc9ec6af6afb306345fc82

回滚触发:① diff 显示改动超出预期区段;② 命令正文出现语法破损(Markdown 表格断裂、 哨兵标题缺失);③ 下次 /cost 执行报错或输出结构异常。 回滚后验证:md5 与备份一致,且 /cost 恢复正常四段输出。

8. 风险说明

风险 缓解
命令正文变长(+2920 B),每次调用多注入约 0.75 k token 已在第 4 章量化;增量按命中价计,成本可忽略,且换来的是「不再产出已证伪建议」
新节引用 BASELINE §2.1,该节后续若修订会造成两侧漂移 已在正文写明「该节优先于本文件」,冲突时以 BASELINE 为准;§2.1 修订时同步本节
「深挖范围上限」可能漏掉有价值的触发会话 用户点名追问某会话时不受阈值限制(原文保留);且 top3 + 持续失效者的组合覆盖了高成本与真异常两类
判断口径表述被下游误读为「成本无需优化」 已同时给出「建议的合法落点」(输出侧 / 效率侧)与收益估算口径,非「一律不提建议」

附录:交付物清单

文件 说明
SOP.md 本文件
backup/README.md 备份台账
backup/.trae-cn/commands/cost.md.bak.20261007-091141 变更前备份(源路径 ~/.trae-cn/commands/cost.md)

附录 B:同日续办 — 阈值统一与技能补指向(2026-10-07 09:19)

背景:命令正文改造后暴露两处口径不齐,经用户确认「两处统一」并「加一行指向 BASELINE §2.1」。

B1 daily_review.py:整段失效阈值 10000 → 20000

  • 原 MISS_BIG = 10000(注释:与 analyze_prefix_fail.py 口径一致),与自检口径(wrapup.py DEFAULT_MISS_THRESHOLD = 20000)不一致;自检已于 10-07 论证该值(历史 16063 个中段步的 P99 ≈1.0%)。
  • 不改 analyze_prefix_fail.py:它的 10000 是 BASELINE §2.1 归因表 600 条样本的固定口径, 改它会与已发布结论脱钩。已在 daily_review.py 注释中写明两者差异。
  • 效果对比(同一时点):[1] 由 54 条 / 3.861 元 / 17.4% → 31 条 / 3.172 元 / 13.6%。

B2 cost-deep-review/SKILL.md:红线速查补一行

  • 新增(第 93 行):「建议与归因一律以 docs/BASELINE.md §2.1 为准(含 13 条已证伪结论, 该节优先于本技能):禁提『为省成本切会话(≈0.58 元/次)/ 调低 Hook 阈值 / 降思考档位 / 减步数是控成本主杠杆』;『整段失效』按该节归因表对号入座、不重跑归因……」

B3 验证与回滚

./venv/bin/python cost_audit/daily_review.py | grep '整段失效'   # 预期 miss>20,000:31 条
grep -n 'BASELINE.md' .trae/skills/cost-deep-review/SKILL.md     # 预期命中第 93 行

备份与回滚见 backup/README.md 第 2、3 行(md5 5da05a19… / 2562dd21…)。 生效方式:脚本与技能正文均在下次调用即生效,无需重启服务。技能改动对前缀的影响:按 BASELINE §2.1 #13,改 skill 正文不打断前缀(实测各步 miss 0.1~1.6%)。


来源:/home/rain/Documents/services/token_proxy/cost-command-20261007/SOP.md | 最后更新:2026-10-07 09:20(由 build/sync.py 同步,请勿在站点侧修改)