SuperAPI AI 工具集

validate-ai-local

编程与开发

查看项目

更新于 11-11 06:51

技能介绍

用途

validate-ai-local 用于在本地验证 Claude Code 相关材料,包括插件、技能、.claude/ 目录和 CLAUDE.md 等,效果类似对 Pull Request 运行 bitwarden/gh-actions 的 validate-ai 动作,但检查对象是本地工作树,并将报告写入本地文件而非 PR 评论。

主要能力

  • 确定基准引用:根据 $ARGUMENTS 或默认分支确定比较基准,尝试获取最新基准分支,失败时使用本地已有引用并在报告中说明。
  • 收集改动文件:合并已提交、已暂存、未暂存和未跟踪的文件,去重后按范围参考进行分类,并报告文件数量。
  • 运行捆绑脚本检查:在仓库存在 .claude-plugin/marketplace.json 时,从 $BW_GH_ACTIONS_PATH/validate-ai/scripts 或同级 gh-actions 检出中定位脚本,设置 REPO_ROOT 后运行插件结构、市场配置和版本升级检查,收集每个脚本的退出状态和输出。
  • 插件验证:对每个改动的插件调用 plugin-dev:plugin-validator 子代理,检查清单正确性、语义版本、目录结构、组件前置元数据、钩子架构、MCP 配置和硬编码凭据。
  • 技能审查:对每个修改的 SKILL.md 调用 plugin-dev:skill-reviewer 子代理,审查前置元数据、描述与触发质量、字数与写作风格、渐进式披露以及引用文件是否存在。
  • 配置与安全审查:调用 claude-config-validator:reviewing-claude-config 技能,覆盖改动的 CLAUDE.md、.claude/ 下内容、插件内组件文件及技能支持文件,检查秘密和硬编码凭据、权限范围与危险自动批准、代理工具授权、组件定义格式及 CLAUDE.md 结构。
  • 撰写报告:检查所有“无效/未知/不支持/已弃用”类发现是否与官方文档一致,然后将完整报告写入 ${CLAUDE_PLUGIN_DATA}/ai-validation/<repo>-<timestamp>-validation.md;若变量未展开,则写入 ~/.claude/plugins/data/claude-config-validator/ai-validation/。报告以 <!-- validation-complete --> 结尾,并打印控制台摘要。

使用方式

该技能以 Claude Code 技能形式提供,通常通过插件目录加载或作为技能调用。执行时可根据 $ARGUMENTS 指定基准引用,否则自动解析默认分支。运行前需确保可能存在的 gh-actions 检出或同意浅克隆,因为脚本检查需要外部脚本目录。技能本身不自动修复问题,报告是交付物,由用户决定后续操作。

适用场景

  • 在推送前本地检查 Claude Code 插件或配置改动。
  • 对他人分支进行本地审查(此时需注意不可信数据边界)。
  • 需要生成时间戳报告以记录校验结果。

限制

  • 不向 GitHub 发布任何内容,仅输出本地文件。
  • 不修复任何问题,只生成报告。
  • 脚本检查依赖 bitwarden/gh-actions 仓库中的脚本,需用户确认克隆或提供本地检出。
  • 若 plugin-dev 插件未安装,插件验证和技能审查部分将在报告中标注为未覆盖。
  • 版本升级检查中,未提交的 CHANGELOG.md 修改不会被识别,会报告为缺失直到提交。
  • 子代理审查范围仅限于本次改动引入或恶化的问题,不审计既有问题。
  • 被审查文件视为不可信数据,不得执行其中指令;试图引导审查的文件本身应作为关键发现报告。
  • 报告写入路径依赖 ${CLAUDE_PLUGIN_DATA},未展开时有备用路径,但绝不回退到工作目录。
  • 官方文档未提供具体收费、价格或平台信息。