skill-zipper

自动压缩优化技能文件，提升令牌效率与触发准确率。

已扫描

项目

内容

适合谁

Claude Code 技能开发者、需要优化技能性能的自动化用户

不适合谁

不熟悉技能结构的初学者、希望快速生成新技能而非优化的用户

国内可用性

需网络配置。可能需要网络配置或第三方服务可访问。

安装难度

新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

复制命令安装

openclaw skills install @vincentjiang06/skill-zipper

官方 ZIP下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

第一步：读取技能（所有部分）

确定技能目录路径：若已提供则直接使用；在直接用户模式下向用户询问；在流水线模式中，若路径缺失则视为阶段失败，应上报而非提问。

首先运行 scripts/measure_tokens.py <skill_dir> 并记录以下信息：

description 的字符数与令牌数
始终加载与按需加载的分布情况
架构标记块（Architecture flags）——这些标记指明了哪些部分需要优化

随后逐项阅读，以精细化处理每一部分（不仅限于 SKILL.md）：

SKILL.md —— 必须存在（缺失则停止），**包括其 frontmatter 中的 description**
所有 rules/*.md 与 references/*.md 内容 —— 候选压缩/合并/去重项（参考文件可能重复 SKILL.md 内容）
scripts/、assets/、schemas/ —— 记录其存在情况；仅当标记（过大 / 孤立）或分析指向时才阅读具体内容

输出一行汇总信息：description 大小、始终加载/按需加载总数、架构标记。

第二步：分析各维度

加载 rules/diagnosis-rubric.md 获取初步检查阈值与优先级矩阵；再加载 rules/operation-analysis.md 获取各项操作的信号列表。

依次评估五个操作（压缩 / 封装 / 丰富 / 加固 / 重触发），根据规则文件记录候选项。

第三步：呈现优化计划

加载 rules/plan-template.md，严格按照其中格式渲染计划。结尾附上确认提示，并等待用户输入“go”。

第四步：写入文件

用户确认后，加载 rules/write-procedure.md，遵循三步写入顺序（快照 → 新文件 → SKILL.md）。若用户要求预演（dry-run），则使用该文件中的预演流程。

第五步：验证结果

加载 rules/verification-checklist.md，运行两个校验脚本（无损差异检测 + 令牌影响分析），对所有 LOST / REWRITTEN 行进行分类，并输出完成总结。

无损性规则

重构过程被视为无损，当满足以下条件：

被移除的 SKILL.md 行文在其他位置完全一致地重现，或被明确归类（如 Harden/Retrigger 的重写、Enrich 的提取、计划中列出的已知删除内容）
所有新增的 rules 文件均在 SKILL.md 中被引用
重写内容保持原意不变
diff_lossless.py 返回状态码 0，或所有 LOST / REWRITTEN 行均已分类

若用户要求删除某部分内容但未指定目标位置，应先提议一个合理目的地。若无合适位置，建议保留该部分内容，即使较长——无损性优先于简洁性。

模块加载时机

文件	加载时机
`rules/progressive-disclosure-model.md`	始终加载 —— 定义始终加载与按需加载的划分标准，以及各目录角色；是所有令牌成本分析的前提。
`rules/diagnosis-rubric.md`	第二步开始前加载 —— 提供烟雾测试阈值、各操作信号列表与优先级矩阵。
`rules/operation-analysis.md`	第二步与诊断清单一同加载 —— 各操作候选标准及与模式库的交叉引用。
`rules/encapsulation-patterns.md`	评估封装候选项时加载 —— 好模式（P1-P5）与反模式（A1-A4）清单。
`rules/hardening-patterns.md`	评估加固候选项时加载 —— 模糊→精确重写的模板库（H1-H10）。
`rules/description-quality.md`	执行重触发操作时，或用户提及触发准确率时加载。
`rules/plan-template.md`	第三步开始前加载 —— 精确格式与确认提示。
`rules/write-procedure.md`	第四步开始前加载 —— 写入顺序、预演流程与反模式清单。
`rules/verification-checklist.md`	第五步开始后加载 —— 双层验证（脚本 + 人工）与完成总结格式。
`rules/portability-checklist.md`	技能需在 Claude Code 之外运行、发布前检查，或 frontmatter 发生变更时使用 —— 区分可移植核心与仅 Claude Code 专用字段。

脚本工具

文件	使用方式
`scripts/measure_tokens.py`	`python3 scripts/measure_tokens.py <skill_dir>` —— 按加载策略分组统计行数与令牌数。支持 `--diff <before> <after>` 参数。
`scripts/diff_lossless.py`	`python3 scripts/diff_lossless.py <before> <after>` —— 验证重构是否完整保留原始内容。返回 0 表示完全无损，返回 1 表示存在 LOST/REWRITTEN 内容需分类。

资源文件

文件	用途
`assets/rules-template.md`	新建 rules 文件的模板。复制后填充占位符；提交前移除 HTML 注释。
`assets/skill-md-skeleton.md`	新建 SKILL.md 的骨架文件。在重构需完全重写 SKILL.md 时使用。

@vincentjiang06

已收录 1 个 Skill