name: skill-refiner description: 审核并修复工作空间中所有技能，确保符合技能创建器要求。在要求“优化技能”、“审核技能”、“检查技能质量”或“修复不合规技能”时使用。详尽搜索整个工作空间（不仅仅是skills/目录）以找到每个SKILL.md文件，然后审核并修复每个文件。
技能优化器
查找工作空间中的每个技能，根据技能创建器要求进行审核，并修复不合规的技能。
工作流程
第1步 — 发现所有技能
bash scripts/find_skills.sh [workspace_dir]
此命令在整个工作空间中搜索SKILL.md文件（不仅仅是skills/目录）。未遵循技能创建器约定创建的技能可能位于任何位置。
第2步 — 审核每个技能
python3 scripts/audit_skill.py <skill-dir>
返回JSON格式结果，包含：
issues— 必须修复的阻塞性问题warnings— 建议性改进项compliant— 仅当issues为空时为true
对第1步返回的每个路径运行此命令。批量示例：
bash scripts/find_skills.sh | while read dir; do
python3 scripts/audit_skill.py "$dir"
done
第3步 — 报告发现
以表格形式总结结果：
| 技能 | 位置 | 问题 | 警告 | 状态 |
|---|---|---|---|---|
| my-skill | skills/my-skill | 0 | 1 | ⚠️ |
| bad-skill | temp/bad-skill | 2 | 0 | ❌ |
第4步 — 修复不合规技能
对于每个存在问题的技能，按此顺序修复：
- 缺少/格式错误的前置元数据 — 添加或更正仅包含
name和description的---块 - 额外的前置元数据字段 — 删除除
name和description外的任何字段 - 描述薄弱 — 重写以包含：技能功能 + 触发条件（“在…时使用”）
- 无关文件 — 删除README.md、INSTALLATION_GUIDE.md、CHANGELOG.md等
- 位置错误 — 如果技能位于
skills/目录外，将其移动到~/.openclaw/workspace/skills/<skill-name>/ - 命名违规 — 将目录重命名为小写连字符格式
对于警告（建议性）：
- SKILL.md过长（>500行）：将详细内容提取到
references/文件中，并从SKILL.md中链接 - 未链接的引用：在SKILL.md正文中添加链接
- 描述薄弱：改进触发语言
第5步 — 验证修复
在每个修复后的技能上重新运行audit_skill.py，确认"compliant": true。
可选打包：
python3 /opt/homebrew/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py <skill-dir>
合规性检查清单
合规技能必须具有：
- [ ] 在命名目录根目录下的
SKILL.md文件 - [ ] 仅包含
name和description的YAML前置元数据（无其他字段） - [ ]
description包含技能功能及触发时机 - [ ] 目录名：仅限小写字母、数字、连字符；≤64个字符
- [ ] 无无关文件（README.md、CHANGELOG.md等）
- [ ] 资源仅位于
scripts/、references/或assets/目录中 - [ ] 所有
references/文件均从SKILL.md正文链接 - [ ] SKILL.md正文≤500行（如果更长则拆分到references/目录）