pi-immediate-compaction
Pi CLI代理即时上下文压缩扩展，主动管理上下文窗口
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-immediate-compaction。 它的用途是：Pi CLI代理即时上下文压缩扩展，主动管理上下文窗口 完整的 Skill 内容见：https://321skill.com/skills/pi-immediate-compaction/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我分析这个项目src目录下的所有代码，梳理核心模块的调用关系'，它会在后台监测上下文窗口占用，达到预设阈值时自动精简冗余历史信息。无需手动触发压缩指令，即可保障长周期任务连续执行，不会因上下文溢出中断。
介绍
使用Pi CLI代理开展长周期任务时，上下文窗口易被冗余对话、临时输出占满，引发响应截断、历史信息丢失、指令执行偏差等问题，传统被动压缩机制往往在窗口耗尽后才启动，容易打断连续工作流。 安装完成后，你可通过配置文件自定义上下文占用的触发阈值，扩展会在后台实时监测窗口占用情况，达到阈值时自动对冗余历史信息、无效临时输出进行精简压缩，全程无需手动触发指令，无感运行不干扰当前操作。 适合经常使用Pi CLI处理批量代码分析、长文档生成、多轮调试等长周期任务的开发者，以及需要长时间与AI代理连续交互的技术研究、运维等相关从业者。 建议根据自身日常任务的平均上下文占用量调整阈值，避免阈值过低导致有效上下文被误压缩，也不要设置过高失去主动管控的意义，首次使用可先采用默认阈值测试适配效果后再微调。
核心特点
不同于同类上下文管理工具被动等待窗口占满后才触发压缩，它支持自定义阈值主动提前执行压缩，且专门适配Pi CLI代理的运行逻辑。
注意事项
仅适配Pi CLI代理运行环境，无法在其他AI CLI工具或IDE内置AI助手中直接使用。
常见问题
如何调整压缩的触发时机？
可修改配置文件中的上下文占用阈值来自定义触发时机。
压缩会丢失重要上下文吗？
默认保留核心指令与关键信息，合理设置阈值可降低误删风险。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-immediate-compaction/raw/index.md 读取 pi-immediate-compaction 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-immediate-compaction/raw/index.md（查看排版版本）