skill_gen:基于 Python 的 Skill 文件自动生成工具项目

生成skill的Agent

Branch2Tags0
FilesLast commitLast update
10 months ago
9 months ago
9 months ago
10 months ago
9 months ago
10 months ago
10 months ago
10 months ago
10 months ago
9 months ago
9 months ago
10 months ago
10 months ago

Skill 生成操作指南

本项目提供自动化SKILL生成能力,旨在帮助开发者快速将案例文档/技术报告 (.pdf/.txt/.md) 转换为符合格式规范的 Skill 文件,并自动存储至指定的系统目录。

🚀 功能特性

  • 自动转换:一键将原始文本解析并生成标准 Skill 格式。
  • 脚本提取:自动识别文档中的长片段脚本,并结构化输出到 scripts/目录,生成调用说明文档,便于复用与编排。
  • 自动分发:根据环境变量配置,自动将生成的 Skill 文件放置到目标存储目录。

📄目录结构

skill_gen/
├── app.py                 # 程序主入口
├── batch_extractor.py     # 批量提取skill程序入口
├── config.yaml            # 项目配置文件(第三方库路径、Skill模板路径等)
├── .env.example           # 环境变量配置样例(如API Key、DeepSeek API密钥等)
├── requirements.txt       # Python 依赖包列表
├── README.md              # 项目说明文档
├── template/              # Skill 模板目录
├── src/                   # 源代码目录
│   ├── config/            # 配置管理模块
│   ├── core/              # 核心功能模块
│   └── utils/             # 工具函数模块
├── test_case/             # 测试数据目录
└── third_party/           # 第三方依赖仓库

🛠️ 环境准备

  1. 拉取项目
git clone --recursive <project-repo.git>
git submodule init # 本项目依赖第三方工具,需要拉取对应子模块
git submodule update # 若已经拉取,后续可以采用该命令更新子模型代码
  1. 配置运行环境 使用如下命令安装Python依赖包
pip install -r requirements.txt
  1. 配置文件设置

3.1 项目配置文件 (config.yaml)

  • config.yaml 用于配置项目运行所需的路径信息
  • 主要配置项:
    • third_party_path: 第三方库路径配置(如 Skill_Seekers 库路径)
    • skill_template_file: Skill 模板文件路径
  • 通常无需修改,除非你自定义了模板路径或第三方库位置

3.2 环境变量配置 (.env)

  • 拷贝.env.example 到.env用于环境变量配置
cp .env.example .env
  • 修改.env中的环境变量实际值,主要包括:
    • DeepSeek API 密钥和相关配置
    • Langfuse 相关环境变量(如使用)
    • CUSTOM_SKILL_PATHS: Skill 文件的存储路径(必须配置)

📚 文档

  • PDF 提取功能指南 - 详细介绍 PDF 代码提取功能的原理、使用方法和局限性
    • 代码块检测方法(字体、缩进、模式)
    • 跨页合并机制
    • 语言检测系统(20+ 种语言)
    • 质量评分系统
    • 故障排除指南

📦 第三方依赖仓库

本项目依赖以下第三方工具库:

  • Skill_Seekers (third_party/Skill_Seekers/): 用于技能提取和分析的工具库,提供了丰富的配置和工具来帮助从代码库中提取技能信息。

    • 主要功能:

      • 代码库分析和技能提取
      • 配置文件解析
      • 多种数据源支持(GitHub、本地文件等)
      • MCP (Model Context Protocol) 服务器支持
    • 更多信息请参考:third_party/Skill_Seekers/README.md

注意:第三方依赖仓库通常通过 Git 子模块管理,在拉取项目时请使用 git clone --recursive 或执行 git submodule init && git submodule update 来获取完整的依赖代码。

📝使用示例

本项目的程序入口为app.py。假设你有一个名为 oom_故障诊断案例.pdf 的文件,想要生成 Skill:

  • 首先,运行如下命令,执行Skill生成程序
python app.py
  • 然后,根据提示输入需要转换的案例文档oom_故障诊断案例.pdf的完整路径

  • 执行后,程序将处理文本并将其生成的 Skill 文件保存至你配置的 CUSTOM_SKILL_PATHS 目录中。

  • 最后,可以打开CUSTOM_SKILL_PATHS中生成的结果进行查看,确认生成的效果

Introduction

生成skill的Agent

Customize your domain