Axiomata Skill Evaluator Zh — Axiomata 技能 Evaluator Zh

Axiomata 技能评估系统 v3.0

通用、非人格化的 OpenClaw 代理技能质量评估工具。

信息 值 版本 3.0.0 类型 自包含评估系统 评估 双评估（Axioma 5维 + ISO 25010） 目标 70+（Axioma），90%+（ISO 25010）

• 目的和范围

目标

使用双评估系统提供完整的技能质量评估：

Axioma 5维框架（100分） ISO 25010结构框架（13项自动检查） 设计原则 自包含 + 通用 + 非人格化

原则 描述 自包含 所有工具捆绑在技能目录内 通用 适用于任何 OpenClaw 代理 非人格化 无代理特定引用 使用时机 触发词 行动 评估技能 运行双评估 发布前检查 运行完整评估流程 改进技能 分析报告并修复问题 技能审计 执行完整审计 检查质量 运行自动检查

• 双评估系统

╔═══════════════════════════════════════════════════════════╗ ║ 双评估系统架构 ║ ╠═══════════════════════════════════════════════════════════╣ ║ ║ ║ ┌─────────────────────────────────────────────────┐ ║ ║ │ 1. Axioma 5维评估（100分） │ ║ ║ │ │ ║ ║ │ 维度： │ ║ ║ │ ├─ 结构（Structure） → 20% │ ║ ║ │ ├─ 清晰度（Clarity） → 20% │ ║ ║ │ ├─ 完整性（Completeness） → 20% │ ║ ║ │ ├─ 一致性（Consistency） → 20% │ ║ ║ │ └─ 功能性（Functionality） → 20% │ ║ ║ │ │ ║ ║ │ 目标：70+ 分数 │ ║ ║ └─────────────────────────────────────────────────┘ ║ ║ ↓ ║ ║ ┌─────────────────────────────────────────────────┐ ║ ║ │ 2. ISO 25010 结构检查（13项） │ ║ ║ │ │ ║ ║ │ 类别：8个类别，25项标准 │ ║ ║ │ 自动检查：13项测试 │ ║ ║ │ │ ║ ║ │ 目标：90%+（12/13项通过） │ ║ ║ └─────────────────────────────────────────────────┘ ║ ║ ║ ╚═══════════════════════════════════════════════════════════╝

评估流程 [输入] 待评估技能 ↓ 第一阶段：Axioma 5维评估 ↓ 第二阶段：ISO 25010结构检查 ↓ [输出] 质量报告 + 改进建议

• 捆绑工具

文件 系统 用途 evaluator.py Axioma 5维 5维评估，捆绑在此目录 eval-技能.py ISO 25010 自动结构检查，捆绑在此目录 工具路径 EVAL_PATH="<技能目录>/scripts/" 技能_PATH="<待评估技能>"

# Axioma 5维评估 python3 ${EVAL_PATH}evaluator.py <技能_PATH> --verbose

# ISO 25010检查 python3 ${EVAL_PATH}eval-技能.py <技能_PATH> --verbose

• Axioma 5维评估

4.1 维度分解 维度 最高分 目标 检查内容 结构 20 14+ 标题头、章节、格式、元数据 清晰度 20 14+ 描述、命令、示例、约束 完整性 20 14+ 工具、前提条件、错误、边界情况 一致性 20 14+ 命名、格式、结构、风格 功能性 20 14+ 可验证命令、文档化输出 4.2 分数阈值 分数 状态 行动 90-100 优秀 可投入生产 70-89 良好 可进行小幅改进 50-69 需要改进 需要重大改进 <50 较差 需要重写

• ISO 25010 结构检查

5.1 自动检查（13项） 类别 检查数 验证内容 结构 6 前置matter、标题头、章节、格式 触发词 2 描述长度、触发上下文 文档 3 正文长度、引用、链接文档 脚本 2 Python解析、无外部依赖 5.2 通过阈值 结果 含义 13/13 完美结构分数 11-12/13 可接受，有轻微警告 <11/13 需要结构改进

• 命令参考

6.1 Axioma 5维评估 # 基本评估 python3 <技能目录>/scripts/evaluator.py <技能路径>

# 详细输出 python3 <技能目录>/scripts/evaluator.py <技能路径> --verbose

# 自动改进建议 python3 <技能目录>/scripts/evaluator.py <技能路径> --verbose --improve

# JSON输出 python3 <技能目录>/scripts/evaluator.py <技能路径> --json

6.2 ISO 25010检查 # 基本ISO检查 python3 <技能目录>/scripts/eval-技能.py <技能路径>

# 详细输出 python3 <技能目录>/scripts/eval-技能.py <技能路径> --verbose

# JSON输出 python3 <技能目录>/scripts/eval-技能.py <技能路径> --json

6.3 评估所有技能 # 评估父目录中的所有技能 python3 <技能目录>/scripts/evaluator.py --all

# 详细输出所有 python3 <技能目录>/scripts/evaluator.py --all --verbose

• 输出格式

7.1 控制台输出 === 评估结果 === 结构（STRUCTURE） 20/20 ████████████████████ 100% 清晰度（CLARITY） 17/20 █████████████████░░░ 85% 完整性（COMPLETENESS） 14/20 ████████████░░░░░░░░ 70% 一致性（CONSISTENCY） 10/20 ██████████░░░░░░░░░ 50% 功能性（FUNCTIONALITY） 12/20 ████████████░░░░░░░░ 60% ------------------------------------------------------------ 状态：良好（分数 73%）

7.2 JSON输出 { "技能": "example-技能", "scores": { "structure": 20, "clarity": 17, "completeness": 14, "consistency": 10, "functionality": 12 }, "total": 73, "max": 100, "passed": true, "recommendations": [ "[CONSISTENCY] 低分 (50%)", " -> 风格分数: 2/5" ] }

• 示例

示例1：基本评估 $ python3 evaluator.py /path/to/技能 --verbose 读取 /path/to/技能/技能.md (2048 字符) 结构（Structure）: 20/20 清晰度（Clarity）: 17/20 完整性（Completeness）: 14/20 一致性（Consistency）: 10/20 功能性（Functionality）: 12/20 ============================================================ 状态：良好（分数 73%）

示例2：ISO 25010检查 $ python3 eval-技能.py /path/to/技能 --verbose 【结构】（STRUCTURE） 通过：5/6 【触发词】（TRIGGER） 通过：2/2 【文档】（DOCUMENTATION） 通过：2/3 【脚本】（SCRIPTS） 通过：2/2 【安全】（SECURITY） 通过：2/2 ================================================== 通过：13 警告：0 失败：0 结构分数：100%（13/13项通过）

示例3：JSON输出 $ python3 evaluator.py /path/to/技能 --json { "技能": "example-技能", "scores": { "structure": 20, "clarity": 17, "completeness": 14, "consistency": 10, "functionality": 12 }, "total": 73, "max": 100, "passed": true, "recommendations": [] }

• 自我评估

技能自动进行自我评估：

# 自我评估（未提供路径时评估自身目录） python3 evaluator.py

# v3.0预期输出： # 分数：85+/100