| name | bm.skill-improvement |
| description | Skill 自我优化：评估现有 skill 质量、发现问题、提出改进方案、迭代更新。Use when user wants to improve, update, optimize skills, 优化 skill, 改进 skill, 更新 skill, skill 质量. 由 butler agent 调用。 |
| source | opencrew |
| version | 20260521.01 |
Skill: Skill 自我优化
作用域
分析 skill 使用情况，生成改进建议，用户确认后执行优化。
文件落点
- 最终产物：
./reports/skill-suggestions/{skill}-{date}.md（cwd 下，可见目录，跟随用户惯例）
- 中间产物：
./working/skill-improvement/
- 变更日志：
./working/skill-improvement/changelog.md
- 目录不存在：主动创建；用户已有惯例则跟随
- 永远在 cwd 内：不写
/tmp/、~/Desktop/、~/Downloads/ 等 cwd 之外位置（用户明确指定除外）
原则
- 不自动修改任何 skill 文件。所有改动必须用户确认
- 每次只改一个 skill。不要一次改多个
- 改前备份。记录原始内容和改动理由
- 可回滚。每次改动记录版本号，可以恢复
优化流程
Step 1：收集使用数据
从以下来源推断 skill 使用情况：
./reports/butler-*.md 和 ./reports/skill-suggestions/*.md — 之前的复盘与建议- 近期对话上下文 — 用户反馈了什么问题
./working/skill-improvement/changelog.md — 已确认执行过的 skill 变更- 相关产物目录 — 哪些 skill 对应的输出质量如何
Step 2：评估每个 Skill
对每个 skill 按 3 个维度打分：
| 维度 | 评分标准 |
|---|
| 清晰度 | Agent 按照指令执行时，是否经常偏离？偏离说明指令不够清晰 |
| 完整性 | 是否经常遇到指令没覆盖的场景？ |
| 实用性 | 实际使用中哪些部分是多余的？哪些缺失？ |
Step 3：生成优化报告
## Skill 优化报告
### 评估结果
| Skill | 清晰度 | 完整性 | 实用性 | 优先级 |
|-------|--------|--------|--------|--------|
| research | 8/10 | 7/10 | 9/10 | 低 |
| meeting | 6/10 | 5/10 | 8/10 | 高 |
| health | 9/10 | 8/10 | 9/10 | 无需改 |
### 需要优化的 Skill
#### 1. bm.meeting/SKILL.md（优先级：高）
**问题**：
- 字幕提取步骤不够具体，Agent 不知道如何处理无 speaker 标注的情况
- 缺少"多语言会议"的处理说明
**建议改动**：
1. 在"字幕提取"部分增加无 speaker 标注的处理流程
2. 增加"多语言会议"小节
**改动内容**：
[具体要改的文字，old → new]
Step 4：用户确认
把报告交给用户，等确认后再改。
Step 5：执行改动
用户确认后：
- 记录改动前内容到
./working/skill-improvement/changelog.md
- 修改 skill 文件
- 在 changelog 中记录改动摘要和回滚信息
变更日志格式
在 ./working/skill-improvement/changelog.md 中维护：
## Skill 变更日志
| 日期 | Skill | 改动摘要 | 原因 |
|------|-------|---------|------|
| 2026-05-16 | bm.meeting | 增加无 speaker 字幕处理流程 | 字幕提取经常偏离 |
| 2026-05-16 | bm.project-mgmt | 增加项目目录创建流程 | 首次创建时不确定步骤 |
优化模式
用户主动触发
用户 → Lead: "帮我优化一下 meeting skill"
Lead → Butler: 执行 skill-improvement 流程
Butler → 输出优化报告
Lead → 交给用户确认
Butler 定期复盘时触发
在复盘报告的"建议优化"部分输出。不自动执行，等用户确认。
注意事项
- 不要为了改而改。用得好的 skill 不要动
- 每次改动最小化。只改有问题的部分，不顺手"完善"其他部分
- 改动理由必须来自实际使用中的问题，不是理论上的"可以更好"
- 如果 skill 刚改过不到 7 天，不要再次建议改动（给改动时间验证）
