메뉴
带质量保证循环的agent/skill压缩。5阶段迭代流程确保理解保留。 触发词: semantic-compressor, compress skill, optimize agent, reduce tokens, benchmark
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
SOC 직업 분류 기준
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/evanfang0054/cc-system-creator-scripts --skill semantic-compressor명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SKILL.md 표시 중
Mac 系统深度清理和优化工具。使用 Mole (mo 命令) 执行系统清理、磁盘分析、应用卸载、系统优化等任务。 触发场景（当用户提到以下任一内容时使用此 skill）： - 清理 Mac、清理磁盘、释放空间、清理缓存、清理系统 - 卸载应用、删除应用、移除应用及其残留 - 磁盘分析、查看磁盘占用、大文件查找、空间分析 - 系统优化、系统维护、刷新系统、重建缓存 - 系统状态、系统监控、CPU/内存/磁盘监控 - 清理 node_modules、清理构建产物、清理项目依赖 - 清理安装包、删除 dmg/pkg 文件 - Mac 清理工具、类似 CleanMyMac 的功能 - "我的 Mac 太慢了"、"磁盘空间不足"、"电脑卡顿" - 即使没有明确说 "Mole"，只要涉及上述场景就应使用
构建 CLI / command-line 工具时使用，支持两种模式。模式 A 人类 CLI（终端 UX、彩色、交互式提示、进度条、Shell 自动补全），关键词包括 commander / yargs / oclif / typer / click / cobra。模式 B agent-native CLI（JSON envelope / schema 自省 / dry-run 写入安全 / 契约驱动），关键词包括 agent-native CLI、JSON envelope、friction signal。混合场景默认走 B（agent 约束更严格）。只要用户提到 CLI、command-line、命令行工具、agent-native、envelope、schema、friction signal，或要给 agent 提供可调用的 CLI 工具，就应主动使用此 skill。
快速搭建和配置 pnpm monorepo 项目结构，包含 TypeScript、tsup 构建、私有 npm registry 配置。当用户需要"创建 monorepo"、"初始化 monorepo 项目"、"配置 pnpm workspace"、"设置 monorepo 构建"、"monorepo setup"时使用。特别适合需要统一管理多个包、配置构建工具、处理 TypeScript 路径问题的场景。即使用户只是说"帮我搭建项目结构"或"配置构建"，如果涉及多包管理也应该使用此 skill。
| name | semantic-compressor |
| description | 带质量保证循环的agent/skill压缩。5阶段迭代流程确保理解保留。 触发词: semantic-compressor, compress skill, optimize agent, reduce tokens, benchmark |
| user-invocable | true |
压缩代理/技能同时保留理解能力。使用5阶段迭代质量保证流程。
对每个要压缩的文件，按顺序执行所有阶段:
目标: 确认 Claude 正确理解原始文件。
# 从原始文件提取理解
claude -p "阅读并回答:
1. 主要目的是什么?(1句话)
2. 有哪些关键特性?(要点列表)
3. 有哪些命令/工具可用?
4. 应该由哪些触发词激活?
<文件内容>
以结构化的 YAML 格式输出。"
将输出保存为 <name>.original-understanding.yaml
目标: 应用压缩规则创建压缩版本。
⚠️ 必须保留检查清单 (67%的文件因遗漏这些需要迭代)
压缩之前，从原始文件提取并列出:
□ 所有触发词(每个关键词都必须保留)
□ 所有命令(每个命令都必须列出)
□ 所有工具(每个工具都必须列出)
□ 所有支持的格式/类型(文件格式、输出格式、协议)
□ 所有功能类别(功能不能省略)
□ 所有数据库名称/语言名称(特定名称不能用"等"替代)
压缩规则:
针对描述(frontmatter):
- 移除: "此技能/代理提供..."、"全面的"、"高级的"
- 移除: "在...时使用"、"旨在..."、"使用户能够"
- 保留: 所有触发关键词、文件扩展名、动作动词
- 格式: [目的 <15词]。[特性列表]。触发词: [关键词]
- 目标: 3:1 比例
针对正文内容:
- 段落 → 单句
- 冗长的列表 → 简洁的要点
- 多个示例 → 最佳单个示例
- 保留: 代码块、表格(压缩)、命令
- ⚠️ 永远不要使用"等"、"以及更多"、"例如" - 列出所有项目
- 目标: 2:1 比例
针对代理:
- 描述: 最多1-2句话
- 工具: 列出所有，不加描述
- 流程: 编号单行
- 输出: 仅模板
- 目标: 2:1 比例
阶段2检查清单(压缩前验证)
在编写压缩版本之前，验证:
✓ 原始文件中的每个触发词都出现在压缩版本中
✓ 原始文件中的每个命令都出现在压缩版本中
✓ 原始文件中的每个工具都出现在压缩版本中
✓ 每个功能类别都被提及(可以简短)
✓ 所有特定名称(数据库、语言、格式)都已列出
将压缩版本写入 <name>.compressed.md
目标: 确认 Claude 正确理解压缩版本。
# 从压缩版本提取理解
claude -p "阅读并回答:
1. 主要目的是什么?(1句话)
2. 有哪些关键特性?(要点列表)
3. 有哪些命令/工具可用?
4. 应该由哪些触发词激活?
<压缩内容>
以结构化的 YAML 格式输出。"
将输出保存为 <name>.compressed-understanding.yaml
目标: 比较原始理解与压缩理解。
claude -p "比较这两个理解提取。
原始:
<original-understanding.yaml>
压缩:
<compressed-understanding.yaml>
问题:
1. 目的是否相同?(是/否)
2. 是否保留了所有关键特性?(列出任何遗漏的)
3. 是否保留了所有命令/工具?(列出任何遗漏的)
4. 是否保留了所有触发词?(列出任何遗漏的)
5. 总体: 通过 或 需要改进?
如果需要改进，指定需要添加回什么。"
决策:
目标: 生成最终比较报告。
## <name>
| 指标 | 原始 | 压缩 | 比例 |
|--------|----------|------------|-------|
| 行数 | X | Y | X:Y |
| Token(估算) | X | Y | X:Y |
### 理解比较
- 目的: ✓ 已保留
- 特性: ✓ 全部保留 / × 遗漏: [列表]
- 命令: ✓ 全部保留 / × 遗漏: [列表]
- 触发词: ✓ 全部保留 / × 遗漏: [列表]
### 质量: 通过 ✓ / 失败 ×
| 命令 | 操作 |
|---|---|
/semantic-compressor | 自动扫描项目 .claude/skills/ 和 .claude/agents/，压缩所有 |
/semantic-compressor <file> | 对单个文件运行5阶段循环 |
/semantic-compressor benchmark | 对所有示例运行5阶段循环 |
/semantic-compressor verify <file> | 仅阶段1+3(不压缩) |
运行无参数的 /semantic-compressor 时:
# 查找项目中的所有技能和代理文件
find .claude/skills -name "*.md" -o -name "SKILL.md"
find .claude/agents -name "*.md"
# 在任何更改之前创建时间戳备份
BACKUP_DIR=".claude/backups/$(date +%Y%m%d_%H%M%S)"
mkdir -p "$BACKUP_DIR"
cp -r .claude/skills "$BACKUP_DIR/"
cp -r .claude/agents "$BACKUP_DIR/"
echo "✓ 备份已创建: $BACKUP_DIR"
对每个发现的文件:
# 已压缩 注释)# 由 semantic-compressor 在 <日期> 压缩 头部## 压缩报告
| 文件 | 原始 | 压缩 | 比例 | 迭代次数 | 状态 |
|------|----------|------------|-------|------------|--------|
| skill-a.md | 500 | 120 | 4.2:1 | 1 | ✓ 通过 |
| agent-b.md | 300 | 80 | 3.8:1 | 2 | ✓ 通过 |
总计: 压缩了 X 个文件，节省了 Y 个 token
备份: .claude/backups/YYYYMMDD_HHMMSS/
位于 .claude/skills/semantic-compressor/samples/:
samples/
├── skills/
│ ├── verbose/ # 原始冗长版本
│ └── compressed/ # 压缩版本
└── agents/
├── verbose/ # 原始冗长版本
└── compressed/ # 压缩版本
| 类型 | 最小比例 | 最大信息丢失 |
|---|---|---|
| 技能描述 | 2.5:1 | 0% 触发词 |
| 技能正文 | 2:1 | 0% 命令 |
| 代理 | 2:1 | 0% 工具 |
如果比例 < 阈值 或 信息丢失 > 0%，标记为需要改进。