核心用法
Skill Reviewer Pro 是面向 OpenClaw 生态的专业技能审计工具,采用六级递进式审查框架:
1. 格式验证:检查 YAML frontmatter、package_skill.py 兼容性、文件结构合规性
2. 写作质量评估:从结构清晰度、描述准确性、示例密度、组织逻辑、可操作性五个维度评分
3. 功能验证:比对生成模板与 OpenClaw 官方规范(如 AGENTS.md 必须包含会话启动流程、内存工作流、群聊行为、心跳机制等)
4. 最佳实践检查:渐进式信息披露、资源组织合理性、触发条件精确性
5. 优化建议:按 🔴Critical/🟡Major/🟢Minor 三级优先级输出改进方案
6. 工作流验证(专用于工作流类技能):检查阶段完整性、CLI 命令准确性、错误处理、备份机制、验证步骤、故障恢复策略
典型应用场景:技能发布前审计、下载技能安全评估、现有技能迭代优化、工作流工具专项审查。
---
显著优点
- 标准化评分体系:116 分制量化评估,6 大层级 15+ 细分维度,输出可对比的评分卡
- OpenClaw 生态深度适配:内置 AGENTS.md、SKILL.md、IDENTITY.md 等核心文件规范比对
- 工作流专项审查:独创 Phase-by-Phase 验证清单,覆盖操作步骤、错误处理、依赖管理、CLI 命令校验
- 多语言自适应:强制遵循用户请求语言响应,支持中英日韩等多语言审查输出
- 缺陷分级管理:Critical/Major/Minor 三级缺陷分类,附带具体修复方案与影响分析
---
潜在局限
- 依赖外部验证工具:Level 1 需调用
package_skill.py,若环境未配置则降级为手动检查 - 规范同步延迟:OpenClaw 规范迭代时,内置模板比对可能产生假阳性(需人工二次确认)
- 工作流审查偏重 CLI 场景:对纯 GUI 操作的工作流支持有限
- 无自动化修复:仅输出审查报告,不直接修改被审技能文件
---
适合人群
| 用户类型 | 使用场景 |
|---------|---------|
| Skill 开发者 | 发布前质量把关、版本迭代审查 |
| OpenClaw 管理员 | 生态技能准入审核、安全评估 |
| DevOps/平台工程师 | 工作流工具验收、配置变更审计 |
| 终端用户 | 下载第三方技能前的快速安全筛查 |
---
常规风险
- 配置变更风险:工作流验证涉及
openclaw.json、`auth-profiles.json 修改,审查报告会强制要求备份机制检查 - 功能不匹配漏判:若被审技能刻意绕过规范(如动态生成模板),静态比对可能失效
- 语言自适应误差:混合语言请求可能误判主语言,建议在清晰语境下使用
---
使用建议
- 前置条件:确保 OpenClaw CLI 已安装且
package_skill.py可执行 - Critical 缺陷零容忍:功能验证(Level 3)或工作流验证(Level 6)出现 ❌ 时,建议禁止发布
- 结合自动化测试:Level 6 审查后建议补充 Phase 8 自动化测试命令验证