用途
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},未展开时有备用路径,但绝不回退到工作目录。 - 官方文档未提供具体收费、价格或平台信息。