Caveman Compress

目的

将自然语言文件（如 CLAUDE.md、todos、preferences）压缩为“原始人语”（caveman-speak），以减少输入 token 数量。压缩后的内容将直接覆盖原文件，同时生成人类可读的备份文件，命名为 .original.md。

触发方式

/caveman:compress ，或当用户要求压缩某份记忆文件时自动触发。

执行流程

1. 本 SKILL.md 与 scripts/ 目录位于同一目录下。请先定位该目录。

2. 执行以下命令：

cd <包含本 SKILL.md 的目录路径> && python3 -m scripts

3. CLI 将执行以下操作：

• 识别文件类型（不消耗 token）
• 调用 Claude 执行压缩
• 校验输出结果（不消耗 token）
• 若出错：仅使用 Claude 进行针对性修复（cherry-pick fix），禁止重新压缩
• 最多重试 2 次
• 若两次重试后仍失败：向用户报告错误，并保持原始文件不变

4. 将结果返回给用户

压缩规则

移除内容

• 冠词：a、an、the
• 填充词：just、really、basically、actually、simply、essentially、generally
• 客套用语：“sure”、“certainly”、“of course”、“happy to”、“I'd recommend”
• 模糊表达（hedging）：“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”

严格保留（完全不可修改）

• 代码块（包括围栏式 ``` 和缩进式代码块）
• 行内代码（backtick content）
• 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” 等引导语，直接陈述动作本身
• 合并语义重复的条目（即用不同措辞表达相同含义的 bullet point）
• 多个示例若体现同一模式，仅保留一个

关键规则：
所有位于 ... 内的内容必须**逐字复制**，严禁任何改动：

• 不得删除注释
• 不得删除空格或换行
• 不得调整行序
• 不得缩短命令
• 不得简化任何内容

行内代码（...）必须**严格保留原样**，反引号内的所有内容均不可修改。

若文件中包含代码块：

• 将代码块视为只读区域
• 仅压缩代码块之外的文本内容
• 不得跨代码块合并相邻段落

示例对比

原文：

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.

压缩后：

Run tests before push to main. Catch bugs early, prevent broken prod deploys.

原文：

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.

压缩后：

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
• 若文件为混合内容（含 prose + code），仅压缩 prose 区域
• 若无法确定某段内容属于代码还是 prose，请保持原样不作处理
• 覆盖原文件前，会先将其备份为 FILE.original.md
• 禁止压缩任何名为 FILE.original.md 的文件（直接跳过）