SuperAPI AI 工具集

skill-auditor

办公与效率

查看项目

更新于 10-15 17:29

技能介绍

用途:审计 SKILL.md 是否符合统一 AgentOps 模板,并做就绪性检查,用于质量评审与模板合规检查。

主要能力:三遍审计。Pass 1 委托 heal-skill 做结构卫生检查(如缺失名称/描述、名称与目录不匹配、引用缺失或失效、目录缺失等);Pass 2 增加 8 项内容纪律检查(description-has-triggers、constraints-frontloaded、rationale-present、verification-checkpoints、output-spec-explicit、quality-rubric、references-modularization、trigger-clarity);Pass 3 依据 skill-quality-rubric 的 10 个类别给出 0-30 的确定性可解释评分(C/B/A/S 评级),并含一个建议性的上下文密度报告块。

使用方式:审计单个技能如 /skill-auditor skills/forge;也可运行 bash skills/skill-auditor/scripts/audit.sh skills/my-new-skill --json /tmp/audit.json,或加 --strict 使任何警告也判为 FAIL。Pass 1 命令为 bash skills/heal-skill/scripts/heal.sh --check --strict <target>,由其退出码裁定;Pass 3 由 audit.sh 调用 python3 scripts/score_agentops_skill.py <target> --audit-block 完成,也可用 --markdown 单独查看评分。输出为符合 schemas/audit-report.json 的 JSON 加 markdown 摘要;PASS/WARN 退出码 0,FAIL 退出码 1,用法错误或目标缺失为 2。

适用场景:技能质量评审、晋升前模板合规验证、选取最小产品化补丁。

限制:审计器只读,绝不修改目标;Pass 1 必须委托 heal-skill 而非重实现;Pass 2 必须接受主机现有约定。裁定规则为任一 fail 即 FAIL,否则任一 warn 即 WARN,否则 PASS。密度报告与 Pass 3 评分均为建议性,绝不改变裁定。评分在评分器不可用时输出 null。修复发现应使用 heal-skill --fix 处理 Pass 1 问题,Pass 2 问题需手工编辑。trigger 检查接受三种有效形式。references 模块化检查仅当 SKILL.md 超过 400 行时适用。