mcpField
S
strategic-compact

strategic-compact

github.com/majiayu000Agent workflows28854 installsUpdated 2d ago
Repository

About strategic-compact

strategic-compact is an agent skill for managing context in long sessions. It helps agents decide when to compress, what to retain or externalize, and how to carry forward current task state across logical boundaries.

Key features

  1. 01Compress context at logical boundaries
  2. 02Audit what to keep, externalize, or discard
  3. 03Preserve objectives and a short plan
  4. 04Identify stale or conflicting context
  5. 05Retain verification evidence and next steps

Use cases

  1. 01Transition from research to planning
  2. 02Hand off between distinct tasks
  3. 03Prepare a context summary near window limits
  4. 04Keep implementation state through a phase change

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/majiayu000/spellbook --skill strategic-compact

After installing, type/strategic-compactin Claude Code to confirm it loaded.

Details

From the project README

Strategic Compact

概述

在长会话中，上下文窗口有限且会腐烂。此 skill 指导何时压缩、保留什么、丢弃什么，以及如何把 durable state 外部化。

核心原则：在逻辑边界压缩，不在任意时刻压缩。

Lightweight Context Engineering Guard

在重大阶段开始、handoff、压缩前，用一段短文本执行：

objective:
plan_5_steps_or_less:
context_audit:
- keep:
- externalize:
- discard:
- stale_or_conflicting:
next_boundary:

计划最多 5 步。若无法用 5 步表达，先收敛当前 tranche，不要扩大范围。

压缩决策表

当前阶段下一阶段是否压缩理由
研究/探索规划是探索细节不需要带入规划
规划实现是保留计划，丢弃规划过程
实现步骤 N实现步骤 N+1否实现中途压缩会丢失上下文
实现完成验证可选如果上下文接近上限
验证提交否验证结果需要带入提交
任务 A 完成任务 B 开始是不同任务间压缩

Context Audit

压缩前必须分类：

  • keep: 目标、约束、当前分支、修改文件、关键决策、最新验证结果、下一步
  • externalize: 原始日志、大 diff、宽泛搜索结果、CI 全量输出、长 JSON
  • discard: 已解决错误的完整堆栈、探索过程、失败假设的重复细节
  • stale_or_conflicting: 旧计划、旧 head SHA、过期 CI、与当前文件冲突的记忆

外部化优先使用 repo artifact、checkpoint、issue/PR 描述、run log 或用户指定 scratchpad。不要把 raw session logs 当成当前事实来源。

压缩后保留清单

必须保留：

  • 当前任务目标和约束
  • 不超过 5 步的当前计划
  • 已做的架构决策及理由
  • 已修改的文件列表
  • 未完成的步骤
  • 发现的问题和 TODO
  • VibeGuard 约束（始终保留）
  • fresh verification evidence
  • review gate decision when landing is next

可以丢弃：

  • 文件内容的完整引用（保留路径即可）
  • 搜索过程中的中间结果
  • 已解决的错误的完整堆栈
  • 探索性的代码阅读记录

使用方式

当感觉上下文即将耗尽时：

  1. 判断当前处于哪个阶段
  2. 查压缩决策表，确认是否适合压缩
  3. 执行 context audit，决定 keep / externalize / discard / stale_or_conflicting
  4. 如果适合，按保留清单整理摘要
  5. 执行压缩

反模式

  • 在实现中途压缩 → 丢失关键上下文，导致重复工作
  • 压缩时丢弃约束 → 后续步骤违反规则
  • 不压缩直到溢出 → 被动截断比主动压缩更危险
  • 把旧总结当远端真相 → 需要重新 fetch、检查文件或查询 API

Comments

Markdown supported