SuperAPI AI 工具集

audit-plugin

智能体与模型

查看项目

更新于 10-16 08:00

技能介绍

该技能用于审计本地插件目录,验证其是否符合 Agent Skills 与 Claude Plugin 开放标准。它委托 agent-plugin-analyzer 对目标插件执行多维语义检查,作为 agent 生态的 CI/CD 最终审核关口。

使用方式:触发 agent-plugin-analyzer 技能,指定插件目录 --dir <path-to-plugin> --security。参数 --dir 为被审计插件根目录的绝对或相对路径。应始终带 --security 标志,以便在审查架构前捕获 P0 恶意软件启发式特征。需使用 Python 分析脚本,不使用旧版基础审计脚本。

审计检查包括:开放标准验证,运行 skills-ref validate <path-to-skill> 捕获 frontmatter 解析错误、长度约束及必填字段(name、description);命名与内容约束,要求技能名使用动名词形式(动词 + -ing),拒绝泛化名词,名称须与父目录完全一致,description 须严格用第三人称;执行模式(L4)检查渐进式自主、来源透明、升级触发;状态管理检查条件包含与显式状态清单;架构严格性验证 CONNECTORS.md、README.md、YAML frontmatter 纯度,要求 SKILL.md 仅使用一层深的相对文件引用且少于 500 行,所有支持文件须严格归入官方 scripts/、references/ 或 assets/ 目录;安全向量标记未沙箱执行、提示注入漏洞和原始二进制执行,要求工具脚本使用显式错误处理。

修复与后续:若输出低成熟度分数或未通过 --security 闸门(会强制立即 sys.exit(1)),必须读取生成的输出报告,用文件编辑工具修复目标插件的合规问题,并重复审计直至达到 Level 3 或更高。后续可提供运行 create-skill 修复已识别缺口,或运行 create-stateful-skill 升级至 L4 成熟度。