savethetokens

上下文管理器

通过实用且影响显著的工作流和脚本优化上下文用量。

不可妥协的防护原则

1. 将范围严格限定在用户请求内。未经要求，不添加额外功能、页面或遥测。
2. 将 Token 优化视为约束，而非目标。正确性和安全性优先于减少 Token。
3. 未在可比任务上进行前后测量，绝不声称节省了 Token。
4. 如果节省上下文的操作可能降低质量，就保留额外上下文并说明取舍。
5. 绝不为了节省 Token 而降低代码的完整性。 测试、严格配置、安全检查和错误处理不可或缺。通过减少消息冗长来节省 Token，绝不牺牲输出完整性。

运行模式

• Lean Mode（默认）：仅使用轻量级上下文整理；不要创建新的基准测试产物。
• Measurement Mode：仅在用户要求提供证据或百分比时，使用启动就绪度或 A/B 遥测脚本。

Claude Code 消息预算（必需）

1. 进度更新要简短，并按阶段说明。不要逐一叙述每次文件写入。
2. 除非用户要求，否则不要粘贴冗长的命令输出。仅总结关键信号。
3. 不要在代码或输入未改变时重复执行相同命令；如果重试，只需说明一次原因。
4. 如果 /context 显示消息增长异常偏高，则切换到更严格的简洁模式：
   • 减少更新次数
   • 缩短总结
   • 汇总相关编辑后再报告
5. 优先提供一份简洁的最终总结，而不是冗长的过程说明。
6. 运行基准测试时，确保两个变体的行为匹配：
   • 使用相同的停止标准
   • 使用相同的精简策略
   • 使用相同的输出风格（不要只给其中一个变体额外生成冗长报告）

操作手册

