没有 Skills：
  用户：帮我审查这个 PR
  AI：好的...（每次都要重新分析）
  用户：帮我再审查一个 PR
  AI：好的...（重复之前的思考过程）

有 Skills：
  用户：帮我审查这个 PR
  AI：[加载 code-review 技能]好的，这是审查结果...
  用户：帮我再审查一个 PR
  AI：[加载 code-review 技能]好的，审查结果...
  
  → 更快、更一致、更专业

# SKILL.md - 完整规范

# 1. 元数据头（可选，但推荐）
---
name: code-review              # 技能唯一名称
version: "1.2.0"              # 语义版本
author: hermes-auto            # 创建者
created: "2026-03-15"         # 创建日期
updated: "2026-05-11"         # 最后更新
description: "代码审查助手"    # 简短描述
tags: [code, security, review] # 标签
language: zh-CN               # 主要语言
---

# 2. 技能标题
# 技能名称（自动从文件名推断）

## 描述
简要描述这个技能做什么。1-2 句话。

## 触发条件
描述什么情况下应该使用这个技能。

### 触发词（可选）
- review code
- 审查代码
- check pr

### 触发场景
- 用户要求审查代码
- 用户提到 PR 链接
- 用户提到代码变更

## 前置条件
执行这个技能前需要满足的条件。

### 必需工具
- git
- shell

### 必需配置
- GITHUB_TOKEN 环境变量

## 执行步骤

### 步骤 1：获取代码变更
使用 git diff 获取代码变更内容。

### 步骤 2：静态分析
检查以下问题：
- 安全漏洞
- 代码风格
- 性能问题

### 步骤 3：生成审查报告
汇总发现的问题，生成结构化报告。

## 变量
这个技能支持的配置变量。

| 变量名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| severity | string | "medium" | 问题严重程度 |
| include_suggestions | boolean | true | 是否包含修改建议 |

## 相关知识
执行这个技能需要的背景知识。

### 代码规范
遵循 Google Style Guide。

### 安全标准
- OWASP Top 10
- CWE Top 25

## 示例

### 示例 1：审查 PR
输入：审查这个 PR https://github.com/owner/repo/pull/123
输出：
## 代码审查报告
### 发现的问题
1. **[高危]** SQL 注入漏洞
   - 位置：src/api/user.py:45
   - 说明：...
   - 建议：...
...

### 示例 2：审查本地变更
输入：帮我审查 main 分支的变更
输出：（类似格式）

## 配置示例
在 config.yaml 中的配置示例：

```yaml
skills:
  code-review:
    severity_threshold: "medium"
    auto_assign: true
    reviewers: ["@alice", "@bob"]

### 3.2 触发条件详解

触发条件是技能系统的核心，决定何时激活技能：

```yaml
## 触发条件

### 精确匹配
- "审查代码"
- "review code"

### 模糊匹配（包含以下关键词）
- "代码审查"
- "PR 审查"
- "check code"

### 正则匹配
- `^review.*pr$`
- `审查.*(PR|代码)`

### 场景匹配
- 用户提到 GitHub PR URL
- 用户提到代码变更
- 用户提到 .diff 文件

### 组合条件
- 包含"审查"且包含"代码"
- 包含"review"且不包含"test"

## 执行步骤

### 简单步骤
### 步骤 1：获取信息
直接描述执行内容。

### 条件步骤
### 步骤 2：检查安全
如果代码包含 SQL 查询，则执行：
- 运行 SQL 注入检测
- 检查参数化查询

### 循环步骤
### 步骤 3：分析每个文件
对变更列表中的每个文件：
1. 获取文件内容
2. 运行分析
3. 记录问题

### 可选步骤
### 步骤 4：生成报告（可选）
如果发现 > 0 个问题：
- 生成详细报告
- 发送通知
否则：
- 输出"没有问题"

### 错误处理
### 步骤 5：处理失败
如果 git 命令失败：
- 提示用户检查仓库配置
- 提供手动审查指南

用户：帮我分析这个 API 性能瓶颈，找出原因并给出优化方案。

Hermes：
[分析过程...]
1. 获取 API 日志
2. 分析慢查询
3. 检查缓存策略
4. 给出优化建议

[分析完成，耗时 3 分钟]
[自动创建技能：api-performance-analysis]

是否保存这个技能以便下次使用？[Y/n]

# 创建技能目录
mkdir -p ~/.hermes/memory/skills/my-custom-skill
cd ~/.hermes/memory/skills/my-custom-skill

# 创建 SKILL.md
touch SKILL.md

# SKILL.md - 技能名称

