mirror of https://github.com/affaan-m/everything-claude-code.git synced 2026-04-11 03:43:30 +08:00

Files

zdoc.app ada4cd75a3 docs(zh-CN): sync Chinese docs with latest upstream changes (#304 )

* docs(zh-CN): sync Chinese docs with latest upstream changes

* update

---------

Co-authored-by: neo <neo.dowithless@gmail.com>

2026-03-02 22:28:27 -08:00

4.5 KiB

Raw Blame History

name, description, origin

name	description	origin
strategic-compact	建议在逻辑间隔处手动压缩上下文，以在任务阶段中保留上下文，而非任意的自动压缩。	ECC

战略精简技能

建议在你的工作流程中的战略节点手动执行 /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

4.5 KiB Raw Blame History Unescape Escape