📄 SKILL.md

🏠 首页 / skills / auto-skill-builder
⬇️ 下载文件

name: auto-skill-builder
description: 自动构建 Claude AI Skills，结合 skill-seekers 自动生成和 skill-creator 最佳实践。支持从文档、GitHub 仓库、PDF 一键生成专业 Skill。

Auto Skill Builder - 自动技能构建器

功能

整合 skill-seekers + skill-creator 的完整工作流：

  1. 自动抓取 - 从文档/仓库/PDF 生成基础内容
  2. AI 增强 - 自动生成优质 SKILL.md
  3. 质量优化 - 应用 skill-creator 最佳实践
  4. 打包发布 - 生成可部署的 Skill

使用场景

场景 命令
从文档创建 Skill auto-skill-builder create --type docs --url https://react.dev --name react
从 GitHub 创建 Skill auto-skill-builder create --type github --repo facebook/react --name react
从 PDF 创建 Skill auto-skill-builder create --type pdf --file docs/manual.pdf --name myskill
统一抓取 (含冲突检测) auto-skill-builder create --type unified --config configs/react_unified.json

快速开始

方式 1: 从文档创建

# 基本用法
auto-skill-builder create --type docs --url https://react.dev --name react

# 带 AI 增强
auto-skill-builder create --type docs --url https://react.dev --name react --enhance

# 自定义描述
auto-skill-builder create --type docs --url https://vuejs.org --name vue \
  --description "Vue.js 3 渐进式框架"

方式 2: 从 GitHub 创建

# 基本抓取
auto-skill-builder create --type github --repo facebook/react --name react

# 包含 Issues 和代码分析
auto-skill-builder create --type github --repo django/django --name django \
  --include-issues \
  --include-code \
  --enhance

# 需要认证
export GITHUB_TOKEN=ghp_your_token
auto-skill-builder create --type github --repo mycompany/private-repo --name internal-tool

方式 3: 从 PDF 创建

# 基本提取
auto-skill-builder create --type pdf --file docs/manual.pdf --name myskill

# 提取表格
auto-skill-builder create --type pdf --file docs/manual.pdf --name myskill \
  --extract-tables

# OCR 扫描 PDF
auto-skill-builder create --type pdf --file docs/scanned.pdf --name myskill --ocr

方式 4: 统一抓取 (文档+代码)

# 使用预设统一配置
auto-skill-builder create --type unified --config configs/react_unified.json

# 查看冲突检测结果
auto-skill-builder analyze --directory output/react/

完整工作流示例

# 1. 创建基础 Skill (使用 skill-seekers)
auto-skill-builder create --type docs \
  --url https://react.dev \
  --name react \
  --enhance

# 2. 检查生成质量
auto-skill-builder quality --directory output/react/

# 3. 优化 (应用 skill-creator 最佳实践)
auto-skill-builder optimize --directory output/react/ \
  --remove-redundancy \
  --add-examples

# 4. 打包
auto-skill-builder package --directory output/react/

# 5. 安装到 OpenClaw
auto-skill-builder install --path output/react.zip --to openclaw

子命令

create - 创建 Skill

auto-skill-builder create --type <docs|github|pdf|unified> [options]

# 选项
--type          类型: docs, github, pdf, unified
--url           文档 URL (docs)
--repo          GitHub 仓库 (github)
--file          PDF 文件路径 (pdf)
--config        配置文件路径 (unified)
--name          Skill 名称
--description   Skill 描述
--enhance       AI 增强
--enhance-local 本地增强 (推荐)
--output        输出目录 (默认: output/)
--async         异步模式 (3x 更快)
--workers       并行数 (默认: 8)

analyze - 分析 Skill

auto-skill-builder analyze --directory <path>

# 分析内容
- 检查 SKILL.md 结构
- 检测缺失的字段
- 代码示例完整性
- 冲突检测 (统一抓取)

optimize - 优化 Skill

auto-skill-builder optimize --directory <path> [options]

# 选项
--remove-redundancy  移除冗余内容
--add-examples       添加代码示例
--fix-frontmatter    修复 YAML frontmatter
--add-references     添加参考文档
--enhance-redirect   增强导航指引

quality - 质量检查

auto-skill-builder quality --directory <path>

# 检查项目
✅ SKILL.md 结构完整性
✅ YAML frontmatter 格式
✅ 代码示例覆盖率
✅ 文档链接有效性
✅ 引用文件存在性

package - 打包 Skill

auto-skill-builder package --directory <path> [options]

# 选项
--format     格式: zip (默认), tar.gz
--upload     上传到 Claude (需要 API key)
--validate   打包前验证

install - 安装 Skill

# 安装到 OpenClaw
auto-skill-builder install --path <skill-path> --to openclaw

# 安装到特定目录
auto-skill-builder install --path output/react/ --to /path/to/skills/

应用 skill-creator 最佳实践

1. 简洁原则

自动优化：

  • 移除重复内容
  • 精简冗长描述
  • 保留核心信息

2. 渐进式披露

自动组织：

skill-name/
├── SKILL.md (核心流程)
└── references/
    ├── quick-start.md
    ├── api-reference.md
    ├── examples.md
    └── troubleshooting.md

3. 适当自由度

根据场景选择：

  • 低自由度: 固定流程的命令 (如 create --type docs)
  • 中自由度: 可配置的参数 (如 --enhance-local)
  • 高自由度: 手动编辑 (优化后的 SKILL.md)

预设配置

预设 命令
React auto-skill-builder create --type docs --url https://react.dev --name react
Vue auto-skill-builder create --type docs --url https://vuejs.org --name vue
Godot auto-skill-builder create --type docs --url https://docs.godotengine.org --name godot
Django auto-skill-builder create --type docs --url https://docs.djangoproject.com --name django
FastAPI auto-skill-builder create --type docs --url https://fastapi.tiangolo.com --name fastapi

故障排除

问题 解决方案
抓取超时 --async --workers 8
速率限制 auto-skill-builder config --github
AI 增强失败 --enhance-local 本地增强
打包失败 auto-skill-builder quality 先检查
安装失败 检查路径和权限

依赖工具

工具 用途
skill-seekers 文档抓取、代码分析、冲突检测
Claude Code 本地 AI 增强
tar/zip 打包 Skill

相关文档