用途:对任意 Agent Skill 做 TRACE 五维度质量评测,覆盖 T(可信任度)、R(可靠性)、A(适用性)、C(规范性)、E(有效性),共 20 个子项,输出带子项分的评估报告与改进建议。
主要能力:脚本计算确定性基分,AI 阅读 SKILL.md 正文后做语义校准(单子项 ±0.3),最终给出五维均分与综合评级(≥4.5 优秀、3.5–4.4 良好、<3.5 需改进)。支持标准、严格、快速、单维度、对比等模式;可生成 Markdown 报告与含 SVG 雷达图的 HTML 报告,并附 no-skill 基线对比与官方规范合规检查。
使用方式:先运行 python3 scripts/trace_evaluate.py --skill-dir <path> --format json 获取 base_scores;再阅读 SKILL.md 及 references/、examples/ 目录;对照 references/scoring-criteria.md 与 references/calibration-guide.md 逐项校准并附调整理由;最后按模板 examples/trace-report.generated.md 或 .html 填入数据,写入 {skill-dir}/trace-report.md 或 {skill-dir}/evaluation-report.html。
适用场景:新 Skill 完成编写后的质量基线检查、修改功能说明或 FAQ 后的复评、平台审核与社区第三方评估、多版本差异对比。
限制:评测需提供含 SKILL.md 的 Skill 目录路径,仅凭名称无法评测;R1/E1/E3 等子项依赖 AI 阅读正文判断语义质量,脚本只提供结构基分;结果由 AI 自动生成,不保证与官方评测完全一致;不负责撰写 Skill 内容或自动发布。评分达 4.8 及以上可视为实用标准。