SuperAPI AI 工具集

caveman-compress

写作与研究

查看项目

更新于 10-15 23:44

技能介绍

用途:把自然语言记忆文件(CLAUDE.md、todos、偏好设置)压缩成 caveman 风格,减少输入 token。压缩后覆盖原文件,同时保留人类可读备份 <filename>.original.md。

触发方式:使用 /caveman-compress <filepath>,或当用户要求压缩记忆文件时触发。

使用方式:脚本位于与本 SKILL.md 相邻的 scripts/ 目录;若路径不可用,可在 SKILL.md 旁查找 scripts/main.py。在该 SKILL.md 所在目录运行:

python3 -m scripts <absolute_filepath>

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 与链接、文件路径、命令(如 npm install、git commit、docker build)、技术术语、专有名词、日期、版本号、数值、环境变量。代码和反引号内内容严禁修改,如不确定是代码还是散文,保持不动。

结构保留:所有 markdown 标题保持原文,仅压缩正文;保留项目符号层级、编号列表编号、表格结构(压缩单元格文本)、markdown 的 frontmatter/YAML 头。

压缩手法:使用短同义词(big 而非 extensive,fix 而非 implement a solution for,use 而非 utilize);允许使用片段句;去掉 “you should”“make sure to”“remember to”,直接陈述动作;合并表达相同意思的冗余项目;多个示例展示同一模式时只保留一个。

边界:只压缩自然语言文件(.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(跳过)。