Hermes Agent 进阶实操指南：从零搭建多 Agent 自动化工作流

# 安装 Hermes CLI（Go 单二进制，无依赖）
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# 或用 Go 安装
go install github.com/nousresearch/hermes-agent/cmd/hermes@latest

# 初始化配置（交互式引导）
hermes init

provider: nvidia
model: nvidia/nemotron-3-ultra-550b-a55b
api_key: nvapi-xxx...
default_profile: default
profiles:
  default:
    skills_dir: ~/.hermes/skills
    plugins_dir: ~/.hermes/plugins
    cron_dir: ~/.hermes/cron
    memories_dir: ~/.hermes/memories

# 查看内置技能
hermes skills list

# 官方技能仓库已内置 hermes-agent，直接用
hermes skill load hermes-agent

# 创建任务（交互式或直接用参数）
hermes cron create \
  --name "daily-morning-brief" \
  --schedule "0 7 * * *" \
  --prompt "每天早 7 点，用中文生成一份 200 字以内的科技早报，包含：AI 新进展、开源热点、一句话感悟。发到 Telegram Home 频道。" \
  --skills "web_search,telegram" \
  --deliver "telegram"

---
name: my-blog-deploy
description: "Hugo + Cloudflare Pages 双域名部署：本地构建 → wrangler 部署 → 验证 ningop.com + pages.dev 双域名 200"
category: devops
tags: [hugo, cloudflare, pages, deploy, blog]
version: "1.0"
author: "ningfeiyu"
---

# My Blog Deploy Skill

## 使用场景
- 写完文章后，一句指令完成：构建 → 部署 → 双域名验证
- 避免手动跑命令、忘记验证自定义域名导致 404

## 入参（自然语言即可，Agent 自动提取）
- `action`：deploy | verify | build-only
- `article_path`：可选，指定文章路径，默认全站

## 执行步骤
1. `hugo --buildFuture` 本地构建
2. `npx wrangler pages deploy public --project-name=ningop-blog --branch=main`
3. 等待 10 秒，并发验证：
   - `https://ningop.com/` 首页
   - `https://ningop.com/posts/<new-article>/` 新文
   - `https://<preview>.ningop-blog.pages.dev/posts/<new-article>/` 预览
   - 所有图片 `/images/xxx.jpg` 200
4. 汇总报告：✅/❌ + 耗时 + 失败详情

## 依赖
- hugo (extended)
- node + npx + wrangler
- Cloudflare API Token 已配置 `CLOUDFLARE_API_TOKEN` 环境变量或 `~/.wrangler/config/default.toml`

#!/usr/bin/env bash
set -euo pipefail

echo "🔨 Step 1: Hugo 构建..."
hugo --buildFuture

echo "🚀 Step 2: Wrangler 部署..."
DEPLOY_OUTPUT=$(npx wrangler pages deploy public --project-name=ningop-blog --branch=main 2>&1)
echo "$DEPLOY_OUTPUT"

PREVIEW_URL=$(echo "$DEPLOY_OUTPUT" | grep -oE 'https://[a-z0-9]+\.ningop-blog\.pages\.dev' | head -1)
echo "📍 Preview: $PREVIEW_URL"

echo "⏳ 等待 10 秒让边缘节点生效..."
sleep 10

echo "🔍 Step 3: 双域名验证..."
check_url() {
  local url=$1
  local code=$(curl -s -o /dev/null -w "%{http_code}" "$url" --max-time 15)
  if [[ "$code" == "200" ]]; then
    echo "  ✅ $url -> $code"
  else
    echo "  ❌ $url -> $code"
  fi
}

# 首页
check_url "https://ningop.com/"

# 如果传了文章路径，提取 slug 验证
if [[ -n "${ARTICLE_SLUG:-}" ]]; then
  check_url "https://ningop.com/posts/${ARTICLE_SLUG}/"
  check_url "${PREVIEW_URL}/posts/${ARTICLE_SLUG}/"
  check_url "https://ningop.com/images/${COVER_IMAGE:-cover.jpg}"
fi

echo "✅ 完成"

hermes skill load my-blog-deploy

目标：产出一篇「Hermes Agent 进阶指南」并部署到 ningop.com

子任务拆分（并行）：
1. researcher：搜集 Hermes 官方文档、GitHub Issues、最佳实践 → 输出结构化笔记
2. writer：按大纲写文章 Markdown → 输出文件路径
3. deployer：调用 my-blog-deploy 技能部署 → 输出验证报告

context 传递：
- 目标受众：AI Agent 新手、想落地自动化的开发者
- 文章风格：实操优先、有代码、有避坑、可复制粘贴
- 部署目标：ningop.com + pages.dev 双域名必须 200

# 伪代码：Hermes 内部实际用 delegate_task 工具
tasks = [
  {"goal": "搜集 Hermes 进阶用法...", "toolsets": ["web", "skill:hermes-agent"], "context": "..."},
  {"goal": "写文章...", "toolsets": ["file", "terminal"], "context": "..."},
  {"goal": "部署验证...", "toolsets": ["terminal", "skill:my-blog-deploy"], "context": "..."},
]
results = delegate_task(tasks=tasks)
# 父 Agent 收集结果，汇总给用户

name: filesystem
command: npx
args: ["-y", "@modelcontextprotocol/server-filesystem", "/root/ningfeiyu.github.io"]
transport: stdio

hermes mcp add filesystem.yaml
hermes mcp list  # 确认 running

name: github
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
env:
  GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx..."
transport: stdio

name: Deploy to Cloudflare Pages
on:
  push:
    branches: [main]
  workflow_dispatch:

permissions:
  contents: read
  deployments: write

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          submodules: recursive

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v2
        with:
          hugo-version: '0.147.0'
          extended: true

      - name: Build
        run: hugo --buildFuture --minify

      - name: Deploy to Cloudflare Pages
        uses: cloudflare/pages-action@v1
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          projectName: ningop-blog
          directory: public
          branch: main
          wranglerVersion: 'latest'

      - name: Verify Custom Domain
        run: |
          sleep 15
          for url in \
            "https://ningop.com/" \
            "https://ningop.com/posts/$(ls -t content/posts/*.md | head -1 | xargs basename -s .md)/" \
            "https://${{ github.run_id }}.ningop-blog.pages.dev/"; do
            code=$(curl -s -o /dev/null -w "%{http_code}" "$url" --max-time 20)
            echo "$url -> $code"
            if [[ "$code" != "200" ]]; then exit 1; fi
          done

hermes cron create \
  --name "daily-tech-brief" \
  --schedule "0 23 * * *" \
  --prompt "生成中文科技日报：AI 进展、开源热榜、一句话感悟，≤300 字。投递 Telegram Home。" \
  --skills "web_search,telegram" \
  --deliver "telegram"

hermes cron create \
  --name "weekly-blog-sync" \
  --schedule "0 2 * * 1" \
  --prompt "读取本周 GitHub 提交、部署记录、新文章，生成周报 Markdown，存入 content/posts/weekly-YYYY-MM-DD.md，调用 my-blog-deploy 部署。" \
  --skills "github,my-blog-deploy,terminal" \
  --deliver "origin"

# ~/.hermes/skills/code-review/SKILL.md 片段
context: |
  你是严格的代码审查员。收到 PR 链接后：
  1. 用 gh pr diff 拉取变更
  2. 逐文件检查：安全、性能、可读性、测试覆盖
  3. 输出：通过/拒绝 + 具体行内建议（可直接 gh pr comment）
  4. 必须给出可执行的修复命令或代码片段