token-diet — always-on token-efficiency skill for coding agents
token-diet — always-on token-efficiency skill for coding agents
核心判断
token-diet 值得进入 wiki，因为它把“让 coding agent 少废话、少读错上下文、少做不必要工作”包装成一个跨宿主 always-on skill：Claude Code、Codex、Cursor、Windsurf、Cline 都可安装，并通过 SessionStart hook / AGENTS.md / rule files 等常驻入口注入行为约束。它的价值不在于“压缩输出”本身，而在于把 token 预算看成 harness 的可治理资源。
这对用户重要：Hermes / llm-wiki 的每日雷达、代码修改、wiki ingest 都容易被上下文膨胀拖慢；但简单要求“简洁”又可能牺牲证据、测试或原文引用。token-diet README 明确把 guardrails 写成“concision applies to output, never to reasoning / critical tests / verbatim code / errors”，这正好适合作为 llm-wiki 的 token 纪律边界。
机制：输出节食，不是证据节食
README 中最有价值的机制包括：
- always-on 注入：对不同宿主使用会话启动 hook 或常驻上下文文件，让规则默认生效，而不是依赖用户每次提醒。
- 分层节食：回复、文档、计划、注释、测试、代码、上下文读取、工具调用、子代理分别给出不同压缩策略。
- 上下文读取纪律：先搜索再读；只读需要的行；批量读取；不要重复读刚编辑过的文件。
- 工具调用纪律：独立调用批处理；有足够信息就行动；迭代时跑 targeted tests。
- 可调等级：
on/lite/ultra/off，避免同一强度套用所有任务。 - 基准证据：README 报告真实 Sonnet 5 run 中平均约 31% bill 降低、53% output 降低，但这些数据仍需在用户自己的工作负载中验证。
一阶原理是：agent 成本不是只由模型价格决定，也由输出冗余、重复探索、过度测试、无边界工具调用和上下文污染决定。token-diet 把这些行为前移成常驻工作流规则。
与现有 wiki 概念的关系
- 对 Context-Engineering：补充“token budget 是上下文质量的一部分”。少读不是目的，读到最小充分证据才是目的。
- 对 External-Agent-Skills-Design-Patterns：它是跨宿主 skill 的一个样本，说明 core discipline 可以通过不同 host dialect 注入。
- 对 Harness-Engineering：它把成本、工具批处理、测试范围和停止条件纳入 harness contract。
- 对 Agentic-Coding：它提供 coding-agent 的 YAGNI、targeted tests、bounded sub-agent delegation 等执行纪律。
对 Hermes / llm-wiki 的可执行启发
- 日报输出压缩，但保留 receipts：最终报告应少叙事、多列事实；但工具失败、文件路径、验证输出、未入库原因不能省略。
- wiki 页面也要避免 bloat：新增补充应写成机制/启发/边界，而不是把 README 全文摘要一遍；raw 已经保存原文。
- 为 cron 引入“最小充分读取”规则：orient 后先搜索去重，再读候选原文；不要为了覆盖面反复重读低价值页面。
- 不要全局安装外部 token-diet：Hermes 已有全局执行纪律，直接安装外部 always-on skill 可能和现有指令冲突；更适合提炼规则，而不是改变当前 profile。
失败模式与边界
- 节省 token 可能掩盖不确定性：如果报告太短，用户可能看不到哪些来源没读、哪些 API 失败、哪些判断只是 medium confidence。
- 输出节食不等于验证节食：不能因为节省成本就跳过测试、raw hash、index/log、wikilink 检查。
- 跨宿主注入可能冲突：SessionStart hook、AGENTS.md、rule files 可能和 Hermes profile / cron prompt 叠加，导致过约束或规则优先级混乱。
- benchmark 外推有限：README 的节省数据来自作者场景；用户的中文知识库 ingest / 长文综合场景需要单独测量。
深度判断
晋升理由：满足“可复用 workflow + 改进 Hermes / llm-wiki 实践 + skill 生态样本”三项触发。今天只入库设计模式，不建议自动安装，因为 always-on 外部规则会影响所有后续任务，属于高风险 profile 改动。
写入记录
- 2026-07-27 09:07 CST：新增 source 页面，沉淀 token-diet 对 token 预算、always-on skill 注入、上下文读取纪律和 Hermes 报告压缩边界的启发。