|
--- name: hermes-agent description: | NousResearch Hermes Agent 通用集成 Skill。通过 CLI 调用 Hermes Agent 的核心能力： - 🚀 自改进技能系统（从任务中自动创建可复用技能） - 🧠 持久化记忆（FTS5全文搜索 + LLM摘要） - 🤖 子代理委托（任务隔离和并行处理） - 🔌 MCP 双向集成 - 🌐 浏览器自动化 - 💻 代码执行 - 🔍 网页研究 - 📦 完全可移植，支持任意 Claw/WorkBuddy 实例一键安装 triggers: - "使用 hermes" - "调用 hermes" - "hermes agent" - "子代理委托" - "hermes run" - "hermes delegate" - "hermes memory" - "hermes skills" - "让 hermes 帮我" - "用 hermes 分析" - "安装 hermes" category: ai-agents version: 2.0.0 requires_approval: false cost_awareness: | ⚠️ 每次 `hermes run` 调用都会产生 LLM Token 消耗。 - 单轮简单问答：约 $0.001-0.01 - 复杂任务（含子代理）：约 $0.05-0.50 - 建议对复杂任务先评估成本，或限制工具集减少调用次数 --- # Hermes Agent Skill v2.0 ## 概述 本 Skill 封装了 [NousResearch Hermes Agent](https://github.com/NousResearch/hermes-agent) 的 CLI 调用能力，让 WorkBuddy/Claw 可以通过 Shell 命令利用 Hermes 的核心功能。 **v2.0 改进：完全可移植，无硬编码路径，支持任意实例一键安装。** --- ## 首次安装 ### 一键安装（推荐） 当检测到 Hermes 未安装时，运行： ```bash # 安装 Hermes Agent（自动克隆、创建虚拟环境、创建 CLI 入口） bash ~/.workbuddy/skills/hermes-agent/scripts/install_hermes.sh # 或自定义安装目录 bash ~/.workbuddy/skills/hermes-agent/scripts/install_hermes.sh --prefix ~/custom/path ``` 安装脚本会自动： 1. ✅ 检测 Python 3.11+ 环境 2. ✅ 克隆 Hermes Agent 源码 3. ✅ 创建 Python 虚拟环境并安装依赖 4. ✅ 创建 `~/.local/bin/hermes` CLI 入口 5. ✅ 初始化 `~/.hermes/` 配置目录 6. ✅ 生成默认 `.env` 配置模板 ### 安装后配置 API Key ```bash # 编辑配置文件，填入你的 API Key nano ~/.hermes/.env ``` 可选提供商（任选其一）： ```bash # 智谱 AI（推荐国内用户） GLM_API_KEY=your-key-here # OpenRouter（支持多种模型） OPENROUTER_API_KEY=sk-or-v1-your-key-here # Anthropic ANTHROPIC_API_KEY=sk-ant-your-key-here # OpenAI OPENAI_API_KEY=sk-your-key-here ``` ### 验证安装 ```bash # 确认 PATH 包含 hermes export PATH="$HOME/.local/bin:$PATH" hermes --version # 运行诊断 hermes doctor ``` --- ## 迁移到其他 Claw 实例 将整个 Skill 目录复制到目标实例即可： ```bash # 在目标实例上执行： cp -r /path/to/hermes-agent ~/.workbuddy/skills/hermes-agent bash ~/.workbuddy/skills/hermes-agent/scripts/install_hermes.sh # 然后配置 API Key ``` --- ## 核心工作流 ### 1. 调用模式速查 | 场景 | 命令 | 说明 | |------|------|------| | **快速问答** | `hermes run "问题" --non-interactive --no-stream` | 最简调用 | | **带上下文** | `hermes run "问题" --context-file ./ctx.md --non-interactive` | 注入项目上下文 | | **子代理委托** | 使用 `scripts/hermes_delegate.sh` | 复杂任务分解 | | **技能查询** | `hermes skills list` | 查看已学技能 | | **记忆搜索** | `hermes memory search "关键词"` | 检索历史知识 | | **状态检查** | `hermes status` 或 `hermes doctor` | 诊断安装状态 | ### 2. CLI 命令完整参考 #### 基础命令 ```bash # 启动交互式对话 hermes # 单轮执行（WorkBuddy 集成首选） hermes run "prompt" [选项] # 非交互模式选项 --non-interactive # 关闭交互式 TUI（必需） --no-stream # 禁用流式输出，返回完整结果 --context-file PATH # 注入上下文文件 --toolset NAME # 限制使用的工具集 --model MODEL # 指定模型 --timeout SECONDS # 超时时间（默认300秒） ``` #### 子代理委托 ```bash # 通过 wrapper 脚本调用（推荐） ./scripts/hermes_delegate.sh \ --task "分析竞品A和B的产品特性" \ --tools "web_search,browser,file_write" \ --timeout 300 \ --output ./result.md # 直接在 hermes run 中使用 delegate_task 工具 hermes run '使用delegate_task工具，任务是：分析XXX，工具限制：web_search,browser' \ --non-interactive --no-stream ``` #### 记忆管理 ```bash # 搜索历史记忆 hermes memory search "关键词" # 查看所有笔记 hermes memory notes list # 添加手动笔记 hermes memory notes add "重要发现：..." # 导出/导入记忆 hermes memory export ./backup/ hermes memory import ./backup/ ``` #### 技能管理 ```bash hermes skills list # 列出所有技能 hermes skills create my-skill --description "描述" # 创建新技能 hermes skills edit my-skill # 编辑技能 hermes skills remove my-skill # 删除技能 ``` #### 插件管理 ```bash hermes plugins list # 列出插件 hermes plugins install user/repo # 安装插件 hermes plugins enable/disable/update/remove plugin-name ``` #### 定时任务 (Cron) ```bash hermes cron list # 列出定时任务 hermes cron add --name "日报" --cron "0 9 * * *" --message "生成总结" hermes cron pause/resume/remove TASK_ID ``` #### MCP 集成 ```bash hermes mcp serve --port 8080 # 启动 MCP Server hermes mcp connect <server-config> # 连接外部 MCP 服务 ``` --- ## Wrapper 脚本 ### scripts/hermes_wrapper.sh 统一的 CLI 封装脚本，提供 JSON 格式化输出和错误处理： ```bash ./scripts/hermes_wrapper.sh [命令] [参数...] # 示例 ./scripts/hermes_wrapper.sh run "分析内容" --timeout 60 ./scripts/hermes_wrapper.sh memory search "关键词" ./scripts/hermes_wrapper.sh status ``` **输出格式**：JSON（包含 `success`, `output`, `error`, `duration_ms` 字段） ### scripts/hermes_delegate.sh 子代理委托专用脚本： ```bash ./scripts/hermes_delegate.sh --task "任务描述" [选项] # 可选选项 --tools "tool1,tool2" # 限制可用工具集 --timeout 300 # 超时时间（秒） --output ./result.md # 输出文件路径 --max-concurrent 3 # 最大并发数（默认3） --context-file ./ctx.md # 额外上下文文件 -v # 详细输出 ``` ### scripts/install_hermes.sh 一键安装脚本（详见上方「首次安装」章节）： ```bash bash scripts/install_hermes.sh [--skip-deps] [--prefix DIR] ``` --- ## 模型配置 运行交互式配置向导： ```bash hermes model ``` 或直接编辑 `~/.hermes/config.yaml`： ```yaml model: provider: zai # 可选: openrouter, anthropic, openai, zai, gemini 等 default: "glm-5" # 默认模型 base_url: "https://api.z.ai/api/paas/v4" # 自定义 API 地址 ``` **支持的提供商**：openrouter, anthropic, openai, gemini, zai, kimi-coding, nous, custom --- ## 最佳实践 ### ✅ 推荐做法 1. **始终使用 `--non-interactive --no-stream`**：避免 TUI 阻塞 2. **设置合理的超时时间**：简单任务 60s，复杂任务 300s 3. **限制工具集**：用 `--toolset` 减少 Token 消耗 4. **使用上下文文件**：将大段背景信息放入文件，而非 prompt 中 5. **错误重试机制**：网络问题时自动重试 1-2 次 ### ⚠️ 注意事项 1. **Token 成本**：每次调用都有成本 2. **并发限制**：最多 3 个并发子代理 3. **超时保护**：长时间运行的任务必须设置 timeout 4. **API Key 安全**：不要在 Skill 文件中硬编码密钥 5. **Python 版本**：确保使用 Python 3.11+ --- ## 故障排除 | 问题 | 解决方案 | |------|----------| | `command not found: hermes` | 运行 `export PATH="$HOME/.local/bin:$PATH"` 或重新执行 `install_hermes.sh` | | `TypeError: unsupported operand` | 确保 Python 3.11+ | | API Key 错误 | 检查 `~/.hermes/.env` 配置 | | 连接超时 | 检查网络，或更换 LLM 提供商 | | 子代理失败 | 减少 `--max-concurrent` 或增加 `--timeout` | | 安装脚本失败 | 运行 `hermes doctor` 诊断 | --- ## 文件结构 ``` hermes-agent/ ├── SKILL.md # 本文件（Skill 说明文档） ├── _meta.json # Skill 元数据（可移植性声明） ├── scripts/ │ ├── install_hermes.sh # 一键安装脚本（通用） │ ├── hermes_wrapper.sh # 统一 CLI 封装（动态路径检测） │ └── hermes_delegate.sh # 子代理委托脚本（动态路径检测） └── references/ # 参考文档 ``` --- ## 更新日志 - **v2.0.0** (2026-04-12): 完全可移植版 — 移除所有硬编码路径，添加一键安装脚本，支持任意 Claw 实例迁移 - **v1.0.0** (2026-04-11): 初始版本，支持基础 CLI 调用、子代理委托、记忆/技能管理
Creator's repository · wihy/hermes-agent-skill