SuperAPI AI 工具集

plugin-validator

通用与其它

查看项目

更新于 10-16 00:20

技能介绍

本技能用于在发布前校验 Claude Code 市场插件的结构与静默失败问题,触发场景包括插件校验、检查插件、hook 审计。

用途与能力:分阶段验证。第一阶段检查插件目录结构,包括 plugin.json 是否存在、JSON 语法是否有效,以及是否包含 name、version、description 等必填字段。第二阶段审计静默失败,核心规则是所有 hook 入口点在失败时必须向 stderr 输出。第三阶段提供修复模式,例如 bash 中 mkdir 等命令需配合 if ! 检查并输出 stderr,Python 中应避免 except 后直接 pass,改为向 sys.stderr 打印信息。

使用方式:可直接运行审计脚本校验指定插件,例如 uv run plugins/plugin-dev/skills/plugin-validator/scripts/audit_silent_failures.py plugins/my-plugin/,附加 --fix 可获取修复建议。该技能也会在插件添加工作流第三阶段被调用,要求在注册前必须运行校验。退出码含义为:0 表示全部通过,1 表示发现违规,2 表示路径无效或文件缺失。

适用场景与限制:适合插件发布前的结构检查与 hook 静默失败审计;支持的检查项包括 shellcheck、bash 与 Python 静默失败等。所需环境、依赖版本等细节暂未提供。