生成skill的Agent
| Files | Last commit | Last update |
|---|---|---|
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 months ago | ||
| 9 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/ # 第三方依赖仓库
🛠️ 环境准备
- 拉取项目
git clone --recursive <project-repo.git>
git submodule init # 本项目依赖第三方工具,需要拉取对应子模块
git submodule update # 若已经拉取,后续可以采用该命令更新子模型代码
- 配置运行环境 使用如下命令安装Python依赖包
pip install -r requirements.txt
- 配置文件设置
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中生成的结果进行查看,确认生成的效果