| name | skill-optimizer |
| version | 1.0.0 |
| description | Skill Token 优化器。自动审计任意 SKILL.md 的 token 效率， 识别可剥离内容、生成优化方案、执行瘦身改造。 基于 STOM 方法论（三层信息架构 L1/L2/L3）。 触发词：skill优化、token优化、Skill瘦身、SKILL.md审计、 skill audit、skill analyzer、token分析、Skill过大、 减少token消耗、优化Skill、审计Skill、skill optimizer
|
| complexity | ⭐⭐ |
| tools | ["read_file","write_to_file","replace_in_file","list_dir","execute_command"] |
| references | [{"path":"references/audit-report-template.md","desc":"审计报告输出模板"},{"path":"references/migration-checklist.md","desc":"内容迁移操作 checklist"}] |
Skill Optimizer — STOM 自动化引擎
定位：对任意 SKILL.md 执行诊断→设计→实施的自动化优化工具。
方法论：基于 skill-creation-guide.md 中定义的 STOM v2.0 方法论。
适用场景
| 场景 | 示例 |
|---|
| 审计单个 Skill | "审计一下 tushare-data 的 token 效率" |
| 全量批量审计 | "审计所有 Skills，按大小排序" |
| 执行优化改造 | "把 harmonyos-app-dev 瘦身到 350 行以内" |
| 新 Skill 预检 | "我要新建一个 Skill，先帮我规划结构" |
| 健康检查 | "我的 Skills 有没有超标的？" |
不适用：修改 Skill 的业务逻辑（只管 token 效率，不管功能正确性）、创建新 Skill 的业务内容。
核心工作流
工作流 A：单个 Skill 审计（Audit）
输入：skill_name 或 SKILL.md 路径
Step 1: 读取目标 SKILL.md → 统计行数/大小/section分布
Step 2: 逐 section 分析：
- 标记 L1(保留) / L2应移 / L3应删
- 识别表格压缩机会
- 识别重复内容
- 检测引用链风险
Step 3: 计算：
- 当前 token 估算 (行数 × 25 tokens/行)
- 优化后预估
- 节省比例
- 风险评级（低/中/高）
Step 4: 输出审计报告（见 report template）
工作流 B：全量审计（Batch Audit）
输入：--all 或 skills 目录路径
Step 1: 遍历所有 */SKILL.md → 统计行数+大小
Step 2: 排序（按行数降序）→ 标记超标项（>350行或>15KB）
Step 3: 对每个超标项执行「工作流A」的 Step 1-3（简化版）
Step 4: 汇总为全局报告：
- 总量统计
- TOP 10 最大 Skill
- 超标清单 + 各自优化建议
- 总节省潜力估算
工作流 C：执行优化（Optimize）
输入：skill_name + 审计报告（或 --auto 从头跑）
前置确认：
⚠️ 此操作将修改 SKILL.md 并创建 references/ 文件！
确认后继续：
Step 1: 运行审计（工作流A）→ 得到优化方案
Step 2: 创建 references/ 目录（如不存在）
Step 3: 将标记为 L2 的内容写入 references/ 子文件
Step 4: 在 SKILL.md 中替换为引用指针
Step 5: 插入「复杂任务检测」条件触发区块
Step 6: 更新 YAML frontmatter:
- version minor +1
- 添加 references 列表
Step 7: 验证：
- 新行数 ≤ 350？
- 引用指针指向的文件确实存在？
- 无引用链？
Step 8: 输出前后对比报告
审计维度与评分标准
维度 1：规模合规性（权重 30%）
| 等级 | 行数 | 大小 | 评分 |
|---|
| 🟢 优秀 | ≤ 250 行 | ≤ 10 KB | 10/10 |
| 🟡 合格 | 251-350 行 | 10-15 KB | 7/10 |
| 🟠 轻微超标 | 351-500 行 | 15-22 KB | 4/10 |
| 🔴 严重超标 | > 500 行 | > 22 KB | 1/10 |
维度 2：信息密度（权重 25%）
检测指标：
- 表格占比（表格行数 / 总行数）：>40% → 高密度
- Checklist 使用频率：有 checklist → 加分
- 平均段落长度：<5 行/段 → 密集
- 是否有大段纯文本（>15行连续段落）：有 → 扣分
评分：10（高密）~ 2（低密）
维度 3：分层合理性（权重 25%）
检测指标：
- L2 内容是否已移至 references/？是 → 加分
- 是否存在"参考型"内容留在 L1？有 → 扣分
- 引用指针是否清晰？模糊/缺失 → 扣分
- 是否有条件触发式的复杂任务检测？有 → 加分
评分：10（分层合理）~ 2（混乱）
维度 4：架构健康度（权重 20%）
检测指标：
- YAML frontmatter 是否完整？（name/version/description/references）
- 是否存在引用链风险？
- 踩坑经验区是否干净？
- 版本号是否合理？
评分：10（健康）~ 2（有问题）
综合评分
总分 = D1×0.30 + D2×0.25 + D3×0.25 + D4×0.20
等级划分：
9.0-10 🏆 Gold → 无需优化
7.0-8.9 ✅ Silver → 小改即可
5.0-6.9 ⚠️ Bronze → 建议优化
<5.0 🔴 Fail → 必须优化
Section 分类指南（审计时用）
对 SKILL.md 中每个 ## 或 ### section 做分类：
| Section 特征 | 推荐分类 | 典型例子 |
|---|
| 包含接口/参数映射表 | L1 保留 | 意图→接口速查表 |
| 短 checklist（<20 行） | L1 保留 | 环境校验、输入规范 |
| 核心 3-7 条原则 | L1 保留 | 最佳实践 |
| 完整工作流模板（每步展开） | L2 移出 | 9 个任务模板详情 |
| 示例代码/对话（>10 行） | L2 移出 | examples |
| 详细错误处理矩阵 | L2 移出 | detailed-rules |
| FAQ 列表 | L2 移出 或删除 | faq |
| 完整 API 参数说明 | L3 外部/不存 | api-docs |
输出规范
审计报告格式
# Skill 审计报告：{skill_name}
## 基本信息
| 项目 | 值 |
|------|-----|
| 文件路径 | ... |
| 当前版本 | ... |
| 行数 | xxx / 350 (xx%) |
| 大小 | xx.x KB / 15 KB (xx%) |
| Section 数 | x 个 |
## 评分卡
| 维度 | 得分 | 权重 | 加权分 |
|------|------|------|--------|
| 规模合规 | x/10 | 30% | x |
| 信息密度 | x/10 | 25% | x |
| 分层合理 | x/10 | 25% | x |
| 架构健康 | x/10 | 20% | x |
| **综合** | | | **x/10 🏆/✅/⚠️/🔴** |
## 问题清单
| # | 类型 | 位置 | 说明 | 建议 |
|---|------|------|------|------|
| 1 | 超标 | L50-200 | 工作流模板占 150 行 | 移至 references/workflow-templates.md |
| ...
## 优化方案
### 建议移至 references/ 的内容（按优先级）
1. [ ] ...
2. [ ] ...
### 可压缩的内容
1. [ ] ...
### 预估效果
| 指标 | 当前 | 优化后 | 变化 |
|------|------|--------|------|
| 行数 | xxx | ~xxx | -xx% |
| 大小 | xx KB | ~xx KB | -xx% |
| Token(估) | ~xxxx | ~xxxx | -xx% |
## 风险评估
- 风险等级：低/中/高
- 主要风险点：...
- 缓解措施：...
详见 references/audit-report-template.md。
最佳实践
- 审计不修改：工作流 A/B 只读+分析，不动文件；只有工作流 C 才写文件
- 先审计后动手：永远先跑 Audit 再跑 Optimize，让用户看到报告再决定
- 保持业务逻辑不变：只做信息架构调整（移动/压缩/重构），不改业务含义
- 版本号必须更新：每次优化后 version minor +1
- 备份意识：重大改动前提醒用户当前版本信息（方便回溯）
与其他 Skill 的关系
| 关系 | Skill | 说明 |
|---|
| 依赖 | skill-creation-guide | STOM 方法论的权威来源，审计标准以此为准 |
| 输入 | 任意 SKILL.md | 审计目标 |
| 输出 | 被优化的 SKILL.md + references/ | 优化产物 |
| 协同 | strategic-compact | 优化后的 Skill 更适合 strategic-compact 管理 |
| 记录 | skill-creation-guide 末尾表 | 审计结果记录到「已审计 Skill 记录」 |
📚 踩坑经验
由 AI 在实际优化中积累，请勿手动删除。
（暂无记录——等待首次实际使用）
