用途:自动为技能生成标准化 README 文档,分析 SKILL.md 文件、提取结构与示例、校验质量标准,并输出文档,同时保证技能文档的一致性。
主要能力:
- 单个技能文档生成:依次运行 analyze_skill.py、validate_consistency.py、generate_readme.py。
- 批量文档处理:document_directory.py 支持递归发现、并行校验与文档生成、索引生成和汇总统计,可选用 --output、--no-recursive、--no-index、--no-validate。
- 校验依据 references/consistency-rules.md,检查 frontmatter、描述质量、结构、术语、资源引用和代码示例;严重级别分 ERROR、WARNING、INFO。
必要用法: 分析:python scripts/analyze_skill.py <skill_directory> 校验:python scripts/validate_consistency.py <skill_directory> --verbose 生成:python scripts/generate_readme.py <skill_directory> [output_path] 批量:python scripts/document_directory.py <directory> [options]
质量标准:frontmatter 中 name 小写带连字符;description 50-500 字符,含 when/use;正文至少 100 字符、建议少于 500 行;术语用祈使句,统一大写 Claude,避免模糊词。
适用场景:新技能创建、质量审计、SKILL.md 变更后重生成文档、批量处理技能库、CI/CD 自动化校验。
限制:质量标准和模板来自 references 下的规则文件,具体内容以实际文件为准;未提供收费标准、平台兼容性和更多功能细节,暂未提供。