name: skill-auditor description: 审计和验证技能定义的质量、完整性和最佳实践。用于审查现有技能的格式是否正确、评估技能是否应拆分为子技能，或确保技能遵循既定规范。

技能审计员

此技能用于审计其他技能的质量、完整性和对最佳实践的遵守情况。它验证技能结构、评估内容质量，并推荐改进方案或分解为子技能。

何时使用

应在以下情况触发此技能：

审查现有技能是否存在质量问题
检查技能是否遵循正确的格式规范
评估技能是否应拆分为子技能
对项目中的所有技能进行批量审计
在打包或分发前验证技能

工作流程

步骤1：发现技能

列出 .claude/skills/ 目录中的所有技能：

ls -la .claude/skills/

对于每个技能目录，验证其是否包含必需的 SKILL.md 文件。

步骤2：运行自动化验证

执行审计脚本以检查结构要求：

python .claude/skills/skill-auditor/scripts/audit_skills.py .claude/skills/

脚本验证以下内容：

YAML前置元数据的存在和必填字段
描述质量（长度、具体性）
字数限制（建议<5000字）
未完成占位符检测
空目录警告
脚本可执行性

步骤3：手动质量审查

针对每个技能，根据以下标准进行评估：

前置元数据质量：

name：使用连字符，具有描述性
description：50+字符，具体说明触发条件，无占位符

内容结构：

清晰的“何时使用”部分，包含具体触发条件
具有可操作步骤的工作流程
捆绑资源有适当文档记录

分解分析：

评估技能是否处理>3个不同关注点
检查技能是否超过5000字
识别可重用的组件

步骤4：生成审计报告

为每个技能生成结构化报告：

## 技能：[名称]

### 验证结果
- 前置元数据：通过/失败
- 结构：通过/失败
- 字数：X字（通过/警告/失败）
- 未完成占位符：发现X个

### 质量评分：X/10

### 建议
1. [具体改进]
2. [另一项改进]

### 分解分析
- 应拆分：是/否
- 原因：[解释]
- 建议的子技能：[如适用，列出]

步骤5：应用修复

对于自动化修复，使用带 --fix 标志的审计脚本：

python .claude/skills/skill-auditor/scripts/audit_skills.py .claude/skills/ --fix

对于手动改进，直接编辑SKILL.md文件，遵循建议。

审计标准参考

有关详细评分标准和分解指南，请参阅 references/audit-criteria.md。

技能审计员 skill-auditor