Agent Skills Collection使用教程：模块化AI Agent技能组合开发指南

发布日期：2026-08-13 | 分类：AI工具教程

项目简介

Agent Skills Collection是GitHub新开源的模块化Agent技能合集（204星）。把AI Agent能力拆成独立技能模块，开发者像搭积木一样组合，快速构建功能完整的Agent。跨框架兼容（OpenAI Agents SDK / LangGraph / CrewAI等）。

环境要求

• Python ≥ 3.10
• 大模型API Key

第一步：安装

pip install agent-skills-collection

# 或从源码安装
git clone https://github.com/oliverb-io1902e8/agent-skills-collection.git
cd agent-skills-collection
pip install -e .

第二步：浏览可用技能

from agent_skills import SkillRegistry

# 列出所有技能
registry = SkillRegistry()
for skill in registry.list_skills():
    print(f"{skill.name}: {skill.description}")

# 输出示例：
# web_search: 搜索互联网获取信息
# code_executor: 执行Python代码
# file_manager: 文件读写操作
# calculator: 数学计算
# translator: 多语言翻译
# summarizer: 文本摘要
# data_analyzer: 数据分析
# email_sender: 发送邮件
# ...

第三步：注册技能到Agent

from agent_skills import SkillRegistry
from openai import OpenAI

registry = SkillRegistry()

# 注册需要的技能
skills = registry.load([
    "web_search",
    "code_executor", 
    "file_manager",
    "calculator"
])

# 生成OpenAI function calling格式
tools = [skill.to_openai_tool() for skill in skills]

client = OpenAI()
response = client.chat.completions.create(
    model="gpt-5.6",
    messages=[{"role": "user", "content": "搜索今天的AI新闻并保存到文件"}],
    tools=tools
)

# 处理tool_calls
for tool_call in response.choices[0].message.tool_calls:
    skill = registry.get(tool_call.function.name)
    result = skill.execute(**json.loads(tool_call.function.arguments))
    print(f"{tool_call.function.name}: {result}")

第四步：组合多技能Agent

# 创建一个研究助手Agent
research_skills = registry.load([
    "web_search",        # 搜索
    "summarizer",        # 摘要
    "translator",        # 翻译
    "file_manager",      # 文件操作
    "data_analyzer"      # 数据分析
])

agent = Agent(
    name="研究助手",
    model="claude-sonnet-5",
    skills=research_skills,
    system_prompt="""你是一个研究助手。
    1. 搜索获取信息
    2. 翻译外文内容
    3. 生成摘要
    4. 分析数据趋势
    5. 保存报告到文件"""
)

agent.run("调研2026年AI Agent市场趋势，生成中文报告")

第五步：自定义技能开发

from agent_skills import Skill, SkillResult

class CustomDatabaseSkill(Skill):
    """查询数据库技能"""
    
    name = "database_query"
    description = "执行SQL查询并返回结果"
    parameters = {
        "type": "object",
        "properties": {
            "sql": {"type": "string", "description": "SQL查询语句"}
        },
        "required": ["sql"]
    }
    
    def __init__(self, db_connection_string):
        self.db = db_connection_string
    
    def execute(self, sql: str) -> SkillResult:
        # 执行查询
        import sqlite3
        conn = sqlite3.connect(self.db)
        cursor = conn.execute(sql)
        rows = cursor.fetchall()
        conn.close()
        return SkillResult(success=True, data=rows)

# 注册自定义技能
registry.register(CustomDatabaseSkill("mydata.db"))

技能目录结构

agent-skills-collection/
├── src/
│   ├── web_search.py       # 搜索技能
│   ├── code_executor.py    # 代码执行
│   ├── file_manager.py     # 文件管理
│   ├── calculator.py       # 计算器
│   ├── translator.py       # 翻译
│   └── ...
├── custom/                  # 自定义技能目录
├── tests/                   # 测试
└── examples/                # 示例

相关阅读

• Agent Skills机制详解
• 2026 Agent框架选型

📚 常见问题

Agent Skills Collection使用是什么？

Agent Skills Collection是GitHub新开源的模块化Agent技能合集（204星）。把AI Agent能力拆成独立技能模块，开发者像搭积木一样组合，快速构建功能完整的Agent。跨框架兼容（OpenAI Agents SDK / LangGraph / CrewAI等）。

如何上手Agent Skills Collection使用？

Agent Skills机制详解