SuperAPI AI 工具集

token-discipline

智能体与模型

查看项目

更新于 10-15 23:45

技能介绍

Token Discipline 是一套面向 Claude Code 的上下文管理技能,核心思路是把上下文窗口当作预算,只花在思考、决策和最终改动上,而不是文件回显、重复读取、散文式计划和未过滤的工具输出。

用途:在会话运行过长、接近上下文或用量上限、处理大型仓库、进行多日工作或 token 消耗过快时,帮助保持对话成本可控。

主要能力(七项默认习惯):

  1. 带 offset 和 limit 读取文件,不整篇吞下。小于 100 行可整读;100-500 行先用 grep -n 扫结构再读片段;超过 500 行先定位再读窗口。刚编辑过的文件通常不应重读。
  2. 把研究交给子代理,保护主上下文。需要 3 次以上文件读取才能回答的问题应交给 Explore(只读查找)或 general-purpose(多步研究)子代理,由其消耗自身上下文并只返回一段结论,之后不要自己重复搜索。
  3. 长输出要管道过滤。构建和测试用 ... | tail -50,查找类用 ... | head -50,长日志用 ... | tail -200 或先 grep,JSON 用 jq '.field' 提取字段。
  4. 用 TodoWrite 或等价任务跟踪器记录计划,不要把多步计划写成对话散文,避免每轮重复携带。
  5. 每 3-4 轮工具调用写一句检查点摘要,锚定当前状态,便于上下文压缩后冷启动恢复。
  6. 不回显文件内容,读完直接进入分析,grep、git log、find 结果同理。
  7. 利用技能系统本身:技能描述常驻上下文,正文仅在调用时加载,深层操作说明应放入 reference 文件按需加载。

应避免的反模式:编辑后重读、为查一个值 cat 整个配置文件、三轮内反复读同一文件、对可逆操作请求许可、多段式回合末总结、本可并行却串行读取、携带已过时的上下文。

当用户明确表示接近上限时:写一份足够冷启动恢复的检查点摘要,把进行中的细节移入 TodoWrite 或记忆文件,把下一步研究交给子代理,并建议使用 /compact(Claude Code)或以检查点作为开场消息开启新会话。

限制:资料未提供该技能的安装方式、依赖、平台支持范围、收费或价格信息。