cc-skill-strategic-compact

战略性上下文检查点

在经过验证的阶段之后压缩上下文，同时保留足够持久的信息，以便恢复同一任务。工具调用次数只是一个提醒；它无法衡量上下文质量，也无法决定何时压缩是安全的。

何时使用

当探索已经结束、一个经过测试的里程碑已经落地，或一段很长的对话中包含重复或已过时的推理时使用。不要在一个未解决的 工具 调用、一个未记录的审批决定，或一个尚未捕获确切证据的失败正在进行时进行压缩。

输入与前提条件

• 用户当前的目标、已接受的约束和完成定义。
• 当前分支和源代码修订版本、本地更改、相关产物路径和实际检查结果。
• 正在运行的进程、待处理的 工具 调用、审批或外部阻塞项。
• 宿主支持的上下文压缩机制。本 skill 不假设每个 客户端 中都存在 /compact，也不操作内部上下文文件。

流程

1. 选择一个阶段边界：从发现到实现、从实现到验证，或从一个已完成的批次到下一个批次。首先保留未解决失败的复现步骤。
2. 将任务状态与文件系统和 Git 进行核对。区分已完成、未提交、已计划和失败的工作。
3. 生成下面的检查点。包含恢复所需的确切命令、结果摘要和路径；省略已复制的日志以及不再重要的已丢弃假设。
4. 检查下一个操作是否可执行，以及新的上下文是否会重复一次合并、重复发送一条消息、丢失一个约束或覆盖无关工作。
5. 仅保存到已授权的项目产物中，或在对话中返回检查点。不要自动重写全局记忆或宿主配置。
6. 如果被请求且可用，使用 客户端 支持的压缩命令。恢复时，读取检查点并在继续之前验证可变状态。

检查点模板

Objective and done condition:
User constraints and authorization boundaries:
Source revision, branch and local changes:
Completed outcomes with verification:
Outstanding work and known failures:
Running process/tool identifiers:
Artifacts and exact paths needed next:
Next action, expected result and fallback:

示例

对于一个搜索功能，其源 PR 已合并，但规范同步仍待处理，请保留源合并 SHA、规范 PR 编号和预期的生成文件。仅对实际测试过的修订版本记录测试为已通过。下一个操作是验证规范 PR 和更新后的 main；不是再次合并源 PR。如果浏览器检查仍需要解锁的桌面，请在继续独立代码审查的同时保持该条件可见。

预期结果：下一个上下文恢复未完成的验证，保留无关的本地编辑，并且不会从源合并中声称已发布。

可选的无状态提醒

bash skills/cc-skill-strategic-compact/suggest-compact.sh 50

该辅助工具接受一个观察到的 工具 调用次数和可选阈值（默认 50），并在达到阈值时以及此后的每 25 次调用时打印提醒。COMPACT_TOOL_COUNT 和 COMPACT_THRESHOLD 可以由显式调用方适配器提供。它不存储计数器、不估算 token 使用量，也从不执行压缩。没有计数时它会安静退出。

早期版本会在无关会话之间递增一个共享用户状态计数器。该计数器不再被读取或写入；现有的自定义包装器必须显式传递会话计数。现有状态文件保持不变。本 skill 不安装或编辑 hook。

限制

• 检查点保留的是已记录的证据，而非所有对话细节。当确切字节很重要时，请保留主要产物。
• 计数是由调用方提供的、有界的非负十进制整数；提醒不是上下文容量测量。
• 分支、进程和远程检查可能在检查点之后发生变化。请重新验证它们，而不是将摘要视为当前真相。
• 客户端 上下文管理各不相同。不要通过删除聊天数据库、日志、缓存或项目文件来模拟压缩。