用途:把自然语言记忆文件(CLAUDE.md、todos、preferences 等)压缩成穴居人式简短表达,减少输入 token。压缩版覆盖原文件,人类可读备份保存为 <filename>.original.md。
触发:/caveman:compress <filepath>,或用户要求压缩记忆文件时。
用法:SKILL.md 与 scripts/ 同目录,找到该目录后运行: cd <directory_containing_this_SKILL.md> && python3 -m scripts <absolute_filepath> CLI 会检测文件类型、调用 Claude 压缩、校验输出;若有错误则用 Claude 定点修复(不重新压缩),最多重试 2 次,然后返回结果。
压缩规则:删除冠词、填充词、客套话、模糊措辞、冗余表达和连接性废话。必须原样保留:代码块、行内代码、URL 与链接、文件路径、命令、技术术语、专有名词、日期、版本号、数值、环境变量。保留结构:所有 markdown 标题、项目符号层级、编号列表、表格结构、frontmatter/YAML 头。压缩时用短同义词、允许片段、去掉“you should”等,合并重复条目,同类示例只留一个。
限制:仅压缩自然语言文件(.md、.txt、无扩展名);绝不修改 .py、.js、.ts、.json、.yaml、.yml、.toml、.env、.lock、.css、.html、.xml、.sql、.sh。混合内容只压缩散文部分;不确定是代码还是散文则保持不变。覆盖前备份为 FILE.original.md,且永不压缩 FILE.original.md。