Book Skill Creator - 技能工厂

任务目标

• 本 Skill 用于：工厂化批量创建和管理技能包，提供从需求分析到自动化生成的完整流程
• 能力包含：
  • 官方文档100%覆盖：深度解析官方文档，提取所有API、配置、示例
  • 网络搜索最佳实践：搜索行业经验，提取优秀方案并总结为模板
  • 模板自动生成：基于搜索结果自动生成可复用模板
  • 知识沉淀管理：版本化模板库，支持检索和复用
  • 子技能自动化构建：批量创建和依赖管理
  • 框架使用规范：内置框架指南和最佳实践
• 触发条件：用户需要从官方文档生成技能、搜索行业最佳实践、批量创建技能包、管理和复用模板

前置准备

• 依赖说明：scripts 脚本所需的依赖包及版本

  pyyaml>=6.0
  networkx>=3.0
  beautifulsoup4>=4.12.0  # 文档解析可选
  semver>=3.0.0  # 模板版本管理

操作步骤

标准流程

1. 官方文档100%覆盖解析（新增）

适用场景：用户提供官方文档，需要完整提取所有功能

执行步骤：

1. 文档格式检测

   • 自动检测文档格式（Markdown/HTML/OpenAPI）
   • 选择合适的解析器

2. 深度内容提取

   • 提取所有API端点（路径、方法、参数、响应）
   • 提取所有代码示例
   • 提取所有配置项
   • 提取章节结构

3. 自动生成技能

   • 生成完整的SKILL.md（包含所有API说明）
   • 生成API客户端脚本（支持所有端点）
   • 生成API参考文档
   • 生成代码示例文档

4. 质量验证

   • 验证覆盖率是否100%
   • 检查提取内容的完整性
   • 测试生成的脚本

调用方式：

python scripts/docs_parser.py \
  --docs-path /path/to/docs \
  --output /path/to/skill \
  --format auto  # 或 markdown/html/openapi

输出报告：

技能名称: MyAPI
API端点: 25个
代码示例: 12个
配置项: 8个
覆盖率: 100%

2. 网络搜索与最佳实践提取（新增）

适用场景：需要查找行业最佳实践，生成可复用模板

执行步骤：

1. 多维度搜索

   • 搜索关键词："{技术} best practices"
   • 搜索关键词："{技术} production ready"
   • 搜索关键词："{技术} implementation patterns"

2. 结果过滤和评分

   • 按来源权威性过滤
   • 按代码质量评分
   • 按更新时间排序
   • 去除重复内容

3. 内容提取

   • 提取代码示例
   • 提取配置模板
   • 提取最佳实践建议
   • 提取常见问题解决方案

4. 模板生成

   • 基于提取内容生成标准化模板
   • 包含代码、配置、文档
   • 自动评分（完整性、实用性、可复用性）

调用方式：

python scripts/web_searcher.py \
  --tech FastAPI \
  --query "api client best practices" \
  --category api \
  --output ./assets/template-library

输出结果：

• 提取的方案列表
• 生成的模板文件
• 模板评分报告

3. 模板管理与知识沉淀（新增）

适用场景：管理已生成的模板，支持版本控制和检索

执行步骤：

1. 模板添加

   • 手动添加模板
   • 从网络搜索器自动添加
   • 指定版本、标签、复杂度

2. 版本管理

   • 语义化版本号
   • 版本历史记录
   • 版本差异对比

3. 模板检索

   • 按技术筛选
   • 按分类筛选
   • 按评分筛选
   • 关键词搜索

4. 模板使用

   • 查看模板详情
   • 导出模板文件
   • 集成到项目

调用方式：

# 列出所有模板
python scripts/template_manager.py list --tech FastAPI --min-score 0.8

# 搜索模板
python scripts/template_manager.py search --query "api client"

# 获取模板详情
python scripts/template_manager.py get --id "FastAPI/api/api-client"

# 导出模板
python scripts/template_manager.py export \
  --id "FastAPI/api/api-client" \
  --output ./my-project

4. 批量创建与自动化构建

适用场景：批量创建多个相关技能

执行步骤：

1. 编写配置文件
2. 调用批量创建脚本
3. 分析依赖关系
4. 按顺序构建

调用方式：

