strategic-compact

name	strategic-compact
description	Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.
origin	ECC

策略性压缩技能 (Strategic Compact Skill)

建议在工作流的战略点手动执行 /compact，而不是依赖随机的自动压缩。

何时激活 (When to Activate)

• 运行接近上下文限制（200K+ token）的长会话时
• 处理多阶段任务（研究 → 规划 → 实现 → 测试）时
• 在同一个会话中切换不相关的任务时
• 完成重大里程碑并开始新工作后
• 当响应变慢或连贯性下降（上下文压力）时

为什么需要策略性压缩？ (Why Strategic Compaction?)

自动压缩会在任意点触发：

• 通常在任务中途触发，导致丢失重要的上下文
• 无法识别逻辑任务边界
• 可能会中断复杂的多步操作

在逻辑边界进行策略性压缩：

• 研究之后，执行之前 — 压缩研究上下文，保留实现计划
• 完成里程碑之后 — 为下一阶段提供清新起点
• 重大上下文切换之前 — 在进入不同任务前清理探索性上下文

工作原理 (How It Works)

suggest-compact.js 脚本在工具预调用（PreToolUse，包括 Edit/Write）时运行，并执行：

1. 跟踪工具调用 — 统计会话中的工具调用次数
2. 阈值检测 — 在达到可配置阈值时提供建议（默认：50 次调用）
3. 定期提醒 — 超过阈值后，每 25 次调用提醒一次

钩子设置 (Hook Setup)

将以下内容添加到你的 ~/.claude/settings.json：

{
  "hooks": {
    "PreToolUse": [