Agent Skill

Skill核心内容:对应文件夹

每个 Skill 需要一个 SKILL.md 文件,以 --- 标记之间的 YAML 元数据开头,必须包含 name 和 description,后跟 Markdown 指令。

一,核心文件SKILL.md

1,元数据:技能名称name,技能描述和技能使用场景。(name名称和skill文件夹名称相同)

2,正文内容(指令):技能流程,相关信息,文件说明

二,资源文件夹:辅助内容

示例 examples,模板templates,脚本scripts,索引 reference.md

1,Agent Skill 其实就是一个大模型可以随时翻阅的说明文档。大模型翻翻这个说明文档,就知道怎么干活了。

2,按需加载:虽然skill的名称和描述是始終对大模型可见的。但具体的指令内容,只有这个skill被大模型选中后,才会被加载进来给模型看。这样就节省了很多的token。只有选中的那个skill的skill.md文件才会给到模型,说白了就是按需加载。

3,Skill提供过了Reference的概念。Agent Skill中,Reference 是按需加载的外部知识库文件(通常放于 references/ 目录),用于在执行特定任务时为模型补充背景规则、文档或标准,而不常驻上下文,以节省 Token。(条件触发就是Reference)

他的本质是轻量知识外挂‌:避免将所有细节塞进主指令,提升可维护性与上下文效率;‌不执行逻辑‌(区别于 scripts),仅提供可检索信息。如果用户没提到相关内容,大模型也不会读到skill中的相关内容。‌‌Reference是特定条件触发的。

Reference是按需加载的,如果用户没提到与reference相关的内容,那大模型是不会读取它的,这样就达到了节省上下文token的目的。

4,执行逻辑(Script):如何让Agent Skill跑代码? 如果用户提到了"上传","同步","发送到服务器"等,你必须执行upload.py 将脚本上传到服务器。

Agent Skill 中的代码只会被执行,不会被读取。这就意味着哪怕你的脚本写了一万行复杂的业务逻辑,它消耗的模型上下文也几乎为零。智能体只关心脚本的运行方法和运行结果,并不在意脚本的内容。

虽然Reference和Script都属于Agent skill的高级功能,但是他们对于模型上下文的影响是截然不同的。Reference是读,他会把内容加载到上下文里面,所以是会消耗token的。Script是跑,他只会被执行,不会占用模型的上下文。

Agent skill的渐进式披露机制(这个机制一共有三层,每一层的加载机制不太一样)

Agent Skill 的渐进式披露(Progressive Disclosure)机制是一种按层级、按需加载技能信息的上下文优化策略,核心是"先概览、再激活、后执行",避免一次性占用大模型上下文窗口,实现海量技能下的高效、精准推理。‌‌

‌第一层:元数据层(Discovery)‌ ------ 每个 Skill 的 name 和 description(YAML frontmatter)始终常驻系统提示,仅占几十到百余 token,让模型知道"有哪些能力可用";(始终加载)

‌第二层:指令层(Activation)‌ ------ 仅当大模型根据用户请求匹配到某 Skill 后,才动态加载该 Skill 的 SKILL.md 主体内容(通常 <5K tokens),包含具体规则、步骤与示例;(按需加载)

‌第三层:资源层:资源与脚本(Execution)‌ ------包含 参考文档(如 references/)、可执行脚本(如 scripts/)等,仅在指令中明确引用时按需读取或调用,其内容不进入模型上下文(仅结果进入),实现"零隐性开销"。‌‌

mcp与skill的区别:mcp给大模型供给数据,而skill是教会大模型如何处理这些数据(精辟,使用mcp连接mysql,redis,ssh等等都是数据源)。

mcp本质上是一个独立运行的程序,agent skill 本质上是一段说明文档。它们的本质不同决定了适合的场景也是不同的。agent skill更适合跑一些轻量的脚本,适合处理简单的逻辑。在代码执行方面,Agent Skill的安全性和稳定性都不及mcp。

Skills 是 Qoder 中将专业知识打包成可复用功能的机制。每个 Skill 包含一个 SKILL.md 文件,定义技能的描述、指令和可选的辅助文件。

核心特点:

智能调用:模型根据用户请求和 Skill 描述自主决定何时使用。

模块化设计:每个 Skill 专注解决特定类型的任务。

灵活扩展:支持用户级和项目级的自定义 Skill。

适合使用 Skill 的场景:

1,复杂专业任务:需要领域知识的工作流(代码审查、PDF 处理、API 设计)。

2,标准化流程:按固定步骤执行的任务(提交规范、部署流程)。

3,团队知识共享:打包最佳实践供团队使用。

4,重复性工作:频繁执行且需要专业指导的任务。

如何创建技能?

如何安装使用技能?安装社区共享的成熟技能,快速获得开箱即用的功能。

通过 Skills CLI 安装:使用 skills CLI 可以一键安装来自 skills.sh 市场或 GitHub 的第三方 Skills。

在 Qoder IDE 的终端内执行以下命令:

skills.sh 市场安装

npx skills add vercel-labs/agent-browser -a qoder

从 GitHub 仓库安装指定技能

npx skills add https://github.com/anthropics/skills --skill skill-creator -a qoder

playwright skill

‌操控浏览器操作‌:支持点击、填表、上传文件、截图、保持登录态等复杂场景,执行完返回结果、截图和控制台输出,方便你分析问题。

‌跨浏览器测试‌:支持 Chromium、Firefox、WebKit 三大浏览器引擎,确保你的应用在不同浏览器下表现一致。

相关推荐
武子康3 小时前
调查研究-198 Agent 到底该记住什么?读懂《What Must Generalist Agents Remember?》
人工智能·openai·agent
武子康5 小时前
调查研究-197 FAISS vs Elasticsearch 全面对比:从向量检索、全文搜索到 RAG 选型指南
人工智能·elasticsearch·agent
leeyi5 小时前
Checkpoint 机制:Agent 怎么在断电后接着跑
redis·aigc·agent
米小虾6 小时前
Context Engineering —— 知识与记忆的窗口
人工智能·agent
葫芦和十三17 小时前
图解 MongoDB 13|WiredTiger 存储引擎:B-tree、页和 checkpoint 三件套
后端·mongodb·agent
To_OC18 小时前
数据集划分不是随便切:手把手切分大众点评情感数据集
人工智能·llm·agent
冬奇Lab18 小时前
Skill 系列(06):Skill 工程化与治理——路由准确率 38%、压缩节省 76%
人工智能·开源·agent
想要成为糕糕手1 天前
深入理解AI Agent工具调用:从原理到代码实现
llm·agent
Sokach10151 天前
Windows使用hermes桌面端个人出现的问题
agent
leeyi1 天前
Agent Transfer:让 AI 把任务交给更合适的 AI
aigc·agent·ai编程