Skill 合规性检查工具

任务目标

• 本 Skill 用于:检查一个或多个 Skill 是否符合最佳实践规范
• 能力包含:读取 Skill 文件、验证命名、前言区、目录结构、文件清理、依赖元数据等维度、生成检查报告
• 触发条件:用户需要验证 Skill 质量时，如 “检查所有 skill 是否符合规范”、”验证 skill 目录结构”、”检查这个 skill 是否符合要求”

前置准备

• 无特殊依赖

操作步骤

标准流程

步骤 1：读取检查规范

• 阅读 references/checklist.md，了解完整的 19 项检查清单
• 阅读 references/quality-standards.md，了解各项检查的背景说明

步骤 2：检查单个 Skill

• 阅读目标 Skill 的 SKILL.md 文件
• 检查目录结构和文件列表
• 按照 checklist.md 中的 19 项检查清单逐项验证：
  1. 命名规范检查（3 项）：目录名格式、目录名后缀、最佳实践后缀
  2. 前言区检查（5 项）：name 字段存在、name 与目录名一致、description 存在、description 单行、description 长度
  3. 目录结构检查（3 项）：SKILL.md 存在、固定结构目录、空目录检查
  4. 文件清理检查（1 项）：临时文件清理
  5. 依赖元数据检查（2 项）：dependency.python 格式、dependency.system 格式
  6. README.md 记录检查（5 项）：README.md 存在、skills/ 目录存在、Skill 在 skills/ 中、Skill 已记录、记录格式正确

步骤 3：批量检查多个 Skill（自动遍历）

• 检查 Skills 是否位于 skills/ 目录下
• 使用目录遍历命令列出目标目录下所有 Skill：

  find /workspace/projects/skills -maxdepth 1 -name "SKILL.md" -exec dirname {} \;
  

• 获取所有 Skill 目录列表后，对每个 Skill 重复步骤 2 的检查流程

步骤 4：生成检查报告

• 汇总所有检查结果
• 对每个 Skill 生成报告，包含：
  • 19 项检查的明细（pass/warning/error）
  • 总体状态（pass/warning/error）
  • 修复建议
• 提供总体统计：Skill 数量、通过率、最常见问题

步骤 5：问题修复（可选）

• 如果检查发现问题，根据用户需求执行修复：
  • 自动修复：对于可安全自动修复的问题（如删除临时文件、删除空目录），直接执行修复
  • 人工确认：对于需要判断的问题（如重命名目录、修改 description、修改 name 字段），提供修复建议，等待用户确认
• 参考 references/quality-standards.md 中的检查级别说明和修复建议
• 修复后重新验证，确认问题已解决且没有引入新问题

资源索引

• 检查清单:见 references/checklist.md
  • 内容:完整的 19 项 Skill 检查清单（命名规范、前言区、目录结构、文件清理、依赖元数据、README.md 记录）
  • 何时读取:开始检查前阅读，检查过程中逐项对照
• 质量标准:见 references/quality-standards.md
  • 内容:各项检查的背景说明、通过标准定义、检查级别说明（pass/warning/error）
  • 何时读取:理解检查项背景、确定修复优先级时参考

注意事项

• 批量检查时，建议分批处理大量 Skills
• 修复问题后必须重新验证

使用示例

示例 1：检查单个 Skill

用户：”检查 check-all-skills 这个 skill 是否符合规范”

执行步骤：

1. 读取检查规范
2. 读取 /workspace/projects/check-all-skills/SKILL.md
3. 检查目录结构
4. 逐项验证检查清单
5. 输出检查报告

示例 2：批量检查多个 Skill（自动遍历）

用户：”检查 /workspace/projects 目录下所有 skill 是否符合规范”

执行步骤：

1. 读取检查规范
2. 使用步骤 3 中的命令列出该目录下所有 Skills
3. 对每个 Skill 执行步骤 2 的检查流程
4. 生成汇总报告

示例 3：检查并自动修复问题

用户：”检查所有 skill 是否符合规范，发现问题自动修复”

执行步骤：

1. 读取检查规范和问题修复指南
2. 使用步骤 3 中的命令识别当前工作目录下的所有 Skills
3. 对每个 Skill 执行步骤 2 的检查流程
4. 根据步骤 5 执行修复：
   • 可自动修复的：直接执行修复
   • 需要确认的：提供修复建议，询问用户是否同意
5. 修复后重新验证
6. 生成修复报告

示例 4：检查特定维度

用户：”检查 check-all-skills 的命名和目录结构是否符合规范”

执行步骤：

1. 仅检查命名规范相关项目
2. 仅检查目录结构相关项目
3. 输出这两类检查的结果