@davidorex/pi-custom-compactor
为Pi编码Agent提供声明式YAML驱动的结构化代码压缩方案。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@davidorex/pi-custom-compactor。 它的用途是：为Pi编码Agent提供声明式YAML驱动的结构化代码压缩方案。 完整的 Skill 内容见：https://321skill.com/skills/davidorex-pi-custom-compactor/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用pi-custom-compactor，以‘review’模式为当前项目准备上下文。” 它会读取项目根目录下的配置YAML，执行多轮提取，优先保留接口定义、架构文档和最近的提交变更，最终生成一个结构清晰、在预算内的摘要，供后续代码评审对话使用。
介绍
该Skill旨在解决AI编码助手（如Pi）在处理大型或复杂代码库时，因上下文长度限制导致信息丢失或效率低下的问题。它通过一个结构化的YAML配置文件，定义多轮提取规则，智能地压缩代码上下文，确保关键信息（如架构、核心逻辑、近期变更）被优先保留，同时管理上下文预算。
使用方式非常直接：用户只需在项目中创建一个YAML配置文件，在其中声明需要提取的文件、目录、关键词以及压缩策略（如“开发模式”侧重近期变更，“评审模式”侧重架构和接口）。然后，在启动Pi编码Agent时，该Skill会根据配置文件自动执行多轮信息提取与压缩，生成一个精简、结构化的上下文摘要供Agent使用。
它非常适合需要Pi等AI助手深度参与中大型项目开发、重构或代码评审的开发者。无论是日常功能开发时需要AI理解复杂模块，还是接手遗留代码库时需要快速理清脉络，这个工具都能显著提升AI助手的理解准确性和代码生成质量。
建议在使用前，花些时间根据项目特点（如框架、主要语言、目录结构）定制YAML配置。初次使用可从预设的工作模式（如dev, review）开始，再逐步调整提取规则。注意，它依赖于项目文件系统的可访问性，对于高度动态或虚拟化的代码环境可能需要适配。
核心特点
其核心在于采用声明式的YAML配置来驱动多轮、结构化的上下文压缩，而非简单的文件拼接或静态规则。它允许用户针对不同工作模式（如开发、评审）定义不同的压缩策略，并支持中间产物持久化，便于调试和复用，提供了更精细的上下文预算控制。
注意事项
不适合用于压缩非文本文件（如图片、二进制文件）或文件路径和结构频繁剧烈变动的项目。
常见问题
这个Skill和直接让AI总结代码有什么区别？
它通过预定义的多轮YAML规则进行系统化提取和压缩，能更稳定、可控地保留关键架构和变更，减少AI直接总结时的随机信息遗漏。
需要编程才能使用吗？
主要需要编写YAML配置文件来定义规则，无需复杂编程，但对项目结构和目标有清晰理解能配置得更好。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/davidorex-pi-custom-compactor/raw/index.md 读取 @davidorex/pi-custom-compactor 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/davidorex-pi-custom-compactor/raw/index.md（查看排版版本）