python scripts/batch_create.py \
  --config config.json \
  --output ./skills

5. 质量验收与验证

执行步骤：

1. 验证技能结构
2. 分析依赖关系
3. 测试执行
4. 生成报告

可选分支

• 从官方文档生成技能：使用 docs_parser.py 实现100%覆盖
• 搜索最佳实践：使用 web_searcher.py 提取行业经验
• 管理模板库：使用 template_manager.py 管理知识沉淀
• 批量创建技能：使用 batch_create.py 批量生成
• 验证技能质量：使用 skill_validator.py 验证规范

资源索引

必要脚本

文档解析脚本（新增）

• scripts/docs_parser.py
  • 用途：官方文档深度解析，实现100%覆盖
  • 参数：--docs-path（文档路径）、--output（输出目录）、--format（格式）
  • 支持格式：Markdown、HTML、OpenAPI
  • 输出：完整技能包（SKILL.md、脚本、参考文档）
  • 详情见：references/docs-parsing-guide.md

网络搜索脚本（新增）

• scripts/web_searcher.py
  • 用途：搜索行业最佳实践，提取优秀方案
  • 参数：--tech（技术名）、--query（查询）、--category（分类）、--output（输出目录）
  • 功能：多维度搜索、内容提取、模板生成、自动评分
  • 输出：模板文件和评分报告

模板管理脚本（新增）

• scripts/template_manager.py
  • 用途：模板版本管理、检索、导出
  • 操作：add、update、delete、list、search、get、export
  • 功能：版本控制、评分系统、分类索引
  • 详情见：references/template-library.md

批量创建脚本

• scripts/batch_create.py
  • 用途：批量创建技能包
  • 参数：--config（配置文件）、--output（输出目录）
  • 输入：JSON格式配置文件

验证脚本

• scripts/skill_validator.py
  • 用途：验证技能是否符合规范
  • 参数：--skill-path（技能目录路径）
  • 输出：验证结果和问题列表

依赖分析脚本

• scripts/dependency_analyzer.py
  • 用途：分析技能间的依赖关系
  • 参数：--base-dir（基础目录）
  • 输出：依赖关系图和构建顺序

领域参考

文档解析指南（新增）

• references/docs-parsing-guide.md
  • 何时读取：需要了解文档解析详细流程
  • 内容：支持的格式、解析能力、覆盖率保证、使用示例

模板库索引（新增）

• references/template-library.md
  • 何时读取：需要了解模板管理和使用方法
  • 内容：模板分类、评分系统、管理命令、检索方法、最佳实践

技能规范

• references/skill-specs.md
  • 何时读取：需要了解详细规范、配置文件格式
  • 内容：命名规范、目录结构、SKILL.md格式、验证规则

框架指南

• references/frameworks-guide.md
  • 何时读取：选择技术框架、了解框架使用方法
  • 内容：常用框架分类、使用场景、配置方法、代码模式

最佳实践

• references/best-practices.md
  • 何时读取：查找最佳实践方案
  • 内容：方案分类库、问题场景、解决方案、代码示例

输出资产

技能模板

• assets/skill-templates/api-skill.md
• assets/skill-templates/data-process.md
• assets/skill-templates/workflow.md

代码脚手架

• assets/code-scaffolds/python-script.py
• assets/code-scaffolds/bash-script.sh

模板库（新增）

• assets/template-library/
  • 按技术分类存储模板
  • 包含版本历史
  • 模板索引文件

注意事项

官方文档解析

覆盖率保证

• 100%覆盖原则：提取文档中所有API端点、代码示例、配置项
• 格式标准化：统一API端点格式（如GET /api/path）
• 完整性验证：检查解析报告，确保覆盖率100%
• 缺失处理：手动补充解析器未提取的内容

文档准备

• 确保文档格式正确
• API端点使用统一格式
• 代码块包含语言标识
• 配置项使用标准格式

网络搜索

质量控制

• 来源权威性：优先选择官方文档、知名技术博客
• 代码质量：提取的代码应包含错误处理和注释
• 时效性：优先选择近期更新的内容
• 去重处理：避免重复的方案

模板生成

• 标准化格式：统一模板结构和命名
• 自动评分：基于完整性、实用性、可复用性评分
• 版本管理：使用语义化版本号
• 文档完善：包含使用说明和示例