## 描述
这个技能做什么。

## 触发条件
什么情况下使用。

## 执行步骤

### 步骤 1
第一个步骤。

## 示例
输入：xxx
输出：xxx

# SKILL.md - API 性能分析

---
name: api-performance-analysis
version: "1.0.0"
author: user
created: "2026-05-11"
tags: [api, performance, optimization]
---

## 描述
分析 API 性能瓶颈，识别慢查询和优化机会。

## 触发条件
- 用户提到"API 性能"
- 用户提到"接口慢"
- 用户提到"性能瓶颈"
- 用户提到"优化"

## 前置条件

### 必需工具
- shell
- read
- web_fetch

### 必需配置
- ANALYTICS_API_KEY（可选）

## 执行步骤

### 步骤 1：收集指标
获取 API 相关指标：
- 响应时间分布
- QPS/TPS
- 错误率
- 慢请求列表

### 步骤 2：识别瓶颈
分析收集的指标：
- P99 > 1s → 关注
- 错误率 > 1% → 告警
- QPS 下降 → 排查

### 步骤 3：根因分析
对识别的瓶颈进行深入分析：
- 数据库查询（慢查询日志）
- 外部依赖（超时分析）
- 代码逻辑（火焰图）

### 步骤 4：生成优化方案
针对每个瓶颈：
1. 问题描述
2. 原因分析
3. 优化方案（含代码示例）
4. 预期收益

## 变量

| 变量名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| time_range | string | "1h" | 分析时间范围 |
| top_n | number | 10 | 关注 Top N 慢请求 |
| include_code | boolean | true | 是否包含代码示例 |

## 相关知识

### 性能指标
- P50/P90/P99 响应时间
- QPS（每秒请求数）
- 错误率
- 超时率

### 常见瓶颈
- N+1 查询
- 缺少索引
- 未使用缓存
- 同步阻塞

## 示例

### 示例 1：分析慢请求
输入：分析这个 API 的慢请求
输出：
## 性能分析报告

### 概览
| 指标 | 值 |
|------|-----|
| 分析时间 | 最近 1 小时 |
| 总请求数 | 15,234 |
| P99 响应时间 | 2.3s |
| 错误率 | 0.8% |

### Top 3 慢请求
1. **GET /api/users** - P99: 3.2s
   - 原因：N+1 查询
   - 优化：批量查询
   ...

### 优化建议
1. 为 users 表添加索引
2. 实现 Redis 缓存
...

### 示例 2：完整性能诊断
输入：帮我全面分析这个 API 的性能问题
输出：（类似格式，更详细）

## 配置示例

```yaml
skills:
  api-performance-analysis:
    time_range: "24h"
    top_n: 20
    auto_optimize: false

---

## 五、Skills Hub：社区技能生态

### 5.1 agentskills.io 平台

[agentskills.io](https://agentskills.io) 是官方技能分享平台：

### 5.2 安装社区技能

```bash
# 安装单个技能
hermes skill install github-pr-reviewer

# 安装多个技能
hermes skill install api-testing database-migration

# 安装指定版本
hermes skill install github-pr-reviewer@1.2.0

# 从 URL 安装
hermes skill install https://agentskills.io/skills/custom-skill

# 1. 确保技能格式正确
hermes skill validate my-skill

# 2. 测试技能
hermes skill test my-skill --dry-run

# 3. 发布到 Skills Hub
hermes skill publish my-skill

# 4. 设置为公开/私有
hermes skill publish my-skill --public
hermes skill publish my-skill --private

┌─────────────────────────────────────────────────────────────────────┐
│                      技能加载流程                                    │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  1. 用户输入                                                         │
│     "帮我审查这个 PR"                                                │
│                                                                      │
│  2. 触发条件匹配                                                     │
│     ┌─────────────────────────────────────┐                         │
│     │  skill: code-review                 │                         │
│     │  triggers:                           │                         │
│     │    - "审查" ✓                        │                         │
│     │    - "review" ✓                      │                         │
│     │    - "PR" ✓                          │                         │
│     │  match_score: 0.95                   │                         │
│     └─────────────────────────────────────┘                         │
│                                                                      │
│  3. 技能加载                                                         │
│     读取 ~/.hermes/memory/skills/code-review/SKILL.md               │
│                                                                      │
│  4. 执行                                                             │
│     按执行步骤执行代码审查                                            │
│                                                                      │
│  5. 记录执行结果                                                     │
│     - 执行时间                                                       │
│     - 成功率                                                         │
│     - 问题发现数量                                                   │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘

