health-agentic-audit

/health:agentic-audit

扫描所有插件技能、命令和 Agent，查找优化 CLI 输出的机会。检查是否缺少 Agentic Optimizations 表格、CLI 命令是否未使用精简标志，以及审查日期是否过期。

标准参考：.claude/rules/agentic-optimization.md 和 .claude/rules/skill-quality.md。

何时使用此技能

在以下情况下使用此技能……	在以下情况下采用其他方法……
审查技能是否符合 Agentic 优化规范	进行常规插件审计（使用 /health:audit）
查找缺失的 Agentic Optimizations 表格	全面检查环境（使用 /health:check）
审查技能中的 CLI 命令模式	处理插件注册表问题（使用 /health:plugins）
检查技能文档质量	更适合手动审查技能
批量更新技能质量标准	只需更新单个技能

上下文

• 插件根目录：!pwd
• 技能文件：!find . -name 'SKILL.md' -o -name 'skill.md'
• 技能文件（全部）：!find . \( -name 'SKILL.md' -o -name 'skill.md' \)
• Agent 文件：!find . -path '*/agents/*.md' -not -name 'README.md'

参数

参数	说明
--fix	为标记的技能添加 Agentic Optimizations 表格框架，并更新 modified 日期
--verbose	显示所有已扫描文件以及详细的模式匹配结果

执行

执行此 Agentic 输出审计：

步骤 1：发现所有插件内容文件

在代码库中查找所有技能、命令和 Agent：

1. 扫描技能：find . -name 'SKILL.md' -o -name 'skill.md'
2. 扫描所有技能变体：find . \( -name 'SKILL.md' -o -name 'skill.md' \)
3. 扫描 Agent：find . -path '*/agents/*.md' -not -name 'README.md'

在报告中按类型（技能、命令、Agent）对每个文件分类。

步骤 2：检查每个技能是否包含 Agentic Optimizations 表格

对于每个技能文件：

1. 搜索匹配 ## Agentic Optimization 的标题（末尾可带或不带 "s"）
2. 搜索 bash/shell 代码块（```bash 或 ```sh）
3. 标记包含 bash 代码块但缺少 Agentic Optimizations 表格的技能

跳过不含任何 bash 代码块的技能（信息类技能）。在详细模式下记录这些技能。

步骤 3：扫描缺少精简标志的裸 CLI 命令

读取所有文件的执行和上下文部分。将命令与 REFERENCE.md 中的裸 CLI 模式进行匹配。

在围栏代码块和反引号上下文命令（! 反引号语法）中搜索这些模式。

步骤 4：检查 frontmatter 日期是否过期

对于每个文件，从 YAML frontmatter 中提取 modified 日期：

1. 从前 20 行解析 modified: YYYY-MM-DD
2. 计算距今的天数
3. 标记 modified 日期超过 90 天的文件

步骤 5：生成审计报告

输出包含以下部分的结构化 Markdown 报告：

1. 缺少 Agentic Optimizations 表格——列出包含 bash 代码块但没有表格的技能
2. 裸 CLI 命令——列出缺少优化标志的命令，包括文件、行号、命令和建议的修复方式
3. 上下文部分问题——列出使用 cat 或产生冗长输出的上下文命令
4. 审查已过期（超过 90 天）——列出 modified 日期已过期的文件
5. 汇总——技能/命令/Agent 扫描总数及发现的问题数

如果指定了 --verbose：还列出所有已扫描文件及其状态（每项检查均标记通过/失败）。

步骤 6：应用修复（如果指定了 --fix）

指定 --fix 时：

1. 为标记的技能添加 Agentic Optimizations 表格框架（插入到最后一个标题之前或文件末尾）。使用 REFERENCE.md 中的框架模板。保留 TODO 条目，供用户填写。
2. 将每个已修改文件 frontmatter 中的 modified 日期更新为今天
3. 报告修改了哪些文件以及添加了什么

提示用户使用实际优化后的命令填写 TODO 条目。

模式检测详情

代码块检测

匹配带围栏的代码块，以识别命令行工具：

```bash
<command>

And inline backtick commands in context sections:

• 标签：!<command>

### Frontmatter Extraction

Use the standard extraction pattern:
```bash
head -20 "$file" | grep -m1 "^modified:" | sed 's/^[^:]*:[[:space:]]*//'

Agentic 优化

上下文	命令
Agentic 审计扫描	/health:agentic-audit
审计并自动修复	/health:agentic-audit --fix
详细输出	/health:agentic-audit --verbose
查找所有技能文件	find . \( -name 'SKILL.md' -o -name 'skill.md' \) 2>/dev/null
检查是否存在 Agentic 优化表格	grep -l "## Agentic Optimizations" $(find . -name 'SKILL.md') 2>/dev/null

另请参阅

• /health:check - 完整诊断扫描
• /health:audit - 插件相关性审计
• .claude/rules/agentic-optimization.md - 优化标准
• .claude/rules/skill-quality.md - 必需的技能章节