Agent skill
strategic-compact
建议在逻辑间隔处手动压缩上下文,以在任务阶段中保留上下文,而非任意的自动压缩。
Install this agent skill to your Project
npx add-skill https://github.com/xu-xiang/everything-claude-code-zh/tree/main/docs/zh-CN/skills/strategic-compact
SKILL.md
战略精简技能
建议在你的工作流程中的战略节点手动执行 /compact,而不是依赖任意的自动精简。
何时激活
- 运行长时间会话,接近上下文限制时(200K+ tokens)
- 处理多阶段任务时(研究 → 规划 → 实施 → 测试)
- 在同一会话中切换不相关的任务时
- 完成一个主要里程碑并开始新工作时
- 当响应变慢或连贯性下降时(上下文压力)
为何采用战略精简?
自动精简会在任意时间点触发:
- 通常在任务中途,丢失重要上下文
- 无法感知逻辑任务边界
- 可能中断复杂的多步骤操作
在逻辑边界进行战略精简:
- 探索之后,执行之前 — 压缩研究上下文,保留实施计划
- 完成里程碑之后 — 为下一阶段重新开始
- 在主要上下文切换之前 — 在开始不同任务前清理探索上下文
工作原理
suggest-compact.js 脚本在 PreToolUse (Edit/Write) 时运行,并且:
- 跟踪工具调用 — 统计会话中的工具调用次数
- 阈值检测 — 在可配置的阈值处建议压缩(默认:50次调用)
- 定期提醒 — 达到阈值后,每25次调用提醒一次
钩子设置
添加到你的 ~/.claude/settings.json:
{
"hooks": {
"PreToolUse": [
{
"matcher": "Edit",
"hooks": [{ "type": "command", "command": "node ~/.claude/skills/strategic-compact/suggest-compact.js" }]
},
{
"matcher": "Write",
"hooks": [{ "type": "command", "command": "node ~/.claude/skills/strategic-compact/suggest-compact.js" }]
}
]
}
}
配置
环境变量:
COMPACT_THRESHOLD— 首次建议前的工具调用次数(默认:50)
压缩决策指南
使用此表来决定何时压缩:
| 阶段转换 | 压缩? | 原因 |
|---|---|---|
| 研究 → 规划 | 是 | 研究上下文很庞大;规划是提炼后的输出 |
| 规划 → 实施 | 是 | 规划已保存在 TodoWrite 或文件中;释放上下文以进行编码 |
| 实施 → 测试 | 可能 | 如果测试引用最近的代码则保留;如果要切换焦点则压缩 |
| 调试 → 下一项功能 | 是 | 调试痕迹会污染不相关工作的上下文 |
| 实施过程中 | 否 | 丢失变量名、文件路径和部分状态代价高昂 |
| 尝试失败的方法之后 | 是 | 在尝试新方法之前,清理掉无效的推理过程 |
压缩后保留的内容
了解哪些内容会保留有助于您自信地进行压缩:
| 保留的内容 | 丢失的内容 |
|---|---|
| CLAUDE.md 指令 | 中间的推理和分析 |
| TodoWrite 任务列表 | 您之前读取过的文件内容 |
记忆文件 (~/.claude/memory/) |
多轮对话的上下文 |
| Git 状态(提交、分支) | 工具调用历史和计数 |
| 磁盘上的文件 | 口头陈述的细微用户偏好 |
最佳实践
- 规划后压缩 — 一旦计划在 TodoWrite 中最终确定,就压缩以重新开始
- 调试后压缩 — 在继续之前,清理错误解决上下文
- 不要在实施过程中压缩 — 为相关更改保留上下文
- 阅读建议 — 钩子告诉您何时,您决定是否
- 压缩前写入 — 在压缩前将重要上下文保存到文件或记忆中
- 使用带摘要的
/compact— 添加自定义消息:/compact Focus on implementing auth middleware next
相关
- 长篇指南 — Token 优化部分
- 记忆持久化钩子 — 用于在压缩后保留状态
continuous-learning技能 — 在会话结束前提取模式
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
investor-materials
创建并更新路演 PPT (Pitch Deck)、单页简介 (One-Pager)、投资者备忘录 (Investor Memo)、加速器申请、财务模型以及融资材料。当用户需要面向投资者的文档、预测、资金用途表、里程碑计划或需要跨多个融资资产保持内部一致性的材料时,请使用此技能。
e2e-testing
Playwright E2E 测试模式、页面对象模型(POM)、配置、CI/CD 集成、产物管理以及不稳定测试(flaky test)策略。
api-design
生产级 API 的 REST API 设计模式,包括资源命名、状态码、分页、过滤、错误响应、版本控制和速率限制。
frontend-patterns
React、Next.js、状态管理(State Management)、性能优化(Performance Optimization)及 UI 最佳实践的前端开发模式。
investor-outreach
Draft cold emails, warm intro blurbs, follow-ups, update emails, and investor communications for fundraising. Use when the user wants outreach to angels, VCs, strategic investors, or accelerators and needs concise, personalized, investor-facing messaging.
verification-loop
为 Claude Code 会话提供的全面验证系统。
Didn't find tool you were looking for?