# 用户输入："帮我分析这个 API 的性能问题并审查代码"

可能的匹配：
  - api-performance-analysis (匹配度: 0.92)
  - code-review (匹配度: 0.78)

处理策略：
  - 主要技能：api-performance-analysis
  - 次要技能：code-review（作为工具调用）

优先级规则（从高到低）：
  1. 用户自定义技能（~/.hermes/memory/skills/）
  2. 社区安装技能（~/.hermes/memory/skills-installed/）
  3. 内置技能（hermes 内置）

同名技能覆盖：
  如果同名技能存在，后者覆盖前者

# 查看技能版本
hermes skill info my-skill
# 输出：
# name: my-skill
# version: 1.2.0
# created: 2026-03-15
# updated: 2026-05-11

# 升级技能
hermes skill update my-skill

# 回滚技能
hermes skill rollback my-skill --to 1.1.0

# 查看版本历史
hermes skill history my-skill

# 输出：
# v1.2.0 (2026-05-11)
#   - 添加了安全扫描功能
#   - 优化了性能
#
# v1.1.0 (2026-04-20)
#   - 修复了边界 case
#   - 改进了错误提示
#
# v1.0.0 (2026-03-15)
#   - 初始版本

# 导出技能
hermes skill export my-skill --output ./backup/

# 导出所有技能
hermes skill export-all --output ./backup/

# 导入技能
hermes skill import ./backup/my-skill.zip

# 从备份恢复
hermes skill restore my-skill --from backup.zip

# 测试技能（不执行实际操作）
hermes skill test my-skill --dry-run

# 使用示例测试
hermes skill test my-skill --example 1

# 指定输入测试
hermes skill test my-skill --input "帮我审查代码"

# 启用调试输出
hermes skill test my-skill --debug

# 输出：
# [DEBUG] 加载技能: my-skill
# [DEBUG] 触发条件匹配: 0.85
# [DEBUG] 执行步骤 1...
# [DEBUG] 步骤 1 结果: OK
# [DEBUG] 执行步骤 2...
# [DEBUG] 步骤 2 结果: OK
# [DEBUG] 执行完成，耗时: 1.2s

# 查看技能使用统计
hermes skill stats my-skill

# 输出：
# name: my-skill
# total_runs: 156
# success_rate: 92%
# avg_duration: 45s
# avg_steps: 5.2
#
# 最近 7 天：
#   runs: 23
#   success: 21
#   avg_duration: 42s
#
# 最近 30 天：
#   runs: 89
#   success: 82
#   avg_duration: 48s

# 分析技能性能
hermes skill analyze my-skill

# 输出：
# 执行时间分布：
#   < 30s:  45%
#   30-60s: 35%
#   > 60s:  20%
#
# 失败原因分析：
#   权限问题: 3
#   超时: 2
#   配置错误: 1
#
# 优化建议：
#   - 步骤 3 可以并行执行
#   - 考虑添加缓存

┌─────────────────────────────────────────────────────────────────────┐
│                      MCP 架构                                        │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│     Hermes Agent                                                     │
│          │                                                           │
│          │ MCP Client                                                │
│          ▼                                                           │
│  ┌─────────────────┐                                                │
│  │  MCP Server     │ ← 外部进程                                      │
│  │  (例如天气服务)   │                                                │
│  └─────────────────┘                                                │
│          │                                                           │
│          ▼                                                           │
│  ┌─────────────────┐                                                │
│  │  真实服务        │                                                │
│  │  (Weather API)  │                                                │
│  └─────────────────┘                                                │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘

# config.yaml
mcp:
  servers:
    - name: weather
      command: npx
      args: ["-y", "@modelcontextprotocol/server-weather"]
      env:
        WEATHER_API_KEY: "${WEATHER_API_KEY}"
        
    - name: filesystem
      command: npx
      args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user"]

## 执行步骤

### 步骤 1：获取天气
使用 weather MCP 获取当前天气：
- 调用 weather.get_current(location="北京")
- 记录温度、湿度、天气状况

### 步骤 2：生成报告
基于天气数据生成推送报告。

# 1. 创建技能目录
mkdir -p ~/.hermes/memory/skills/github-issue-classifier
cd ~/.hermes/memory/skills/github-issue-classifier

# 2. 创建 SKILL.md
cat > SKILL.md << 'EOF'
...（见下方完整内容）
EOF

# 3. 本地测试
hermes skill test github-issue-classifier --dry-run

# 4. 发布到社区
hermes skill publish github-issue-classifier --public

# SKILL.md - GitHub Issue 自动分类

