health-audit 用于审计项目已启用的插件是否与检测到的技术栈相匹配。用途:识别不适用于当前项目的插件,并推荐尚未启用但相关的插件。适用时机包括评估当前项目插件相关性、清理未使用插件、为技术栈发现相关插件、优化项目专属插件配置,以及在接手已有项目时进行审计;不适用于一般健康诊断、插件注册表损坏修复、智能体优化审计、直接安装插件或全面设置校验等场景。
主要能力:先依据上下文中的项目文件(如 package.json、Cargo.toml、pyproject.toml、requirements.txt、go.mod、Dockerfile、docker-compose、GitHub workflows、Terraform 文件、Kubernetes 清单等)判断技术栈。随后运行 claude plugin list --json 获取可用插件信息(名称、描述、关键词、分类),读取 .claude/settings.json 中的 enabledPlugins 数组,并将每个插件归类为相关、不相关或缺失。最后输出结构化报告,包含技术栈证据、当前启用插件及其相关性状态、建议添加与移除的插件及理由和统计汇总。
使用方式:命令为 /health:audit,可加参数 --fix(应用建议变更,按类别确认,并先备份设置)、--dry-run(仅展示将变更内容)、--verbose(展示每个插件决策的详细分析)。仅管理项目级设置;用户级插件位于 ~/.claude/settings.json,无需在项目级重复。可用 jq -r '.enabledPlugins[]? // empty' ~/.claude/settings.json 2>/dev/null 检查用户级插件。
限制与边界:仅处理 .claude/settings.json 中的项目级插件设置;插件不在市场中会标记为 unknown 但不移除;用户拒绝变更时尊重决定并给出手动说明。其他相关命令包括 /health:plugins、/health:check 和 /configure:claude-plugins。