Skill Judge 说明文档

# 技能评判员 (Skill Judge) 一个用于评估智能体技能质量是否符合官方规范和最佳实践的综合评估框架。该技能为 SKILL.md 文件和技能包提供多维度评分和可操作的改进建议。 ## 目的 技能评判员旨在解决一个关键问题：**大多数技能浪费了 Claude 本已具备的知识 Token**。 该技能通过衡量其“知识增量”（技能提供的内容与 Claude 已知内容之间的差距）来帮助您评估技能是否真正增加了价值。优秀的技能应该是压缩的专家大脑，而不是教程。 ### 核心公式 > **优秀技能 = 专家级知识 - Claude 已知知识** 该技能可帮助您识别： - 浪费 Token 的冗余内容（Claude 已知的内容） - 真正增加价值的专家知识 - 导致技能无法有效激活或使用的结构性问题 ## 何时使用 在以下情况使用技能评判员： - **发布前审查技能**：评估质量并确定改进点 - **审计现有技能**：对照最佳实践进行系统性评估 - **改进 SKILL.md 文件**：获取具体的、可操作的建议 - **学习技能设计模式**：了解什么造就了优秀的技能 - **比较技能**：使用一致的标准评估相对质量 **触发短语**： - "Evaluate this skill" - "Review my SKILL.md" - "Audit this skill" - "Score this skill" - "How can I improve this skill?" - "Is this skill well-designed?" ## 工作原理 ### 评估协议 1. **第一轮 - 知识增量扫描**：阅读 SKILL.md 并将每个部分分类为： - **[E] 专家 (Expert)**：Claude 确实不知道这一点（增加价值） - **[A] 激活 (Activation)**：Claude 知道但简短提醒很有用（可接受） - **[R] 冗余 (Redundant)**：Claude 肯定知道这一点（应删除） 2. **结构分析**：检查元数据有效性、行数、参考文件、设计模式和加载触发器 3. **维度评分**：根据 8 个维度进行评估，并提供具体的证据和理由 4. **计算总分和评级**：汇总分数（满分 120 分）并分配等级 5. **生成报告**：生成包含分数、关键问题和改进建议的结构化报告 ### 8 个评估维度 (总分 120 分) | 维度 | 满分 | 衡量内容 | |-----------|------------|------------------| | **D1: 知识增量** | 20 | 技能是否增加了真正的专家知识