Hermes Agent

MIT No Attribution (MIT-0)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.


---
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