模板管理

版本管理

• 使用语义化版本（Semantic Versioning）
• 记录版本变更日志
• 保持向后兼容
• 定期更新依赖

质量维护

• 定期审查模板质量
• 收集用户反馈
• 优化评分算法
• 清理低质量模板

使用示例

示例1：从官方文档100%覆盖生成技能（新增）

功能说明：解析官方文档，提取所有内容生成完整技能

执行方式：脚本调用

步骤：

# 1. 解析Markdown文档
python scripts/docs_parser.py \
  --docs-path /path/to/fastapi-docs.md \
  --output ./skills/fastapi-complete

# 2. 查看解析报告
# 技能名称: FastAPI Documentation
# API端点: 25个
# 代码示例: 12个
# 配置项: 8个
# 覆盖率: 100%

# 3. 验证生成的技能
python scripts/skill_validator.py \
  --skill-path ./skills/fastapi-complete

示例2：搜索行业经验生成模板（新增）

功能说明：搜索FastAPI最佳实践，生成可复用模板

执行方式：脚本调用 + 智能体补充

步骤：

# 1. 搜索最佳实践
python scripts/web_searcher.py \
  --tech FastAPI \
  --query "api client best practices" \
  --category api \
  --output ./assets/template-library

# 2. 查看生成的模板
python scripts/template_manager.py list --tech FastAPI

# 3. 导出模板使用
python scripts/template_manager.py export \
  --id "FastAPI/api/api-client" \
  --output ./my-project

示例3：管理和检索模板库（新增）

功能说明：管理模板库，检索高质量模板

执行方式：脚本调用

步骤：

# 1. 列出所有FastAPI模板
python scripts/template_manager.py list --tech FastAPI

# 2. 筛选高质量模板
python scripts/template_manager.py list \
  --tech FastAPI \
  --min-score 0.8 \
  --complexity advanced

# 3. 搜索特定模板
python scripts/template_manager.py search --query "authentication"

# 4. 查看模板详情
python scripts/template_manager.py get --id "FastAPI/middleware/auth"

示例4：批量创建技能

功能说明：批量创建多个相关技能

执行方式：脚本调用

步骤：

# 1. 准备配置文件 config.json
{
  "skills": [
    {"name": "user-api", "type": "api", "description": "用户API"},
    {"name": "auth-service", "type": "workflow", "description": "认证服务"}
  ]
}

# 2. 批量创建
python scripts/batch_create.py \
  --config config.json \
  --output ./skills

# 3. 分析依赖关系
python scripts/dependency_analyzer.py \
  --base-dir ./skills

质量门槛与最佳实践

文档解析

• 覆盖率100%
• 所有API端点已提取
• 所有代码示例已提取
• 所有配置项已提取
• 生成的SKILL.md完整
• 客户端脚本可执行

网络搜索

• 来源权威可靠
• 代码质量高
• 模板格式标准
• 评分合理
• 文档完善

模板管理

• 版本号规范
• 分类清晰
• 评分准确
• 可检索性强
• 易于集成

框架使用规范速查

Web框架

• FastAPI：高性能API，异步支持
• Flask：轻量级应用，灵活扩展
• Django：全栈应用，包含ORM

数据处理

• Pandas：数据分析
• NumPy：数值计算
• PyTorch/TensorFlow：深度学习

详细使用方法见 references/frameworks-guide.md

常见问题

Q1: 如何确保官方文档100%覆盖？

A:

1. 使用 docs_parser.py 解析文档
2. 检查解析报告中的覆盖率
3. 验证生成的SKILL.md包含所有API
4. 手动补充解析器未提取的内容

Q2: 网络搜索如何确保质量？

A:

1. 使用权威关键词（best practices, production ready）
2. 按来源权威性过滤
3. 自动评分系统评估
4. 手动审查和补充

Q3: 模板如何保持最新？

A:

1. 定期使用 web_searcher.py 搜索新实践
2. 更新模板版本号
3. 收集用户反馈
4. 优化评分算法

Q4: 如何提高复用率？

A:

1. 标准化模板格式
2. 提供完整文档
3. 包含使用示例
4. 支持灵活定制