1. 用一句话确认目标并锁定范围。
2. 每项任务保持在一个聊天会话中。无关工作要开启新会话。
3. 无需推理时，使用 ! <command> 执行直接 shell 命令。
4. 定期运行 /context。用量达到约 50% 时就进行压缩，不要等到硬性限制。
5. 在运行 /compact 或 /clear 之前，创建包含后续步骤和已修改文件的检查点文件。
6. 保持顶层文档精简；将深入细节移至链接的 docs/*.md。
7. 对代码任务，在最终输出前运行 docs/QUALITY_GATES.md 中的质量检查。
8. 对于节省 Token 的声明，按照 docs/BENCHMARK_PROTOCOL.md 运行匹配的 A/B 测试。
9. 对于 Claude 基准测试，使用 docs/STRICT_BENCHMARK_PROMPT.md 作为会话开场提示词。

快速命令

# Generate execution plan
python ~/.claude/skills/savethetokens/scripts/govern.py --budget 8000

# Generate checkpoint before compact/clear
python ~/.claude/skills/savethetokens/scripts/session_checkpoint.py \
  --task "..." \
  --done "..." \
  --next "..." \
  --context-percent 52 \
  --message-count 36

# Create session hook (Claude Code)
python ~/.claude/skills/savethetokens/scripts/session_hook_generator.py --project .

# Optimize CLAUDE.md
python ~/.claude/skills/savethetokens/scripts/claude_md_optimizer.py --analyze

# Calculate cost savings
python ~/.claude/skills/savethetokens/scripts/cost_calculator.py --developers 5

# Run launch-readiness benchmark with section-wise savings
python ~/.claude/skills/savethetokens/scripts/launch_readiness.py

# Run live A/B telemetry session (auto split control/optimized)
python ~/.claude/skills/savethetokens/scripts/govern.py \
  --input context.json \
  --budget 8000 \
  --experiment-id claude-launch-v1 \
  --variant auto \
  --assignment-key TICKET-123

# Generate measured A/B report from live sessions
python ~/.claude/skills/savethetokens/scripts/ab_telemetry.py \
  --experiment-id claude-launch-v1 \
  --days 14 \
  --required-intents code_generation,debugging,planning,review \
  --min-samples-per-intent 5

# Strict mode: exit 2 if claim gates fail (CI-friendly)
python ~/.claude/skills/savethetokens/scripts/ab_telemetry.py \
  --experiment-id claude-launch-v1 \
  --strict-claim-mode

# Print report JSON to stdout (pipe to jq, etc.)
python ~/.claude/skills/savethetokens/scripts/ab_telemetry.py \
  --experiment-id claude-launch-v1 \
  --json-stdout

# Code-task quality gate checklist (required before final answer)
cat ~/.claude/skills/savethetokens/docs/QUALITY_GATES.md

# Compare two /context snapshots (control vs optimized)
python ~/.claude/skills/savethetokens/scripts/context_snapshot_diff.py \
  --before-file before.txt \
  --after-file after.txt \
  --strict

# Compact watchdog (advisory, safe defaults)
python ~/.claude/skills/savethetokens/scripts/compact_watchdog.py \
  --context-file context_snapshot.txt \
  --require-checkpoint

# Dynamic tool filtering (fail-open recommended)
python ~/.claude/skills/savethetokens/scripts/tool_filter.py \
  --input tools.json \
  --query "..." \
  --fail-open

# Semantic skill selection (recommendation only)
python ~/.claude/skills/savethetokens/scripts/skill_selector.py \
  --query "..."

# External memory store (bounded retrieval)
python ~/.claude/skills/savethetokens/scripts/memory_store.py search \
  --query "..." \
  --for-prompt \
  --top-k 5 \
  --max-chars 1200

# Print lean session prompt template
cat ~/.claude/skills/savethetokens/docs/LEAN_SESSION_PROMPT.md

# Print strict benchmark harness prompt
cat ~/.claude/skills/savethetokens/docs/STRICT_BENCHMARK_PROMPT.md

脚本

脚本	用途
govern.py	主入口 — 执行计划
analyze.py	上下文分析
prune.py	精简至预算范围内（最多 40%）
session_hook_generator.py	会话启动钩子
session_checkpoint.py	保存可用于压缩的会话检查点
claude_md_optimizer.py	优化 CLAUDE.md
quick_ref_generator.py	生成 QUICK_REF.md
tiered_context.py	三层上下文分类
relevance_scorer.py	上下文相关性评分
cost_calculator.py	ROI 追踪
launch_readiness.py	启动基准测试 + 分章节节省报告
ab_telemetry.py	带置信度检查的实时 A/B 遥测报告
context_snapshot_diff.py	检测 /context 快照中的 Token 回归
compact_watchdog.py	为 /compact 和 /clear 决策提供安全建议
tool_filter.py	带故障开放防护的动态工具筛选
skill_selector.py	带置信度门控的语义技能排序
memory_store.py	带有界检索的外部记忆存储
path_filter.py	筛选软件包目录

质量规则

• 绝不精简系统提示词、错误信息和最近的消息
• 最大精简比例：40%（以确保质量）
• 不确定时 → 保留内容
• 宁可超出预算，也不损害质量
• 保持解决方案精简并符合请求要求；避免推测性架构
• 对已修改的部分运行相关测试和检查，或明确说明哪些无法运行

完整性检查清单（令牌紧张时也绝不跳过）

节省令牌应依靠缩短消息和更聪明地利用上下文，而不是牺牲输出质量。完成任何代码任务前，请确认：

1. 严格配置 — 启用可用的最严格编译器／代码检查器设置（例如，在 tsconfig 中设置 "strict": true）。不使用 any 类型，不使用 @ts-ignore，也不使用 @ts-nocheck。
2. 为修改的代码编写测试 — 每个修改过的函数／模块都要有对应测试。最低要求：每个公共函数都要覆盖一个正常路径和一个错误路径。
3. 安全限制 — 对于会循环、递归或处理无界输入的运行时代码，必须设置明确的防护（最大迭代次数、调用深度、步骤限制、超时）。
4. 附带上下文的错误处理 — 错误应包含位置信息（文件、行、范围）和可操作的提示。不得使用空的 catch(e) {} 或 except Exception: pass。
5. 在边界处验证输入 — 验证用户输入、API 响应和文件 I/O。内部代码可以信任内部类型。
6. 安全基础 — 不得存在命令注入、未经清理的模板插值或硬编码密钥。查询应使用参数化方式。
7. 构建通过 — 在宣告完成前运行类型检查／编译／构建。如果无法运行，请说明原因。
8. 说明未验证的内容 — 如果无法执行上述任何检查（没有测试运行器、没有构建脚本等），请在最终摘要中明确列出。

应从这些方面节省令牌：缩短进度更新、批量处理相关编辑、除非有人要求，否则省略命令输出；上下文使用达到 50% 时进行精简。

详细文档（按需阅读）

• EXECUTION_PLANS.md - 计划结构
• PRUNING_STRATEGIES.md - 精简逻辑
• MODEL_SELECTION.md - 模型推荐
• TOKEN_ESTIMATION.md - 令牌计数
• SESSION_PLAYBOOK.md - 实用的精简／重置工作流
• QUALITY_GATES.md - 强制代码质量和声明质量关卡
• BENCHMARK_PROTOCOL.md - 用于公平测量的匹配 A/B 流程
• LEAN_SESSION_PROMPT.md - 可直接粘贴的严格令牌使用规范提示词
• STRICT_BENCHMARK_PROMPT.md - 用于公平 Claude Code A/B 测试的即用型测试框架
• ADVANCED_AUTOMATION.md - 带安全控制的可选高级功能
• LAUNCH_READINESS.md - 经测量的发布基准测试报告
• LIVE_TELEMETRY.md - 实时对照与优化实验报告