用途
Strategic Context Checkpoints（战略上下文检查点）用于在智能体对话到达一个阶段边界时，先准备一个经过验证的检查点，再对上下文进行压缩。其核心目标是：在压缩后仍保留足够持久的信息，使同一任务能够继续执行。工具调用次数只是一个提醒信号，不能用来衡量上下文质量，也不能决定何时压缩是安全的。
何时使用
适合在以下情况使用：探索阶段已经结束；一个经过测试的里程碑已经落地；或长对话中包含重复、过时的推理内容。
不要在以下情况压缩：未解决的中间工具调用；尚未记录的审批决定；失败的确切证据尚未捕获。
输入与前置条件
- 用户当前目标、已接受的约束和完成定义。
- 当前分支与源码版本、本地改动、相关产物路径和实际检查结果。
- 正在运行的进程、待处理的工具调用、审批或外部阻塞项。
- 宿主支持的上下文压缩机制。该技能不假设每个客户端都存在 /compact，也不操作内部上下文文件。
操作步骤
- 选择阶段边界：从发现到实现、从实现到验证，或从一个已完成批次到下一批次。若存在未解决的失败，先保留其复现信息。
- 将任务状态与文件系统和 Git 进行核对，区分已完成、未提交、已计划和失败的工作。
- 生成下方检查点。包含恢复所需的准确命令、结果摘要和路径；省略已复制的日志和不再重要的被丢弃假设。
- 检查下一步动作是否可执行，以及新上下文是否会重复合并、重复发送消息、丢失约束或覆盖无关工作。
- 仅保存到已授权的项目产物中，或在对话中返回检查点。不要自动重写全局记忆或宿主配置。
- 如被请求且可用，使用客户端支持的压缩命令。恢复时，读取检查点并在继续前验证可变状态。
检查点模板
- 目标与完成条件：
- 用户约束与授权边界：
- 源码版本、分支与本地改动：
- 已完成结果及验证：
- 未完成工作与已知失败：
- 运行中的进程/工具标识：
- 下一步所需的产物与准确路径：
- 下一步动作、预期结果与回退方案：
示例
对于一个搜索功能，其源码 PR 已合并但规范同步仍待处理：保留源码合并 SHA、规范 PR 编号和预期生成的文件。仅对实际测试过的版本记录测试为通过。下一步动作是验证规范 PR 和更新后的 main，而不是再次合并源码 PR。如果浏览器检查仍需要解锁的桌面环境，在继续独立代码审查的同时保持该条件可见。
预期结果：下一个上下文继续未完成的验证，保留无关的本地编辑，并且不会因源码合并而声称已发布。
可选的无状态提醒
bash skills/cc-skill-strategic-compact/suggest-compact.sh 50
该辅助脚本接受一个观测到的工具调用次数和可选阈值（默认 50），在达到阈值时以及之后每 25 次调用时打印提醒。COMPACT_TOOL_COUNT 和 COMPACT_THRESHOLD 可由显式调用方适配器提供。它不存储计数器、不估算 token 使用量，也从不执行压缩。没有传入计数时，它会安静退出。
早期版本会在不相关的会话之间递增共享的用户状态计数器。该计数器不再被读取或写入；现有的自定义包装器必须显式传入会话计数。现有状态文件保持不变。该技能不安装或编辑钩子。
限制
- 检查点保留的是已记录的证据，而非全部对话细节。当精确字节很重要时，请保留原始产物。
- 计数由调用方提供，是有界的非负十进制整数；提醒不是上下文容量测量。
- 分支、进程和远程检查可能在检查点之后发生变化。应重新验证，而不是把摘要当作当前事实。
- 各客户端的上下文管理方式不同。不要通过删除聊天数据库、日志、缓存或项目文件来模拟压缩。