mcpField
C
compress

compress

github.com/juliusbrusseeAgent 工作流115.8k45.8k 次安装3 天前更新
代码仓库

关于 compress

用于压缩 CLAUDE.md 等自然语言记忆文件的技能，同时保留代码和技术细节。它会备份原文件，并在替换前验证压缩结果。

主要功能

  1. 01压缩自然语言文件
  2. 02保留代码和技术细节
  3. 03备份原文件
  4. 04验证结果并重试修正

适用场景

  1. 01减少记忆文件的令牌用量
  2. 02压缩笔记和偏好内容
  3. 03编辑前保留原始副本

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/juliusbrussee/caveman --skill compress

安装后在 Claude Code 中输入/compress确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

scripts/
__init__.py
__main__.py
benchmark.py
cli.py
compress.py
detect.py
validate.py

详细介绍

Caveman Compress

用途

将自然语言文件（CLAUDE.md、待办事项、偏好设置）压缩成洞穴人风格，以减少输入 token。压缩后的版本会覆盖原文件。人类可读的备份保存为 <filename>.original.md。

触发方式

/caveman:compress <filepath>，或用户要求压缩记忆文件时。

流程

  1. 此 SKILL.md 与 scripts/ 位于同一目录。找到该目录。

  2. 运行：

cd <directory_containing_this_SKILL.md> && python3 -m scripts <absolute_filepath>

  1. CLI 将会：
  • 检测文件类型（不消耗 token）
  • 调用 Claude 进行压缩
  • 验证输出（不消耗 token）
  • 如果有错误：用 Claude 精选修复（仅针对性修复，不重新压缩）
  • 最多重试 2 次
  • 如果重试 2 次后仍失败：向用户报告错误，原文件保持不变
  1. 向用户返回结果

压缩规则

删除
  • 冠词：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"——直接说明操作
  • 合并表达相同意思的冗余项目符号
  • 多个示例展示相同模式时，只保留一个

关键规则： ... 中的所有内容都必须原样复制。 不要：

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

行内代码（...）必须原样保留。 不要修改反引号中的任何内容。

如果文件包含代码块：

  • 将代码块视为只读区域
  • 仅压缩代码块以外的文本
  • 不要合并代码块周围的章节

示例

原文：

在将任何更改推送到 main 分支之前，务必始终运行测试套件。这很重要，因为它有助于及早发现错误，并防止有问题的构建部署到生产环境。

压缩后：

推送到 main 前运行测试。及早发现错误，防止有问题的构建部署到生产环境。

原文：

应用采用微服务架构，包含以下组件。API 网关处理所有传入请求，并将其路由到相应服务。身份验证服务负责管理用户会话和 JWT token。

压缩后：

微服务架构。API 网关将所有请求路由到服务。身份验证服务管理用户会话和 JWT token。

边界

  • 仅压缩自然语言文件（.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（跳过该文件）

评论

支持 Markdown