Skill Audit — 技能审计

技能审计 审计和评分 OpenClaw AgentSkills 使用多维评分系统。 快速开始 “审计此技能”或“评分路径/到/SKILL.md” 语言政策 审计报告：始终以两种语言生成： 用户语言 —— 用于无障碍访问（从请求语言或目标 SKILL.md 正文语言检测） 英语 —— 用于全球共享和可比性 两种语言版本应完整（评分、维度分析、改进建议）。 格式：先写用户语言版本，然后是英语版本，中间用明显的分隔符隔开。 如果用户已经请求英语，则只需单个英语版本（无重复）。

评分概述 总分（0-100）= 加权平均 维度 权重 评分范围 描述 ────────────────── ─────── ─────────── ─────────── A. 结构 20% 0-100 规范合规性、前置内容、文件结构 B. 触发 15% 0-100 描述质量、关键词、触发 C. 风格指南 20% 0-100 判断标准、保留/压缩规则 D. 工作流 15% 0-100 阶段 0、子代理设计 E. 子代理设计 15% 0-100 上下文注入、模板 F. 简洁 15% 0-100 SKILL.md 长度、引用分离 等级：A（90+）| B（75+）| C（60+）| D（45+）| F（<45）

如何审计 读取目标 SKILL.md 和任何引用/ 使用以下评分标准评分每个维度 计算加权总分和等级 报告评分卡 + 改进建议

维度 A：结构（20%） 前置内容、文件结构、AgentSkills 规范合规性。 检查点 标准 前置内容存在 15 --- 开头和结尾存在，名称有效 10 小写、连字符仅限 1-64 个字符 描述存在 15 非空，1-1024 个字符 描述包含关键词 10 多语言关键词 无辅助文件 10 无 README.md、CHANGELOG.md 等 引用/ 有序 10 如果存在，1 级深，TOC 大于 100 行 SKILL.md 小于 500 行 10 精简正文，详细信息在引用/ 中 无重复 5 信息在 SKILL.md 或引用中，不在两者中 文件夹名称匹配名称 15 skill-name/SKILL.md 最大值：100

维度 B：触发（15%） 描述是否正确触发代理。 检查点 标准 “什么”被描述 20 清晰描述其功能 “何时”在描述中 25 触发条件在描述中（不是正文） 关键词（韩语） 15 韩语关键词包含 关键词（英语） 15 英语关键词包含 不冗长 10 描述 ≤ 300 个字（元数据成本） 不模糊 15 不过于宽泛（例如，“有用技能”） 最大值：100

维度 C：风格指南（20%） 判断标准（保留/压缩）是否指定。 适用性： 适用：文本处理/转换/摘要技能（修改原始内容的任务） 部分适用：代码生成/修改技能（可能需要现有代码保留标准） 不适用：结构化数据管理（JSON/DB CRUD）、简单工具包装器、配置管理 对于不适用技能，排除此维度并在剩余维度中重新分配权重： 仅 C 不适用：A：24%、B：18%、D：18%、E：18%、F：22% 仅 E 不适用：A：24%、B：18%、C：24%、D：18%、F：16% C 和 E 均不适用：A：30%、B：20%、D：20%、F：30% 检查点 标准 保留标准 30 “保留什么”带有具体示例 压缩标准 25 “压缩什么”带有具体示例 任务本质定义 20 核心任务定义（例如，“摘要是重构，而不是压缩”） 风格规则显式 15 具体规则用于语气、风格、长度等 反模式 10 “不做什么”指定（奖励） 最大值：100

维度 D：工作流（15%） 阶段 0、执行顺序和验证步骤是否存在。 检查点 标准 阶段 0（分析）首先 30 完整理解步骤在任务执行之前 清晰的阶段编号 15 阶段 0、1、2... 结构 上下文注入描述 25 显式声明阶段 0 结果被注入到子代理提示中 验证步骤 20 结果质量验证步骤（长度/风格/省略） 错误处理 10 失败响应指令 最大值：100

维度 E：子代理设计（15%） 子代理提示设计质量。 适用性： 适用：使用子代理的技能（并行/顺序块处理等） 部分适用：可选提及子代理委托的技能（核心是单代理） 不适用：完全不使用子代理的技能 对于不适用技能，排除此维度并在剩余维度中重新分配权重： 仅 C 不适用：A：24%、B：18%、D：18%、E：18%、F：22% 仅 E 不适用：A：24%、B：18%、C：24%、D：18%、F：16% C 和 E 均不适用：A：30%、B：20%、D：20%、F：30% 检查点 标准 提示模板存在 20 模板文件在引用/ 中 [ ] 占位符 20 空白字段由阶段 0 显式标记 上下文字段定义 20 完整上下文、块位置、保留列表 风格规则在模板中 15 3-4 行风格指令包含 合并 ≠ 连接 15 显式禁止简单连接 最大值：100