health-audit

/health:audit

根据项目实际使用的技术栈，审查已启用的插件。找出不适用于该项目的插件，并推荐尚未启用的相关插件。

何时使用此技能

在以下情况下使用此技能……	在以下情况下采用其他方法……
检查插件是否适用于当前项目	进行常规健康诊断（使用 /health:check）
清理未使用的插件	插件注册表损坏（使用 /health:plugins --fix）
根据技术栈查找相关插件	进行 Agentic 优化审查（使用 /health:agentic-audit）
优化项目专属的插件配置	安装特定插件（直接安装）
开始使用现有项目	需要全面验证设置

上下文

• 当前项目：!pwd
• 项目设置文件是否存在：!find .claude -maxdepth 1 -name 'settings.json'
• package.json 是否存在：!find . -maxdepth 1 -name 'package.json'
• Cargo.toml 是否存在：!find . -maxdepth 1 -name 'Cargo.toml'
• pyproject.toml 是否存在：!find . -maxdepth 1 -name 'pyproject.toml'
• requirements.txt 是否存在：!find . -maxdepth 1 -name 'requirements.txt'
• go.mod 是否存在：!find . -maxdepth 1 -name 'go.mod'
• Dockerfile 是否存在：!find . -maxdepth 1 -name 'Dockerfile'
• docker-compose 是否存在：!find . -maxdepth 1 \( -name 'docker-compose.yml' -o -name 'docker-compose.yaml' -o -name 'compose.yml' -o -name 'compose.yaml' \)
• GitHub 工作流：!find .github/workflows -maxdepth 1 -name '*.yml' -quit -print
• Terraform 文件：!find . -maxdepth 2 -name '*.tf' -quit -print
• Kubernetes 清单：!find . -maxdepth 3 \( -path '*/k8s/*' -o -path '*/kubernetes/*' \) -name '*.yaml' -quit -print

参数

参数	说明
--fix	将推荐的更改应用到 .claude/settings.json
--dry-run	显示将要进行的更改，但不修改文件
--verbose	显示每项插件判断的详细分析

执行

执行此插件适用性审查：

步骤 1：检测项目技术栈

分析上述上下文中的项目文件，确定项目的技术栈。将检测到的指标与 REFERENCE.md 中的技术栈映射进行匹配。

步骤 2：获取可用插件

运行 claude plugin list --json，获取已配置的市场中的所有可用插件。解析输出中的插件名称、说明、关键词和类别。

步骤 3：读取当前启用的插件

读取 .claude/settings.json 并提取 enabledPlugins 数组。如果文件不存在或未设置 enabledPlugins，则将其视为空列表。

步骤 4：分析插件适用性

将每个已启用的插件与检测到的技术栈进行比较。使用 REFERENCE.md 中的插件适用性映射，确定哪些插件相关、不相关或缺失。

将每个插件归类为：

• 相关——与检测到的技术栈匹配
• 不相关——未找到匹配的指标
• 缺失——相关插件当前未启用

步骤 5：生成审查报告

打印结构化报告，涵盖：

1. 检测到的技术栈及其依据
2. 当前启用的插件及其适用性状态
3. 建议添加的插件（及原因）
4. 建议移除的插件（及原因）
5. 汇总数量

步骤 6：应用更改（如果使用 --fix）

传入 --fix 时：

1. 备份当前设置：cp .claude/settings.json .claude/settings.json.backup
2. 在每类更改（移除、添加）前征求确认
3. 更新 .claude/settings.json——移除确认不相关的插件，添加确认相关的插件，并保留其他设置
4. 重新读取文件以验证更改，确认 JSON 有效，并显示差异

用户级与项目级

注意：此命令仅管理 .claude/settings.json 中的项目级插件设置。

用户级插件（位于 ~/.claude/settings.json）单独管理，无需在项目级重复设置。

分析时，请检查插件是否已在用户级启用：

jq -r '.enabledPlugins[]? // empty' ~/.claude/settings.json 2>/dev/null

如果插件已在用户级启用，除非你希望采用项目专属行为，否则无需将其添加到项目设置中。

边缘情况

场景	行为
没有 .claude/settings.json	创建该文件并加入推荐插件
enabledPlugins 为空	建议添加相关插件
包含多种语言的 Monorepo	建议添加所有匹配的插件
插件不在市场中	标记为“未知”，但不移除
用户拒绝更改	尊重用户决定，并提供手动操作说明

Agent 优化

上下文	命令
插件相关性审查	/health:audit
自动修复审查	/health:audit --fix
试运行模式	/health:audit --dry-run
列出已启用的插件	jq -r '.enabledPlugins[]? // empty' .claude/settings.json 2>/dev/null
检测项目语言	find . -maxdepth 1 \( -name 'package.json' -o -name 'Cargo.toml' -o -name 'pyproject.toml' \) -exec basename {} \;

标志

标志	说明
--fix	应用推荐的更改（需确认）
--dry-run	显示将进行的更改，但不做修改
--verbose	显示每项决策的详细理由

另请参阅

• /health:plugins - 修复插件注册表问题
• /health:check - 完整诊断扫描
• /configure:claude-plugins - 初始插件设置