Skills时代对Agent的进阶应用

Skills时代对Agent的进阶应用

English

盛子瑞 2025年03月19日 ai agent tutorial

摘要

这份文档主要包含了3个问题：

  • Skills到底是什么
  • Skills怎么安装、制作和调用
  • 有哪些值得直接参考的Skills与资源库

一、什么是Skills

Skills是把高频任务的指令、触发条件、参考资料和脚本资源打包成可复用能力模块，让Agent用更少的上下文、更稳定的方式完成任务。

参考视频：https://www.bilibili.com/video/BV162cPzhEGU/

要理解Skills，我们可以回到一整套Agent的使用链路里：

  • Prompt：直接给AI下指令
  • 结构化Prompt：把任务目标、限制条件、输出形式说得更完整
  • Command：把重复使用的提示词沉淀成固定指令文件
  • System Prompt：为某个项目或环境设定长期生效的行为规则
  • Metadata：先用少量描述帮助模型快速判断该读哪个文件
  • References / Scripts：把详细说明和可执行脚本拆出去，按需读取
  • Skill：把以上内容组织成一个完整、可复用的能力单元

Skills不是"更长的提示词"，而是"结构化的任务封装"。它的目标不是把所有知识一次性塞进上下文，而是通过metadata和按需加载机制减少token消耗。一个好用的Skill，既要告诉Agent"什么时候用"，也要告诉它"具体怎么做"。

在Skills的典型结构中：

  • SKILL.md 负责声明这个能力是什么、适用于什么任务、执行时应遵循什么步骤
  • references/ 负责放细节知识和说明文档
  • scripts/ 负责放可以直接调用的代码或脚本
  • assets/ 负责放模板、图标、样式、示例素材等输出资源

二、Skills的安装、制作与使用

1. 支持Skills的不同工具具有不同的路径

工具 Skills文档 全局（用户级）路径 项目级路径
Claude Code code.claude.com/docs/en/skills ~/.claude/skills/ .claude/skills/
Codex developers.openai.com/codex/skills ~/.codex/skills/ .codex/skills/
Gemini CLI geminicli.com/docs/cli/skills ~/.gemini/skills/ .gemini/skills/
Opencode opencode.ai/docs/skills ~/.config/opencode/skill/ 或 ~/.claude/skills/ .opencode/skill/ 或 .claude/skills/
AMP ampcode.com/news/agent-skills ~/.config/agents/skills/ 或 ~/.claude/skills/ .agents/skills/ 或 ~/.claude/skills/
CodyBuddy copilot.tencent.com/docs/cli/skills ~/.codebuddy/skills/ .codebuddy/skills/
Antigravity geminicli.com/docs/cli/skills ~/.gemini/antigravity/skills/ .agent/skills/
VS Code code.visualstudio.com ~/.copilot/skills/ 或 ~/.claude/skills/ .github/skills/ 或 .claude/skills/
Cursor cursor.com/cn/docs/context/skills ~/.cursor/skills/ 或 ~/.claude/skills/ .cursor/skills/ 或 .claude/skills/
Qwen Code Qwen Code: AI Coding Agent Documentation ~/.qwen/skills/ .qwen/skills
Qoder docs.qoder.com/cli/Skills ~/.qoder/skills/ .qoder/skills
Trae trae.ai/blog/trae_tutorial_0115 ~/.trae/skills/ .trae/skills/
Windsurf docs.windsurf.com ~/.codeium/windsurf/skills/ .windsurf/skills/
Kilo kilo.ai/docs/agent-behavior/skills ~/.kilocode/skills/ ~/.kilocode/skills/
Factory docs.factory.ai/cli/configuration/skills ~/.factory/skills/ .factory/skills/
Goose block.github.io/goose ~/.config/goose/skills/ 或 ~/.config/agent/skills/ 或 ~/.claude/skills/ .goose/skills/ 或 .agent/skills/ 或 .claude/skills/

2. 安装Skills的3种方式

方法一：直接让AI帮忙安装

这是最省事的方法。你只需要告诉Agent：

帮我安装 {skill-name}，skill的项目地址是：{skill 项目地址}

它适合：

  • 你已经知道要装哪个Skill
  • 你不想手动找目录和处理文件层级
  • 当前Agent本身具备足够的文件操作能力

方法二：通过插件市场安装

以Claude Code为例：

  1. 输入 /plugin
  2. 添加官方 marketplace：anthropics/claude-plugins-official
  3. 在 marketplace 中找到目标 skill
  4. 选择安装范围并完成安装

安装范围有3类：

  • 用户范围：全局生效
  • 项目范围：对当前项目的所有使用者生效
  • 本地范围：只对当前项目中的个人环境生效

方法三：手动安装

这是最通用的方法，尤其适合IDE和CLI类工具。

  1. 找到该工具约定的skills目录
  2. 创建对应文件夹
  3. 将目标skill的整个目录拖进去
  4. 保持目录层级正确

如果某个小众Skill只提供了某一种Agent版本，而你想用于别的Agent，也可以先放进目录里，再让当前Agent帮你改写成适配版本。

3. Skills的制作方法

可以让Agent直接帮你制作Skills：

  1. 先把已有的说明文档、常用脚本、参考资料粗略整理出来
  2. 再让Agent帮你补齐结构、润色说明、改造成Skill格式

4. Skills的使用方法

  • Agent自动按需加载
  • 用户显式指定使用哪个Skill

三、推荐的Skills与资源库

1. Superpower

https://github.com/obra/superpowers

它本质上是一整套比较成熟的软件开发工作流。它的价值不只是在"头脑风暴"，而在于把从想法到交付的全过程都模块化了。

其工作流程包括：

  • brainstorming：把模糊想法转成结构化设计
  • using-git-worktrees：为不同功能建立独立工作区，减少互相干扰
  • writing-plans：把工作拆成明确的小任务，并注明文件路径、代码和验证步骤
  • 执行开发：可走 subagent-driven-development 或 executing-plans 两条路线
  • test-driven-development：坚持 RED-GREEN-REFACTOR 的TDD循环
  • requesting-code-review：按严重等级做代码审查
  • finishing-a-development-branch：完成任务后做验证、合并或清理

2. planning-with-files

https://github.com/OthmanAdi/planning-with-files

这个Skill的核心思想是把文件系统当作AI的外部工作记忆，用来缓解上下文窗口有限和目标漂移的问题。

它主要使用3个Markdown文件管理任务：

  • task_plan.md：记录阶段和进度
  • notes.md：记录研究发现和过程信息
  • [deliverable].md：沉淀最终输出

3. find-skills

这是"用来找Skills的Skill"。它的价值非常直接：当你已经知道自己需要某种能力，但不知道现成的Skill在哪里时，可以先用它做检索。

4. research-paper-writing

https://github.com/Master-cai/Research-Paper-Writing-Skills/tree/main/research-paper-writing

这是一个面向学术写作的Skill。

5. Skills资源库

Claude Code官方Skills库

Claude Code官方的Skills库有两个，是他们不同时间段发布的，两者存在一些重叠的Skills：

GitHub上四个stars数较高的awesome-claude-skills仓库：

Skillsmp

这个Skills网站收录了目前GitHub超8W+的开源Skills，应该是目前收录Skills数量最多的网站。支持AI语义搜索和关键字筛选，也支持按分类浏览、按热度排序。

🔗：https://skillsmp.com

Skillsmp截图

Skillsmp截图

skills.sh: https://skills.sh/

← 返回文章列表