第05篇-从零开始体验Skills-安装Hermes并调用第一个技能

【Skills 系统从入门到精通】第 5 篇从零开始体验 Skills——安装 Hermes 并调用第一个技能本篇你将学到如何一键安装 Hermes Agent 并完成初始设置查看内置技能库的方法和常用命令通过斜杠命令调用技能的完整操作流程体验 Agent 的自我改进能力——让它自动创建技能技能的查看、管理和基本运维操作读完本篇你将拥有一个运行中的 AI Agent 环境并能熟练调用内置技能。一、安装 Hermes Agent1.1 环境要求在安装之前先确认环境满足要求要求项最低版本推荐版本检查命令操作系统—Linux / macOS / Windows (WSL)uname -aPython3.103.11python3 --version磁盘空间500MB1GBdf -h网络能访问 LLM API——API Key至少一个 LLM 提供商——关于 LLM 提供商和 API KeyHermes 支持 20 家提供商包括 OpenRouter、Anthropic、OpenAI、DeepSeek、Google Gemini、Z.AI (GLM) 等。你需要至少配置一个 API Key 才能使用 Agent 功能。1.2 一键安装打开终端执行安装脚本curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bash安装脚本会自动完成以下操作1 检查 Python 版本和系统依赖2 克隆仓库到hermes 目录3 创建虚拟环境安装依赖4 复制内置技能到 skills 目录5 生成默认配置config.yaml6 注册 hermes 命令到系统 PATH安装完成后验证hermes--version如果看到版本号输出说明安装成功。1.3 初始配置首次使用需要进行基本配置。运行交互式设置向导hermes setup设置向导会依次引导你完成步骤一选择 LLM 提供商和模型Available providers: 1. OpenRouter (recommended - access multiple models) 2. Anthropic (Claude) 3. OpenAI (GPT) 4. DeepSeek 5. Google Gemini 6. Z.AI (GLM) ... Select provider [1-20]:选择你的提供商输入对应的 API Key。步骤二配置终端访问Terminal backend: local (default) Working directory: ~/projects (or your preferred directory)步骤三完成设置✓ Configuration saved to ~/.hermes/config.yaml ✓ API key stored in ~/.hermes/.env ✓ Ready to chat! Run: hermes1.4 验证安装运行健康检查hermes doctor正常输出类似Hermes Health Check ────────────────────────── ✓ Python 3.11.5 ✓ Config file: ~/.hermes/config.yaml ✓ API key configured (provider: openrouter) ✓ Terminal backend: local ✓ Skills directory: ~/.hermes/skills/ (47 skills) ✓ Sessions directory: ~/.hermes/sessions/ All checks passed!如果任何项显示✗按照提示修复后重新检查。二、探索内置技能库2.1 查看已安装技能安装完成后Hermes 自带一批内置技能。查看完整列表hermes skills list输出示例Installed Skills (47) ────────────────────────────────────────────────────── Category: autonomous-ai-agents claude-code Delegate coding to Claude Code CLI codex Delegate coding to OpenAI Codex CLI hermes-agent Configure, extend, or contribute to Hermes ... Category: creative excalidraw Hand-drawn Excalidraw JSON diagrams ascii-art ASCII art: pyfiglet, cowsay, boxes humanizer Humanize text: strip AI-isms, add real voice ... Category: github github-auth GitHub auth setup: HTTPS tokens, SSH keys github-code-review Pre-commit review: security scan, quality github-pr-workflow Complete GitHub/Git platform workflow ... Category: mlops axolotl LLM fine-tuning: Axolotl YAML configs vllm LLM inference: vLLM server setup ... Category: software-development systematic-debugging 4-phase root cause debugging tdd Test-driven development workflow ... ──────────────────────────────────────────────────────你会看到技能按分类组织每个技能显示名称和一行描述。2.2 CLI 技能管理命令常用的技能管理命令# 列出所有已安装技能hermes skills list# 查看某个技能的详细信息hermes skills inspectskill-name# 搜索技能在已安装和 Hub 中搜索hermes skills search关键词# 浏览可从 Hub 安装的技能hermes skills browse# 检查已安装的 Hub 技能是否有更新hermes skills check# 更新有上游变化的 Hub 技能hermes skills update2.3 在会话中查看技能除了在终端中使用 CLI 命令外在交互式会话中也可以管理技能。启动交互式会话hermes在会话提示符中输入/skills这会打开技能管理界面你可以浏览、搜索和加载技能。查看特定技能的详细信息/skill hermes-agent这会将技能的完整内容加载到当前会话上下文中。2.4 技能目录结构所有技能存储在~/.hermes/skills/目录下。探索这个目录可以直观了解技能的物理结构# 查看技能根目录ls~/.hermes/skills/# 输出# autonomous-ai-agents/ creative/ github/ mlops/# devops/ email/ media/ software-development/每个子目录是一个分类分类下是具体技能# 查看某个分类下的技能ls~/.hermes/skills/software-development/# 输出# systematic-debugging/ tdd/ file-patching-pitfalls/查看一个具体技能的目录结构ls-la~/.hermes/skills/software-development/tdd/# 输出# SKILL.md ← 主技能文件# references/ ← 参考文档阅读 SKILL.md 的内容cat~/.hermes/skills/software-development/tdd/SKILL.md你会看到标准的 YAML Frontmatter Markdown Body 结构——这就是第二模块中将要详细讲解的 SKILL.md 格式。~/.hermes/skills/autonomous-ai-agents/creative/github/software-development/systematic-debugging/tdd/SKILL.md 主技能文件references/ 参考文档三、调用第一个技能3.1 启动交互式会话hermes你会看到 Hermes 的欢迎界面和提示符。现在可以开始与 Agent 对话了。3.2 使用斜杠命令调用技能最直接的技能调用方式是斜杠命令。语法是/技能名 [你的指令]实战示例一搜索 GIF 动图/gif-search funny catsAgent 会加载gif-search技能然后使用 Tenor API 搜索猫的搞笑动图。技能告诉 Agent 如何构造搜索请求、如何处理返回结果。实战示例二生成 Excalidraw 图表/excalidraw 画一个用户注册流程图包含邮箱验证步骤Agent 加载excalidraw技能按照技能中描述的格式规范生成一个 Excalidraw JSON 文件你可以直接导入 Excalidraw 查看和编辑。实战示例三代码审查/github-code-review 审查 src/ 目录下的最新提交Agent 加载github-code-review技能按照技能中定义的审查流程检查代码——安全扫描、质量门禁、风格检查最后输出审查报告。技能库Agent用户技能库Agent用户/github-code-review 审查最新提交精确匹配技能名Level 1 加载完整技能内容按技能流程执行安全扫描 质量门禁 风格检查输出审查报告3.3 自然语言触发技能除了显式使用斜杠命令外你也可以用自然语言描述需求Agent 会自动判断需要加载哪个技能帮我画一个系统架构图包含负载均衡器、两个 API 服务器和一个数据库Agent 分析这个请求后发现excalidraw技能的描述匹配“Hand-drawn Excalidraw JSON diagrams (arch, flow, seq)”自动加载该技能然后按照技能指导生成图表。你不需要记住技能的准确名称——只要描述清晰Agent 会找到合适的技能。3.4 命令行单次查询如果你不需要交互式会话只想快速执行一个任务可以使用单次查询模式# 搜索 GIFhermes chat-q搜索一个程序员的搞笑动图# 分析日志hermes chat-q分析 /var/log/syslog 中的错误单次查询模式中Agent 同样会自动发现和加载需要的技能。四、体验自我改进4.1 什么是自我改进Skills 系统最令人兴奋的特性之一是自我改进——Agent 可以从经验中学习自动将有效的工作流程保存为新技能。自我改进的触发条件完成了一个复杂任务5 步工具调用遇到错误或死胡同最终找到了正确的路径被用户纠正了做法发现了一个非平凡的工作流程4.2 实战让 Agent 自动创建技能让我们通过一个实际任务来体验自我改进。在交互式会话中输入帮我写一个脚本统计指定目录下各编程语言的代码行数排除 vendor 和 node_modules 目录Agent 执行这个任务的过程1. 思考方案遍历目录、识别文件类型、统计行数、排除特定目录 2. 编写 Python 脚本 3. 测试脚本 4. 修复发现的问题 5. 最终完成任务完成后Agent 可能会判断这是一个值得保存的工作流程多步骤、可复用然后自动创建一个技能我注意到这个代码行数统计的工作流程是可复用的。 我已经将其保存为技能 codebase-line-counter以后遇到类似需求可以直接使用。4.3 验证自动创建的技能检查是否成功创建了技能hermes skills list|grepcodebase如果看到输出说明技能已成功创建。查看技能内容hermes skills inspect codebase-line-counter或者在会话中查看/skill codebase-line-counter你会看到 Agent 自动生成的 SKILL.md 文件包含了它刚才执行的操作流程、遇到的坑和解决方案。多步骤 可复用太简单 太特殊用户提出任务统计代码行数Agent 思考方案编写脚本 测试 修复任务完成值得保存?自动创建技能codebase-line-counter不创建新会话中直接复用不再从零思考4.4 在新会话中使用自动创建的技能打开一个新会话或重置当前会话/new然后用自然语言触发刚才自动创建的技能帮我统计 ~/my-project 的代码行数如果技能的 description 写得好Agent 会自动匹配到codebase-line-counter技能按照已保存的流程高效执行而不需要从零开始思考方案。五、技能管理基础操作5.1 技能的启用与禁用在会话中可以临时禁用不需要的技能以减少上下文噪音/skills在技能管理界面中可以按分类浏览和切换技能的启用状态。需要注意的是技能的启用/禁用是按平台的。你可以在 CLI 环境下禁用某个技能但在 Telegram 环境下保持启用。5.2 技能的平台级配置不同平台可以有不同的技能配置。查看当前配置hermes skills config这会显示每个平台CLI、Telegram、Discord 等下技能的启用状态。5.3 安装新技能从 Skills Hub 安装新技能# 浏览可安装的技能hermes skills browse# 搜索特定关键词hermes skills search kubernetes# 安装技能hermes skillsinstallskill-id安装的技能会经过安全扫描确保不包含恶意代码。安装完成后立即可用需要新会话生效。5.4 常用维护命令汇总# 查看技能状态hermes skills list# 列出所有已安装技能hermes skills list--sourcehub# 只看 Hub 安装的技能hermes skills check# 检查 Hub 技能更新hermes skills update# 更新有变化的 Hub 技能# 技能维护hermes skills audit# 重新安全扫描所有 Hub 技能hermes skills resetname# 重置技能的修改标记hermes skills resetname--restore# 恢复为内置原始版本# 管理 Hub 源hermes skills tap list# 查看已添加的 Tap 仓库hermes skills tapaddorg/repo# 添加 GitHub Tap本篇小结知识点核心内容安装方式一键脚本curl ... | bash安装到~/.hermes/初始配置hermes setup交互式向导选择模型、配置终端健康检查hermes doctor验证所有组件正常技能列表hermes skills list按分类查看所有已安装技能斜杠命令/技能名 [指令]在交互式会话中调用技能自然语言触发直接描述需求Agent 自动匹配技能单次查询hermes chat -q ...非交互式模式自我改进Agent 完成复杂任务后自动保存技能跨会话复用技能管理hermes skills子命令集list / inspect / search / browse / check / update物理结构~/.hermes/skills/分类/技能名/SKILL.md下篇预告本篇中我们用斜杠命令调用了几个技能但只是照着示例输入。下一篇将深入斜杠命令的完整语法——单技能调用、多技能堆叠、堆叠解析规则、文件路径安全等细节让你全面掌握技能调用的精确控制。如果本篇内容对你有帮助欢迎点赞收藏有任何疑问欢迎在评论区交流。