hermes教程-使用技能 - 字节笔记本

查找技能

每个 Hermes 安装都附带内置技能。查看可用的技能：

bash

## 在任何聊天会话中：
/skills
## 或者从 CLI：
hermes skills list

这会显示一个紧凑的列表，包含名称和描述：

text

ascii-art         使用 pyfiglet、cowsay、boxes 等生成 ASCII 艺术
arxiv             搜索并检索 arXiv 上的学术论文
github-pr-workflow 完整的 PR 生命周期——创建分支、提交...
plan              计划模式——检查上下文、编写 Markdown...
excalidraw        使用 Excalidraw 创建手绘风格图表...

搜索技能

bash

## 按关键词搜索
/skills search docker
/skills search music

技能中心

官方可选技能（默认未激活的较重或小众技能）可通过中心获取：

bash

## 浏览官方可选技能
/skills browse
## 搜索中心
/skills search blockchain

使用技能

每个已安装的技能自动成为一个斜杠命令。只需输入其名称：

bash

## 加载技能并分配任务
/ascii-art 制作一个写着“HELLO WORLD”的横幅
/plan 为待办事项应用设计一个 REST API
/github-pr-workflow 为认证重构创建一个 PR
## 仅技能名称（无任务）会加载它，然后让你描述需求
/excalidraw

你也可以通过自然对话触发技能——让 Hermes 使用特定技能，它会通过 skill_view 工具加载该技能。

渐进式加载

技能使用一种节省 token 的加载模式。代理不会一次性加载所有内容：

skills_list() ——所有技能的紧凑列表（约 3k tokens）。在会话开始时加载。
skill_view(name) ——单个技能的完整 SKILL.md 内容。当代理决定需要该技能时加载。
skill_view(name, file_path) ——技能中的特定参考文件。仅在需要时加载。

这意味着技能在实际使用之前不会消耗 token。

从中心安装

官方可选技能随 Hermes 一起提供，但默认未激活。需要显式安装：

bash

## 安装官方可选技能
hermes skills install official/research/arxiv
## 在聊天会话中从中心安装
/skills install official/creative/songwriting-and-ai-music
## 直接从任何 HTTP(S) URL 安装单个文件的 SKILL.md
hermes skills install https://sharethis.chat/SKILL.md
/skills install https://example.com/SKILL.md --name my-skill

安装过程：

技能目录被复制到 ~/.hermes/skills/
它出现在你的 skills_list 输出中
它作为斜杠命令可用

提示

已安装的技能在新会话中生效。如果你希望它在当前会话中可用，请使用 /reset 重新开始，或者添加 --now 以立即使提示缓存失效（下一次对话会消耗更多 token）。

验证安装

bash

## 检查是否已安装
hermes skills list | grep arxiv
## 或者在聊天中
/skills search arxiv

插件提供的技能

插件可以使用带命名空间的名称（plugin:skill）捆绑自己的技能。这可以防止与内置技能的名称冲突。

bash

## 通过限定名称加载插件技能
skill_view("superpowers:writing-plans")
## 同名的内置技能不受影响
skill_view("writing-plans")

插件技能不会列在系统提示中，也不会出现在 skills_list 中。它们是选择加入的——当你知道某个插件提供了技能时，显式加载它。加载后，代理会看到一个横幅，列出同一插件中的同级技能。

关于如何在自己的插件中提供技能，请参阅构建 Hermes 插件 → 捆绑技能。

配置技能设置

某些技能在其 frontmatter 中声明了所需的配置：

yaml

metadata:
  hermes:
    config:
      - key: tenor.api_key
        description: "用于 GIF 搜索的 Tenor API 密钥"
        prompt: "输入你的 Tenor API 密钥"
        url: "https://developers.google.com/tenor/guides/quickstart"

当首次加载带有配置的技能时，Hermes 会提示你输入值。它们存储在 config.yaml 的 skills.config.* 下。

从 CLI 管理技能配置：

bash

## 为特定技能进行交互式配置
hermes skills config gif-search
## 查看所有技能配置
hermes config show | grep '^skills\.config'

创建你自己的技能

技能只是带有 YAML frontmatter 的 Markdown 文件。创建它只需不到五分钟。

1. 创建目录

bash

mkdir -p ~/.hermes/skills/my-category/my-skill

2. 编写 SKILL.md

markdown

---
name: my-skill
description: 简要描述此技能的功能
version: 1.0.0
metadata:
  hermes:
    tags: [my-tag, automation]
    category: my-category
---
## 我的技能

## 何时使用
当用户询问关于[特定主题]或需要[特定任务]时，使用此技能。

## 步骤
1. 首先，检查[前提条件]是否可用
2. 运行 `command --with-flags`
3. 解析输出并呈现结果

## 常见陷阱
- 常见失败：[描述]。修复方法：[解决方案]
- 注意[边缘情况]

## 验证
运行 `check-command` 以确认结果正确。

3. 添加参考文件（可选）

技能可以包含代理按需加载的支持文件：

text

my-skill/
├── SKILL.md                    # 主要技能文档
├── references/
│   ├── api-docs.md             # 代理可查阅的 API 参考
│   └── examples.md             # 示例输入/输出
├── templates/
│   └── config.yaml             # 代理可使用的模板文件
└── scripts/
    └── setup.sh                # 代理可执行的脚本

在你的 SKILL.md 中引用这些文件：

markdown

有关 API 详情，请加载参考文件：`skill_view("my-skill", "references/api-docs.md")`

4. 测试它

启动一个新会话并尝试你的技能：

bash

hermes chat -q "/my-skill 帮我处理这件事"

技能会自动出现——无需注册。将其放入 ~/.hermes/skills/ 即可生效。

信息

代理也可以使用 skill_manage 自行创建和更新技能。在解决复杂问题后，Hermes 可能会提议将方法保存为技能以备将来使用。

按平台管理技能

控制哪些技能在哪些平台上可用：

bash

hermes skills

这会打开一个交互式 TUI，你可以在其中按平台（CLI、Telegram、Discord 等）启用或禁用技能。当你希望某些技能仅在特定上下文中可用时（例如，将开发技能保留在 Telegram 之外），这很有用。

技能与记忆

两者在会话之间都是持久的，但用途不同：

	技能	记忆
内容	程序性知识——如何做事情	事实性知识——事物是什么
何时	按需加载，仅当相关时	自动注入到每个会话中
大小	可以很大（数百行）	应该紧凑（仅关键事实）
成本	加载前零 token	小但恒定的 token 成本
示例	“如何部署到 Kubernetes”	“用户偏好深色模式，居住在 PST 时区”
创建者	你、代理或从中心安装	代理，基于对话

经验法则： 如果你会把它放在参考文档中，那就是技能。如果你会把它写在便签上，那就是记忆。

提示

保持技能专注。 一个试图涵盖“所有 DevOps”的技能会太长且太模糊。一个涵盖“将 Python 应用部署到 Fly.io”的技能足够具体，真正有用。

让代理创建技能。 在完成复杂的多步骤任务后，Hermes 通常会提议将方法保存为技能。接受它——这些代理编写的技能捕获了完整的工作流程，包括过程中发现的陷阱。

使用分类。 将技能组织到子目录中（~/.hermes/skills/devops/、~/.hermes/skills/research/ 等）。这使列表保持可管理，并帮助代理更快地找到相关技能。

技能过时后及时更新。 如果你使用某个技能时遇到了它未涵盖的问题，告诉 Hermes 用你学到的东西更新该技能。不维护的技能会成为负担。

有关完整的技能参考——frontmatter 字段、条件激活、外部目录等——请参阅技能系统。