GeoLab-org/source-to-skill

source-to-skill 是做什么的？

分析源材料并将可复用的知识编译成智能体技能。

概述

此技能自动提取源材料（例如技术文档、API 规范、代码库）中的可复用知识，并将其编译为结构化的智能体技能定义。它确保智能体能够在不同平台间高效复用知识。

工作原理

1. 输入: 接受源材料（文本、Markdown、代码片段等）。
2. 分析: 识别源材料中的关键模式、API 用法、配置和领域特定知识。
3. 提取: 分离出可复用的知识（例如常见任务、函数、提示词）。
4. 编译: 生成标准化的技能文件（SKILL.md 格式），包含元数据、描述和使用说明。

平台支持

• Claude Code
• Cursor
• Codex
• 任何兼容 SKILL.md 格式的智能体平台

使用指南

前置依赖

• Python 3.8+
• pyyaml 库（用于解析 YAML）

安装

pip install pyyaml

基本用法

1. 准备源材料文件（例如 source.md）。
2. 运行分析工具：

   python analyze.py --input source.md --output skill
   

3. 生成的技能文件保存在 skill/ 目录下。

示例

源材料: 一个包含 REST API 端点的文档。

生成的技能:

# my-api-skill

提供与 MyAPI 交互的端点。

## 操作

- `GET /users`: 列出用户
- `POST /users`: 创建用户

配置

技能生成可以通过环境变量定制：

• INPUT_FORMAT: 源材料格式（markdown, text, yaml）。默认为 markdown。
• OUTPUT_DIR: 技能生成目录。默认为 ./skill/。
• SKILL_NAME: 技能名称。若未指定，则从源材料自动推断。

贡献

欢迎提交 Pull Request 以改进分析器或添加新的源格式支持。

许可证

MIT