AXIOMA 技能评估器 🧙♂️
高级技能评估：双系统（自动化 + 手动）
信息值版本 2.1.0 — 2026-05-07
状态 OPERATIONAL
目标
提供综合的技能评估，使用双系统：
Axioma 系统（5 维，100 分满分）— 多彩，快速
ISO 25010 系统（25 条标准，100 分满分）— 国际标准
何时使用
触发操作
在发布技能之前
运行两个评估
改进技能
获取自动化和手动评分
质量审计
使用 25 条标准的评估表
发布前检查
运行所有检查
evaluator.py（Axioma 系统）
# 运行 Axioma 5 维评估
python3 evaluator.py <技能路径> --verbose --improve
eval-skill.py（ISO 25010 系统）
# 运行自动化 ISO 25010 检查
python3 eval-skill.py <技能路径> --verbose
# JSON 输出
python3 eval-skill.py <技能路径> --json
快速开始
python3 evaluator.py <技能路径> --verbose --improve
5 维（100 分满分）
维度 权重 重点
结构 20% 标题，章节，格式，元数据
清晰度 20% 描述，说明，示例
完整性 20% 工具，先决条件，错误，边界情况
一致性 20% 风格，命名，集成
功能性 20% 命令是否可用，预期结果
输出格式
╔═══════════════════════════════════════════════════════════╗
║ 📊 技能评估报告 — [技能名称] ║
║ 得分：XX/100 [状态] ║
╠═══════════════════════════════════════════════════════════╣
║ 结构：XX/20 ████████████░░░░ XX% ║
║ 清晰度：XX/20 ████████████░░░░ XX% ║
║ 完整性：XX/20 ████████████░░░░ XX% ║
║ 一致性：XX/20 ████████████░░░░ XX% ║
║ 功能性：XX/20 ████████████░░░░ XX% ║
╠═══════════════════════════════════════════════════════════╣
║ 状态：✅ APPROVED（得分 >= 70%） ║
╚═══════════════════════════════════════════════════════════╝
阈值 得分 状态 操作
90-100 🟢 EXCELLENT 准备好发布
70-89 🟡 GOOD 可发布，少量注释
50-69 🟠 NEEDS_WORK 修复后发布
<50 🔴 POOR 需要大量改进
自动化检查（eval-skill.py）
运行 13 个自动化检查：
文件结构验证
Frontmatter YAML 解析
描述质量（65+ 字，触发上下文）
脚本语法验证
凭证扫描
依赖审计
目标：90%+（12+/13 检查通过）
手动评估（25 条标准）
类别 框架 最大标准
- 功能适用性 ISO 25010 /12 完整性，正确性，适当性
- 可靠性 ISO 25010 /12 容错，错误报告，恢复性
- 性能 ISO 25010 /8 令牌成本，执行效率
- 可用性（AI） Shneiderman /12 学习能力，一致性，反馈
- 可用性（人类） Tognazzini /8 可发现性，宽容度
- 安全性 ISO 25010 /12 凭证，输入验证，数据安全
- 维护性 ISO 25010 /12 模块化，可修改性，测试性
- 特定代理 Novel /24 触发精度，渐进式披露，组合性
总计 /100
- 完整评估工作流程
- 自动化：python3 eval-skill.py <路径> --verbose → 目标：90%+ 结构得分
↓
- AXIOMA：python3 evaluator.py <路径> --verbose --improve → 目标：70+ 得分
↓
- 手动：评估 25 条标准的评估表 → 目标：80+ 得分
↓
↓
↓
常见问题
问题 原因 解决方案
没有 Frontmatter YAML 没有在开始处添加 --- 添加 --- 在 SKILL.md 开始处
描述不良 缺少触发器 添加 "使用时：" 子句
空目录 未使用的文件夹 删除或填充
名称不匹配 目录 ≠ Frontmatter 重命名为匹配
安全问题
问题 严重性 操作
硬编码凭证 严重 立即删除
缺少输入验证 高 添加验证
没有错误处理 中等 添加 try/catch 块
情况 输入 预期输出
空 SKILL.md 空文件 错误消息，建议模板
非常长的 SKILL.md >500 行 警告，建议拆分
缺少描述 没有 Frontmatter 失败并提供说明
没有脚本 没有 scripts/ 目录 通过，记录为独立文件
依赖 目的 是否必需
Python 3.6+ 脚本执行 是
PyYAML Frontmatter 解析 否
在 Altum Per Quality. 🧙♂️ Axioma 技能评估器 v2.1
by @kofna3369