将自然语言记忆文件（CLAUDE.md、待办事项、偏好设置等）压缩为“穴居人（caveman）”极简格式，以节省输入 Token。完全保留所有技术干货、代码、URL 及结构。压缩版本将直接覆盖原文件，同时保存一份可读性强的备份为 FILE.original.md。触发词：/caveman-compress <文件路径> 或“压缩记忆文件”。
Caveman Compress
目的
将自然语言文件（CLAUDE.md、待办事项、偏好设置等）压缩为“穴居人”极简表达风格（caveman-speak），从而大幅节省输入 Token。压缩后的内容将直接覆盖原文件，同时会自动保存一份原文件的可读备份至 <filename>.original.md。
触发方式
使用指令 /caveman-compress <filepath>，或者当用户要求“压缩记忆文件”时触发。
执行流程
-
压缩脚本位于
scripts/目录（与本 SKILL.md 同级）。若无法直接访问路径，请在当前 SKILL.md 旁搜索scripts/__main__.py。 -
在包含本 SKILL.md 的目录下运行命令：
python3 -m scripts <绝对文件路径>
- CLI 将会自动执行：
- 识别文件类型（零 Token 消耗）
- 调用 Claude 进行内容压缩
- 校验输出结果（零 Token 消耗）
- 若出现错误：调用 Claude 进行针对性修复（仅修补问题部位，不进行整体重新压缩）
- 最多重试 2 次
- 若重试 2 次后仍失败：向用户报错，并保持原文件不受任何修改
- 将最终结果返回给用户。
压缩规则
删减内容
- 冠词：a, an, the
- 垫场词/修饰词：just, really, basically, actually, simply, essentially, generally
- 客套话："sure", "certainly", "of course", "happy to", "I'd recommend"
- 委婉语气/模糊表达："it might be worth", "you could consider", "it would be good to"
- 冗余句式："in order to" → "to"，"make sure to" → "ensure"，"the reason is because" → "because"
- 废话连接词："however", "furthermore", "additionally", "in addition"
必须精准保留（绝对不可修改）
- 代码块（``` 包裹的代码块及缩进代码）
- 行内代码（
反引号内的内容） - URL 与链接（完整 URL、Markdown 链接）
- 文件路径（
/src/components/...、./config.yaml） - 命令（
npm install、git commit、docker build） - 技术术语（库名称、API 名称、协议、算法）
- 专有名词（项目名、人名、公司名）
- 日期、版本号、数值
- 环境变量（
$HOME、NODE_ENV）
保留结构
- 所有 Markdown 标题（保持标题文本原字不动，仅压缩下方正文）
- 无序列表层级（保持嵌套层级）
- 有序列表（保持序号）
- 表格（精简单元格文本，保持表格结构）
- Markdown 文件中的 Frontmatter/YAML 头信息
压缩策略
- 使用简短同义词：用 "big" 代替 "extensive"，用 "fix" 代替 "implement a solution for"，用 "use" 代替 "utilize"
- 允许使用短语/祈使句：用 "Run tests before commit" 代替 "You should always run tests before committing"
- 删去 "you should"、"make sure to"、"remember to" 等前缀，直接陈述动作
- 合并表达不同但内容重复的列表项
- 若多个示例展示的是同一种模式，仅保留其中一个示例
核心铁律：
任何位于 ... 内部的内容必须原封不动精准复制。
严禁：
- 删除注释
- 删除空格/缩进
- 调整代码行顺序
- 精简指令/命令
- 简化任何代码内容
行内代码（...）必须原封不动精准保留。
严禁修改反引号内部的任何内容。
若文件包含代码块：
- 将代码块视为只读区域
- 仅压缩代码块之外的文本
- 切勿合并代码块前后的段落章节
范例对比
Original（原文）:
You should always make sure to run the test suite before pushing any changes to the main branch. This is important because it helps catch bugs early and prevents broken builds from being deployed to production.
Compressed（压缩后）:
Run tests before push to main. Catch bugs early, prevent broken prod deploys.
Original（原文）:
The application uses a microservices architecture with the following components. The API gateway handles all incoming requests and routes them to the appropriate service. The authentication service is responsible for managing user sessions and JWT tokens.
Compressed（压缩后）:
Microservices architecture. API gateway route all requests to services. Auth service manage user sessions + JWT tokens.
作用边界
- 仅压缩自然语言文件（.md, .txt, .typ, .typst, .tex，以及无拓展名文件）
- 绝对不要修改：.py, .js, .ts, .json, .yaml, .yml, .toml, .env, .lock, .css, .html, .xml, .sql, .sh
- 若文件包含混合内容（正文 + 代码），仅压缩其中的正文部分
- 若无法确定某段内容是代码还是正文，请保持原样不动
- 覆盖写回前，原文件会先备份为 FILE.original.md
- 绝对不要压缩 FILE.original.md（直接跳过）