---
name: github-issue-classifier
version: "1.0.0"
author: your-username
created: "2026-05-11"
tags: [github, issue, classification, automation]
---

## 描述
自动分析 GitHub Issue 内容，进行分类、添加标签和分配负责人。

## 触发条件

### 触发词
- "分类 Issue"
- "classify issue"
- "处理 issue"
- "issue 分类"

### 触发场景
- 用户提供 Issue URL
- 用户提供 Issue 标题
- 用户要求自动处理 Issue

## 前置条件

### 必需工具
- github
- shell

### 必需配置
- GITHUB_TOKEN（具有 repo 写权限）

## 执行步骤

### 步骤 1：获取 Issue 信息
使用 GitHub API 获取 Issue 详情：
- 标题
- 正文
- 已有标签
- 创建者

### 步骤 2：分析 Issue 内容
使用 LLM 分析 Issue：
- 类型：bug / feature / docs / question / other
- 严重程度：高 / 中 / 低
- 需要标签
- 建议负责人

### 步骤 3：应用分类结果
根据分析结果：
1. 添加标签（bug/feature/docs/question + 严重程度）
2. 添加负责人（如适用）
3. 添加评论说明分类依据

### 步骤 4：生成报告
输出分类结果摘要。

## 变量

| 变量名 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| auto_assign | boolean | false | 是否自动分配 |
| add_comment | boolean | true | 是否添加评论 |
| team_members | array | [] | 团队成员列表 |

## 示例

### 示例 1：处理 Bug Issue
输入：帮我分类这个 Issue https://github.com/owner/repo/issues/123
输出：
## Issue 分类结果

**Issue**: #123 - API 返回数据格式不一致

**分类**：
- 类型：🐛 Bug
- 严重程度：高
- 建议标签：`bug`, `high-priority`

**操作**：
- ✅ 已添加标签：bug, high-priority
- ✅ 已添加评论

**负责人**：@developer-lead

### 示例 2：处理 Feature Issue
输入：分类这个 Issue："添加 OAuth2 支持"
输出：类似格式

## 配置示例

```yaml
skills:
  github-issue-classifier:
    auto_assign: true
    add_comment: true
    team_members:
      - "@alice"
      - "@bob"
      - "@charlie"

---

## 十二、技能管理命令完整参考

| 命令 | 功能 | 示例 |
|------|------|------|
| `/skills` | 列出所有技能 | `/skills` |
| `/skills search [keyword]` | 搜索技能 | `/skills search api` |
| `/skill [name]` | 查看技能详情 | `/skill github` |
| `/skill [name] run` | 执行技能 | `/skill github run` |
| `hermes skill install [name]` | 安装社区技能 | `hermes skill install api-testing` |
| `hermes skill publish [name]` | 发布技能 | `hermes skill publish my-skill` |
| `hermes skill remove [name]` | 删除技能 | `hermes skill remove my-skill` |
| `hermes skill update [name]` | 更新技能 | `hermes skill update my-skill` |
| `hermes skill test [name]` | 测试技能 | `hermes skill test my-skill` |
| `hermes skill stats [name]` | 查看统计 | `hermes skill stats my-skill` |
| `hermes skill export [name]` | 导出技能 | `hermes skill export my-skill` |
| `hermes skill import [path]` | 导入技能 | `hermes skill import ./my-skill.zip` |
| `hermes skill validate [name]` | 验证格式 | `hermes skill validate my-skill` |
| `hermes skill rollback [name]` | 回滚版本 | `hermes skill rollback my-skill` |
| `hermes skill info [name]` | 查看信息 | `hermes skill info my-skill` |

---

## 十三、最佳实践

### 13.1 技能设计原则

### 13.2 技能命名规范

### 13.3 技能分享礼仪

---

## 十四、总结

Skills 系统是 Hermes Agent 的核心能力：

| 能力 | 说明 | 价值 |
|------|------|------|
| **自动创建** | 解决复杂问题后自动生成 | 零成本积累 |
| **可复用** | 一次创建，永久使用 | 效率提升 |
| **可分享** | agentskills.io 社区生态 | 知识共享 |
| **自优化** | 使用中持续改进 | 越用越强 |
| **版本管理** | 支持版本控制 | 可回滚 |
| **统计分析** | 使用数据可见 | 数据驱动 |

掌握 Skills 系统，让 Hermes Agent 越来越强大——从个人助手进化为团队协作平台。

---

**系列文章预告：**

下一篇：《消息网关深度指南》——Telegram / Discord / 微信全接入。

---

*想创建自己的技能？在评论区分享你的想法！*