Hermes Agent Skills 深度指南：打造你的专属 AI 助手工具箱

---
name: skill-name
description: 技能描述
author: 作者名
version: 1.0.0
tags: [标签1, 标签2]
---

# 技能正文内容（Markdown）

## 触发条件
何时应该使用这个技能

## 工作流程
1. 第一步
2. 第二步
3. 第三步

## 注意事项
- 注意点1
- 注意点2

你：帮我 review 这个 PR
AI：（自动加载 github-code-review 技能）
     正在使用 github-code-review 技能分析代码...

你：使用 test-driven-development 技能开发登录功能
AI：（强制使用 TDD 流程）
     ✅ 第一步：编写失败的测试
     ✅ 第二步：实现最小代码使测试通过
     ✅ 第三步：重构优化

# 列出所有技能
hermes skills list

# 按分类查看
hermes skills list --category software-development

# 搜索技能
hermes skills search "debugging"

# 查看技能完整内容
hermes skills view nextjs-server-component-debugging

# 查看技能的关联文件
hermes skills view nextjs-server-component-debugging --files

~/.hermes/skills/
├── software-development/
│   ├── systematic-debugging/
│   │   ├── SKILL.md           # 主文件（必需）
│   │   ├── references/        # 参考资料
│   │   │   └── error-codes.md
│   │   ├── templates/         # 模板文件
│   │   │   └── bug-report.md
│   │   ├── scripts/           # 辅助脚本
│   │   │   └── collect-logs.sh
│   │   └── assets/            # 资源文件
│   │       └── diagram.png

---
name: my-custom-skill
description: 简短描述这个技能的用途
author: your-name
version: 1.0.0
tags: [tag1, tag2]
---

# {技能名称}

## 触发条件

在以下场景中使用这个技能：
- 场景1
- 场景2

## 前置条件

- 需要安装的工具
- 需要的权限
- 需要的环境变量

## 工作流程

### 第一步：准备阶段
1. 具体操作1
2. 具体操作2

### 第二步：执行阶段
\`\`\`bash
# 示例命令
command --arg value
\`\`\`

### 第三步：验证阶段
- 检查项1
- 检查项2

## 常见陷阱

### ⚠️ 陷阱1：问题描述
**症状**：
- 现象1
- 现象2

**原因**：根本原因分析

**解决方案**：
\`\`\`bash
solution command
\`\`\`

## 最佳实践

- 建议1
- 建议2

## 相关技能

- `related-skill-1`
- `related-skill-2`

# 创建新技能
hermes skills create my-skill --category devops

# 编辑技能
hermes skills edit my-skill

# 删除技能
hermes skills delete my-skill

# 添加关联文件
hermes skills add-file my-skill references/api-docs.md

你：构建一个 Next.js 博客系统，要求 TDD 开发并提交 PR

AI 工作流：
1. 加载 writing-plans 技能 → 生成实现计划
2. 加载 test-driven-development 技能 → 强制 TDD 流程
3. 加载 nextjs-vercel-deployment 技能 → 配置部署
4. 加载 github-pr-workflow 技能 → 提交规范 PR

systematic-debugging 技能
  ↓
  检测到 Next.js 500 错误
  ↓
  自动加载 nextjs-production-500-debugging 技能
  ↓
  发现是 TypeScript 类型错误
  ↓
  自动加载 nextjs-production-typescript-debug 技能

skills:
  enabled:
    - systematic-debugging
    - github-pr-workflow
    - nextjs-server-component-debugging
  disabled:
    - wordpress-development
  
  custom_triggers:
    - pattern: "debug.*500 error"
      skill: nextjs-production-500-debugging

你：生产环境 500 错误，但本地正常

AI（加载 systematic-debugging）：
1. 收集信息阶段
   - Vercel 日志分析 ✓
   - 错误堆栈提取 ✓
   
2. 环境差异对比
   - 发现：生产使用 Node 20，本地 Node 18
   
3. 加载 nextjs-production-500-debugging
   - 检查 Server Component 使用
   - 发现：使用了浏览器 API window 对象
   
4. 定位根因
   - 某组件缺少 'use client' 指令
   
5. 修复方案
   - 添加 'use client'
   - 部署验证
   
✅ 问题解决，总耗时：8 分钟

你：审查 PR #123

AI（加载 github-code-review）：
1. 获取 PR diff
2. 静态分析
   - 代码质量检查 ✓
   - 安全扫描 ✓
   - 性能分析 ✓
3. 生成审查报告
4. 提交 inline comments
5. 更新 PR 状态

✅ 完整审查流程自动化

hermes skills check-conflicts

# 更新单个技能
hermes skills update skill-name

# 更新所有技能
hermes skills update --all