SuperAPI AI 工具集

skill-audit

测试与质量

查看项目

更新于 10-16 05:02

技能介绍

用途:在合并或发布前,按仓库的技能契约检查每个已打包技能,输出失败项。审计为只读,除非用户在看过报告后要求修复,否则不改动任何文件。契约见 ../skill-forge/references/skill-package-contract.md,scripts/audit_skills.py 是其可执行形式。

主要能力:脚本遍历 <root>//skills//SKILL.md,应用 C1 至 C9 规则,有失败时退出码为 1。支持 --skill <name> 只检查单个技能、--format markdown 生成可粘贴到 PR 或 issue 的报告、--format json 供其他检查消费、--root <path> 指向其他技能仓库。语言环境、计数和插件清单规则仅在整仓库审计时运行,--skill 只作用于该包自身的规则。

使用方式:在仓库根目录运行 python3 skill-forge/skills/skill-audit/scripts/audit_skills.py --root .。若安装中缺少该脚本,应说明并停止,不要手工重写规则。报告每行为 <rule> <skill> <detail> (<file>),应先按成因分组再报告,给出数量、分组原因和确切文件,不要将违规改写成建议。

修复:仅在用户要求时进行。应修包而非改规则;一次只应用一条规则到所有违规技能,然后重跑。涉及目录、语言环境、计数或新包时使用 skill-forge。完成后重跑审计与测试:python3 skill-forge/skills/skill-audit/scripts/audit_skills.py --root . 和 python3 -m pytest tests -q。

限制:用户要求作为检查时不得编辑文件;不得从部分运行报告“无违规”,需说明运行范围;不得降低 MIN_EVALS、MAX_DESCRIPTION 等阈值;跳过的规则不等于通过,--skill 运行不会清除 C7 语言环境、C8 或 C9。与 skill-forge 配合用于编写和修复,与 code-review 配合处理工作流本身可疑的包。