前面已经写好了 Skill 文件,接下来要解决的是“文件如何变成运行时可用的能力”。下图把文件目录、Loader、Registry 和 Agent 放在一条线上,能帮助我们理解为什么仅有 SKILL.md 还不够。
![图片[1]-小节三:实现 SkillLoader 和 SkillRegistry——把 Skill 从文件系统真正加载进 Agent-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1729.png)
SkillLoader 负责从目录中找到并读取文件;SkillRegistry 则可以在此基础上管理可用 Skill 及其元数据。这里先用最小 Loader 实现文件发现与加载,后面再讨论 Registry 的触发条件、优先级等扩展职责,不必把所有能力都塞进一个类。
现在开始动手。
我们先把目录放在:
project_root/
└── skills/
然后实现:
SkillLoader
SkillRegistry
Skill 数据结构
from dataclasses import dataclass
from pathlib import Path
@dataclass
class Skill:
name: str
path: Path
content: str
完整可运行 Loader
这段代码已经实现:
列出 Skill
加载 Skill
读取 SKILL.md
Registry 有什么用?
如果 SkillLoader 只是文件读取。
Registry 可以负责:
Skill 元数据
触发条件
优先级
版本
作用域
Registry 有什么用?
如果 SkillLoader 只是文件读取。
Registry 可以负责:
Skill 元数据
触发条件
优先级
版本
作用域
例如:
python-debug
keywords:
- traceback
- pytest
- ImportError
- TypeError
Data Analysis:
data-analysis
keywords:
- 收入
- 指标
- 下降
- 转化率
- 下钻
这样可以做第一版:
基于关键词的 Skill Selection。
真实系统以后再让 LLM 选择。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END
















请登录后查看评论内容