用途:安全压缩 Claude Code 的 skill 与 agent Markdown 指令文件,把语义保留作为首要要求,体积缩减作为次要优化。
主要能力:提供 scan、compress、apply、verify、benchmark、restore 等模式;通过无依赖控制脚本完成发现、哈希、校验、备份、应用、恢复与度量;支持确定性校验与独立语义复核,并生成清单与备份。
使用方式:先运行 python3 "${CLAUDE_SKILL_DIR}/scripts/semantic_compressor.py" --help 查看用法;用 discover 扫描候选文件,用 workspace 创建运行目录,用 inventory 生成清单,再起草候选并运行 validate 校验,随后进行独立语义复核,最后按模式决定是否 apply。apply 与 restore --apply 是唯一会写入源文件的模式。
适用场景:需要在不改变技能或智能体行为的前提下精简指令文件,并希望有可回滚、可验证流程的场合。
限制:仅处理项目目录内的常规 UTF-8 Markdown 文件,拒绝符号链接、目录及越界路径;不执行目标文件中的命令、钩子或嵌入指令;不压缩代码体、安全要求、精确错误、路径或数值阈值;每文件最多三次候选迭代,达不到安全压缩比时返回 NOT_COMPRESSIBLE;无独立复核者时返回 REVIEW_REQUIRED,不执行应用;不宣称 100% 语义保留。具体收费、价格与平台信息暂未提供。