Agent skill · product strategy · affaan-m
strategic-compact
建议在逻辑间隔处手动压缩上下文，以在任务阶段中保留上下文，而非任意的自动压缩。
Why this skill is useful
Adds a script for managing context compression strategically during multi-phase tasks, which the AI wouldn't reliably generate on its own.
What it needs
Requires node installed locally. About 2k tokens when loaded. Last updated 2026-08-06. 238,342 stars on the source repository.
What this skill does
战略精简技能 建议在你的工作流程中的战略节点手动执行 /compact，而不是依赖任意的自动精简。 何时激活 运行长时间会话，接近上下文限制时（200K+ tokens） 处理多阶段任务时（研究 → 规划 → 实施 → 测试） 在同一会话中切换不相关的任务时 完成一个主要里程碑并开始新工作时 当响应变慢或连贯性下降时（上下文压力） 为何采用战略精简？ 自动精简会在任意时间点触发： 通常在任务中途，丢失重要上下文 无法感知逻辑任务边界 可能中断复杂的多步骤操作 在逻辑边界进行战略精简： 探索之后，执行之前 — 压缩研究上下文，保留实施计划 完成里程碑之后 — 为下一阶段重新开始 在主要上下文切换之前 — 在开始不同任务前清理探索上下文 工作原理 suggest-compact.js 脚本在 PreToolUse (Edit/Write) 时运行，并且： 1. 跟踪工具调用 — 统计会话中的工具调用次数 2. 阈值检测 — 在可配置的阈值处建议压缩（默认：50次调用） 3. 定期提醒 — 达到阈值后，每25次调用提醒一次 钩子设置 作为插件安装？ 无需任何设置。插件的 hooks/hooks.json 已经注册了 suggest-compact.js（钩子 ID pre:edit-write:suggest-compact，在 standard 和 strict 钩子配置档中生效）。不要把下面的代码块复制到 ~/.claude/settings.json — 插件安装中不存在 ~/.claude/scripts/，并且重复注册插件钩子会导致双重执行。 如果是手动安装（./install.sh），添加到你的 ~/.claude/settings.json： 配置 环境变量： COMPACTTHRESHOLD — 首次建议前的工具调用次数（默认：50） 压缩决策指南 使用此表来决定何时压缩： 阶段转换 压缩？ 原因 ------------------------ ------ -------------------------------------------------------------------- 研究 → 规划 是 研究上下文很庞大；规划是提炼后的输出 规划 → 实施 是 规划已保存在 TodoWrite 或文件中；释放上下文以进行编码 实施 → 测试 可能 如果测试引用最近的代码则保留；如果要切换焦点则压缩 调试 → 下一项功能 是 调试痕迹会污染不相关工作的上下文 实施过程中 否 丢失变量名、文件路径和部分状态代价高昂 尝试失败的方法之后 是 在尝试新方法之前，清理掉无效的推理过程 压缩后保留的内容 了解哪些内容会保留有助于您自信地进行压缩： 保留的内容 丢失的内容 ---------------------------------------- ---------------------------------------- CLAUDE.md 指令 中间的推理和分析 TodoWrite 任务列表 您之前读取过的文件内容 记忆文件 (~/.claude/memory/) 多轮对话的上下文 Git 状态（提交、分支） 工具调用历史和计数 磁盘上的文件 口头陈述的细微用户偏好 最佳实践 1. 规划后压缩 — 一旦计划在 TodoWrite 中最终确定，就压缩以重新开始 2. 调试后压缩 — 在继续之前，清理错误解决上下文 3. 不要在实施过程中压缩 — 为相关更改保留上下文 4. 阅读建议 — 钩子告诉您何时，您决定是否 5. 压缩前写入 — 在压缩前将重要上下文保存到文件或记忆中 6. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/strategic-compact--b37fb9