# Hermes Agent 技能规范摘要

> 本文件摘要整理 Hermes Agent 技能的核心规范，供快速参考。完整规范请参阅 Hermes Agent 官方文档。

## 技能目录结构

```
<skill-name>/
├── skill.json      # 技能元信息（必填）
├── prompt.md       # 技能指令和输出定义（必填）
├── tools/          # 工具定义（可选）
├── tests/          # 验证用例（可选）
└── CHANGELOG.md    # 版本变更记录（推荐）
```

## skill.json 字段

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `name` | string | 是 | 技能名称 |
| `version` | string | 是 | 语义化版本号 |
| `description` | string | 是 | 技能功能描述 |
| `outputSchema` | object | 否 | 结构化输出的 JSON Schema |
| `tools` | array | 否 | 依赖的工具列表 |
| `tags` | array | 否 | 标签 |

## prompt.md 格式

Hermes Agent 的技能指令定义：

- 使用 Markdown 格式编写
- **必须明确定义输出格式**（JSON Schema 或示例）
- 描述技能的执行规则和约束
- 指定工具调用的条件和参数
- 建议包含输入输出示例

## 结构化输出

Hermes Agent 的核心特性：

- 技能输出必须符合预定义的 JSON Schema
- 在 `skill.json` 的 `outputSchema` 字段定义
- 或在 `prompt.md` 中明确描述输出格式
- 支持嵌套对象和数组类型

## 工具调用协议

- 工具以标准化接口定义
- 支持同步和异步调用
- 工具定义可放在 `tools/` 目录
- 需声明工具参数的 JSON Schema

## 参考链接

- [Hermes Agent 官方文档](https://docs.hermes-agent.dev)（待确认）
- `examples/` 目录中的参考实现