oh-my-hermes-workflow

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

oh-my-hermes-workflow

Oh My Hermes 工作流

Skill by ara.so — Hermes Skills collection.

Oh My Hermes is an opinionated workflow layer for building, shipping, and operating apps with Hermes Agent. It provides 23+ curated skills that enable Hermes to autonomously handle the complete software lifecycle — from requirements clarification to production deployment and monitoring.

由ara.so开发的Skill — Hermes Skills合集。

Oh My Hermes是一个基于Hermes Agent的 opinionated 工作流层，用于构建、发布和运维应用。它提供了23+个精心筛选的Skill，让Hermes能够自主处理完整的软件生命周期——从需求澄清到生产部署和监控。

What Oh My Hermes Does

Oh My Hermes 功能介绍

Full Project Lifecycle: Takes projects from idea to production with autonomous workflows
Autonomous CTO Loop: Hourly issue triage, implementation, security review, and deployment approval flow
Multi-Agent Orchestration: PM, Dev, QA, Security, and Ops agents working together via Kanban
Persistent Memory: Hermes remembers project context, requirements, and decisions across sessions
Integration Layer: Connects Hermes with Claude Code, Codex, Vercel, Supabase, GitHub, Sentry

全项目生命周期：通过自主工作流将项目从想法推进到生产环境
自主CTO循环：每小时进行问题分类、开发实现、安全审查和部署审批流程
多Agent编排：PM、Dev、QA、Security和Ops Agent通过看板协同工作
持久化记忆：Hermes在不同会话中保留项目上下文、需求和决策信息
集成层：将Hermes与Claude Code、Codex、Vercel、Supabase、GitHub、Sentry集成

Installation

安装步骤

Prerequisites

前置条件

Install Hermes Agent first: Follow Hermes quickstart
Configure messaging: Set up Telegram, Slack, Discord, or WhatsApp gateway
Verify Hermes is running: Test by messaging your Hermes bot

先安装Hermes Agent：按照Hermes快速开始指南操作
配置消息通道：设置Telegram、Slack、Discord或WhatsApp网关
验证Hermes运行状态：通过向Hermes机器人发送消息进行测试

Install Oh My Hermes

安装Oh My Hermes

bash

undefined

bash

undefined

One-line install

一键安装

curl -fsSL https://raw.githubusercontent.com/salomondiei08/oh-my-hermes/main/install.sh | bash

Or clone and install manually

或克隆仓库手动安装

git clone https://github.com/salomondiei08/oh-my-hermes /tmp/oh-my-hermes bash /tmp/oh-my-hermes/install.sh

undefined

git clone https://github.com/salomondiei08/oh-my-hermes /tmp/oh-my-hermes bash /tmp/oh-my-hermes/install.sh

undefined

Bootstrap a Project

初始化项目

bash

undefined

bash

undefined

Navigate to your project directory

进入项目目录

cd /path/to/your/project

Run bootstrap script

运行初始化脚本

bash /tmp/oh-my-hermes/scripts/bootstrap.sh

Verify installation

验证安装

bash /tmp/oh-my-hermes/scripts/verify.sh

undefined

bash /tmp/oh-my-hermes/scripts/verify.sh

undefined

Message-Based Setup (Recommended)

基于消息的配置（推荐）

Once installed, message your Hermes bot:

set up the CTO loop

Hermes will guide you through:

GitHub repository configuration
Fine-grained token creation
Production URL setup
Webhook configuration
Monitoring setup

安装完成后，向你的Hermes机器人发送消息：

set up the CTO loop

Hermes会引导你完成以下配置：

GitHub仓库配置
细粒度令牌创建
生产环境URL设置
Webhook配置
监控设置

Key Skills

核心Skill

Oh My Hermes provides 23+ skills loaded into

~/.hermes/skills/

Oh My Hermes提供的23+个Skill会被加载到

~/.hermes/skills/

Onboarding & Planning

入门与规划

onboarding

bash

undefined

onboarding

bash

undefined

Trigger in Hermes chat

在Hermes聊天中触发

"walk me through setting up oh my hermes"

Guides full setup in chat — no terminal required.

**clarify-requirements**
```bash

"walk me through setting up oh my hermes"

在聊天中引导完成完整设置——无需使用终端。

**clarify-requirements**
```bash

Trigger in Hermes chat

在Hermes聊天中触发

"start a new app" "clarify requirements for this project"

Asks 7 structured questions, saves answers to Hermes memory.

**product-brief**
```bash

"start a new app" "clarify requirements for this project"

提出7个结构化问题，并将答案保存到Hermes记忆中。

**product-brief**
```bash

Trigger after clarify-requirements

在clarify-requirements之后触发

"generate the product brief"

Creates `PRODUCT_BRIEF.md` from requirements.

**design-handoff**
```bash

"generate the product brief"

根据需求生成`PRODUCT_BRIEF.md`文档。

**design-handoff**
```bash

Trigger in Hermes chat

在Hermes聊天中触发

"convert my design to implementation spec"

Transforms design notes into technical specifications.

"convert my design to implementation spec"

将设计说明转换为技术规格文档。

Implementation

开发实现

choose-engine

bash

undefined

choose-engine

bash

undefined

Trigger in Hermes chat

在Hermes聊天中触发

"implement this feature"

Routes tasks to Hermes, Claude Code, or Codex based on complexity.

**implement-with-claude-code**
```bash

"implement this feature"

根据任务复杂度将其路由到Hermes、Claude Code或Codex。

**implement-with-claude-code**
```bash

Invoked by choose-engine for complex multi-file tasks

由choose-engine调用，处理复杂的多文件任务

Scaffolds Claude Code with:

为Claude Code提供以下支持：

- Full project context

- 完整项目上下文

- Scope constraints

- 范围约束

- Security guardrails

- 安全防护规则


**implement-with-codex**
```bash


**implement-with-codex**
```bash

Invoked by choose-engine for single-file fixes

由choose-engine调用，处理单文件修复

Quick targeted edits

快速针对性编辑

undefined

undefined

Deployment

部署发布

deploy-to-vercel

bash

undefined

deploy-to-vercel

bash

undefined

Trigger in Hermes chat

在Hermes聊天中触发

"deploy to vercel" "ship this to production"


Example workflow:
1. Pre-deploy checks (secrets scan, build validation)
2. Deploys to Vercel
3. Captures preview/production URL
4. Runs health checks
5. Notifies via configured channel

**connect-supabase**
```bash

"deploy to vercel" "ship this to production"


示例工作流：
1. 部署前检查（密钥扫描、构建验证）
2. 部署到Vercel
3. 获取预览/生产环境URL
4. 运行健康检查
5. 通过配置的通道发送通知

**connect-supabase**
```bash

Trigger in Hermes chat

在Hermes聊天中触发

"connect supabase" "set up database"


Handles:
- Database linking
- Migration pushing
- Environment variable configuration in Vercel
- Connection validation

"connect supabase" "set up database"


处理以下操作：
- 数据库关联
- 迁移推送
- 在Vercel中配置环境变量
- 连接验证

Monitoring

监控运维

setup-monitoring

bash

undefined

setup-monitoring

bash

undefined

Trigger in Hermes chat

在Hermes聊天中触发

"set up monitoring"


Configures:
- Sentry error tracking
- Uptime Kuma health checks
- Alert webhooks

**health-check**
```bash

"set up monitoring"


配置以下内容：
- Sentry错误追踪
- Uptime Kuma健康检查
- 告警Webhook

**health-check**
```bash

Runs automatically every 15 minutes

每15分钟自动运行

Manual trigger:

手动触发：

"run health check"


Validates:
- `/api/health` endpoint response
- Supabase connectivity
- Vercel deployment status
- Response times

"run health check"


验证以下项：
- `/api/health`端点响应
- Supabase连接状态
- Vercel部署状态
- 响应时间

GitHub Integration

GitHub集成

manage-github-issues

bash

undefined

manage-github-issues

bash

undefined

Trigger in Hermes chat

在Hermes聊天中触发

"triage github issues" "create issue for bug in login" "close issue #42"


**create-github-pr**
```bash

"triage github issues" "create issue for bug in login" "close issue #42"


**create-github-pr**
```bash

Automatic during implementation workflow

在开发工作流中自动执行

Includes:

包含：

- Secret scan before PR creation

PR创建前的密钥扫描

- Conventional commit messages

规范的提交信息

- Linked issue references

关联的问题引用


**auto-issue-triage**
```bash


**auto-issue-triage**
```bash

Runs hourly via cron

通过cron每小时运行

Scores issues by:

根据以下维度为问题评分：

- User impact

- 用户影响

- Business priority

- 业务优先级

- Technical debt

- 技术债务

Picks top priority and starts implementation

选择最高优先级问题并开始开发


**review-github-pr**
```bash


**review-github-pr**
```bash

Automatic when PR is ready

PR就绪后自动执行

Provides:

提供：

- Diff analysis

- 差异分析

- Security checks

- 安全检查

- Plain-English summary

- 通俗易懂的总结

- Preview URL validation

- 预览URL验证


**security-review**
```bash


**security-review**
```bash

Runs on every PR

每个PR都会运行

Weekly supply chain audit

每周进行供应链审计

"run security review on PR #12"


Checks:
- Secret scanning (no API keys, tokens)
- OWASP top 10 vulnerabilities
- CVE audit of dependencies
- Supply chain security (weekly)

"run security review on PR #12"


检查内容：
- 密钥扫描（无API密钥、令牌）
- OWASP十大漏洞
- 依赖项的CVE审计
- 供应链安全（每周）

Configuration

配置说明

Environment Variables

环境变量

Create

.hermes/config.env

bash

undefined

创建

.hermes/config.env

文件：

bash

undefined

GitHub Integration

GitHub集成

GITHUB_OWNER=your-username GITHUB_REPO=your-repo GITHUB_TOKEN=${GITHUB_TOKEN} # Fine-grained token with repo access

GITHUB_OWNER=your-username GITHUB_REPO=your-repo GITHUB_TOKEN=${GITHUB_TOKEN} # 拥有仓库访问权限的细粒度令牌

Deployment

部署配置

VERCEL_TOKEN=${VERCEL_TOKEN} # Vercel API token VERCEL_PROJECT_ID=${VERCEL_PROJECT_ID} VERCEL_ORG_ID=${VERCEL_ORG_ID}

VERCEL_TOKEN=${VERCEL_TOKEN} # Vercel API令牌 VERCEL_PROJECT_ID=${VERCEL_PROJECT_ID} VERCEL_ORG_ID=${VERCEL_ORG_ID}

Database

数据库配置

SUPABASE_URL=${SUPABASE_URL} SUPABASE_ANON_KEY=${SUPABASE_ANON_KEY} SUPABASE_SERVICE_KEY=${SUPABASE_SERVICE_KEY}

Monitoring

监控配置

SENTRY_DSN=${SENTRY_DSN} UPTIME_KUMA_URL=${UPTIME_KUMA_URL} UPTIME_KUMA_TOKEN=${UPTIME_KUMA_TOKEN}

Notifications

通知配置

SLACK_WEBHOOK_URL=${SLACK_WEBHOOK_URL} TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN} TELEGRAM_CHAT_ID=${TELEGRAM_CHAT_ID}

Production

生产环境

PRODUCTION_URL=https://yourapp.com

undefined

PRODUCTION_URL=https://yourapp.com

undefined

Hermes Memory Configuration

Hermes记忆配置

Oh My Hermes stores project context in Hermes memory at:

~/.hermes/memory/
  ├── requirements.json      # From clarify-requirements
  ├── product-brief.md       # Generated brief
  ├── kanban-state.json      # Current task status
  └── deployment-log.json    # Deployment history

Oh My Hermes将项目上下文存储在Hermes记忆目录中：

~/.hermes/memory/
  ├── requirements.json      # 来自clarify-requirements的结果
  ├── product-brief.md       # 生成的产品 brief
  ├── kanban-state.json      # 当前任务状态
  └── deployment-log.json    # 部署历史

Kanban Configuration

看板配置

The autonomous loop uses a simple Kanban:

Backlog → In Progress → Review → Done

Stored in

~/.hermes/memory/kanban-state.json

json

{
  "backlog": [
    {"id": "issue-42", "priority": 8, "title": "Fix login redirect"}
  ],
  "in_progress": [
    {"id": "issue-39", "assigned": "dev-agent", "started": "2026-05-16T10:00:00Z"}
  ],
  "review": [
    {"id": "pr-12", "reviewer": "security-agent", "checks": ["secret-scan", "owasp"]}
  ],
  "done": [
    {"id": "issue-38", "completed": "2026-05-15T14:30:00Z", "deployed": true}
  ]
}

自主循环使用简单的看板流程：

待办 → 进行中 → 审查 → 完成

状态存储在

~/.hermes/memory/kanban-state.json

：

json

{
  "backlog": [
    {"id": "issue-42", "priority": 8, "title": "Fix login redirect"}
  ],
  "in_progress": [
    {"id": "issue-39", "assigned": "dev-agent", "started": "2026-05-16T10:00:00Z"}
  ],
  "review": [
    {"id": "pr-12", "reviewer": "security-agent", "checks": ["secret-scan", "owasp"]}
  ],
  "done": [
    {"id": "issue-38", "completed": "2026-05-15T14:30:00Z", "deployed": true}
  ]
}

Real-World Workflows

实际工作流示例

Start a New App from Scratch

从零开始创建新应用

Message your Hermes bot:

Start a new app called TaskFlow — a Kanban board for small teams

Hermes will:

Load
```
clarify-requirements
```
skill
Ask 7 questions about your app
Generate
```
PRODUCT_BRIEF.md
```
Run
```
choose-engine
```
to decide implementation approach
Implement the app
Deploy to Vercel
Set up monitoring

向Hermes机器人发送消息：

Start a new app called TaskFlow — a Kanban board for small teams

Hermes会执行以下操作：

加载
```
clarify-requirements
```
Skill
询问7个关于应用的问题
生成
```
PRODUCT_BRIEF.md
```
运行
```
choose-engine
```
确定开发方案
实现应用功能
部署到Vercel
设置监控

Implement a Feature

实现新功能

Message your Hermes bot:

Add Google OAuth login to the app

Hermes workflow:

Creates GitHub issue
Dev Agent implements
Security Agent scans for secrets
QA Agent validates build and preview
Sends you approval message:

PR #15 — Add Google OAuth login

What changed: Users can now sign in with Google.
Added /api/auth/google endpoint and callback handler.

Build: passing | Preview: healthy (200ms) | No secrets found
Preview: https://taskflow-oauth.vercel.app

Reply YES to ship. Reply NO and tell me why.

You reply
```
YES
```
Merges, deploys, health-checks, confirms

向Hermes机器人发送消息：

Add Google OAuth login to the app

Hermes工作流：

创建GitHub问题
Dev Agent开发实现
Security Agent扫描密钥
QA Agent验证构建和预览
向你发送审批消息：

PR #15 — Add Google OAuth login

What changed: Users can now sign in with Google.
Added /api/auth/google endpoint and callback handler.

Build: passing | Preview: healthy (200ms) | No secrets found
Preview: https://taskflow-oauth.vercel.app

Reply YES to ship. Reply NO and tell me why.

你回复
```
YES
```
合并PR、部署、健康检查、确认完成

Manual Deployment

手动部署

bash

undefined

bash

undefined

From your project directory

进入项目目录

cd /path/to/your/project

Message Hermes:

向Hermes发送消息:

"deploy to vercel"

Or run skill directly (if configured)

或直接运行Skill（已配置的情况下）

hermes run deploy-to-vercel

undefined

hermes run deploy-to-vercel

undefined

Security Audit

安全审计

bash

undefined

bash

undefined

Message Hermes:

向Hermes发送消息:

"run security review on main branch"

Hermes will:

Hermes会执行:

- Scan for hardcoded secrets

- 扫描硬编码密钥

- Check dependencies for CVEs

- 检查依赖项的CVE

- Run OWASP checks

- 运行OWASP检查

- Generate report

- 生成报告

undefined

undefined

Health Check

健康检查

bash

undefined

bash

undefined

Message Hermes:

向Hermes发送消息:

"check if production is healthy"

Hermes validates:

Hermes会验证:

- Production URL responds

- 生产URL响应正常

- Database is connected

- 数据库连接正常

- API endpoints work

- API端点可用

- Response times are acceptable

- 响应时间符合要求

undefined

undefined

Autonomous CTO Loop

自主CTO循环

Once configured, this runs every hour automatically:

┌─────────────────────────────────────────┐
│  GitHub Issue Opened (#42)              │
└───────────┬─────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────┐
│  PM Agent (auto-issue-triage)           │
│  - Scores issue: priority 8/10          │
│  - Moves to Backlog                     │
└───────────┬─────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────┐
│  Dev Agent (implement)                  │
│  - Moves to In Progress                 │
│  - Writes code                          │
│  - Creates PR #12                       │
└───────────┬─────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────┐
│  Security Agent (security-review)       │
│  - Secret scan: PASS                    │
│  - OWASP check: PASS                    │
│  - CVE scan: PASS                       │
└───────────┬─────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────┐
│  QA Agent (review-github-pr)            │
│  - Build: passing                       │
│  - Health check: 180ms                  │
│  - Plain-English summary written        │
│  - Moves to Review                      │
└───────────┬─────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────┐
│  Notification Sent (YOU on Telegram)    │
│  "PR #12 ready. Reply YES to ship."     │
└───────────┬─────────────────────────────┘
            │
     ┌──────┴──────┐
     │             │
     ▼             ▼
  ┌─────┐      ┌──────┐
  │ YES │      │  NO  │
  └──┬──┘      └───┬──┘
     │             │
     │             ▼
     │      ┌────────────────┐
     │      │ Dev Agent      │
     │      │ iterates on    │
     │      │ your feedback  │
     │      └────────────────┘
     │
     ▼
┌─────────────────────────────────────────┐
│  Ops Agent                              │
│  - Merges PR                            │
│  - Deploys to production                │
│  - Runs health check                    │
│  - Confirms live URL                    │
│  - Moves to Done                        │
└─────────────────────────────────────────┘

配置完成后，以下流程每小时自动运行：

┌─────────────────────────────────────────┐
│  GitHub Issue Opened (#42)              │
└───────────┬─────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────┐
│  PM Agent (auto-issue-triage)           │
│  - 问题评分：优先级8/10                 │
│  - 移至待办队列                         │
└───────────┬─────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────┐
│  Dev Agent (implement)                  │
│  - 移至进行中                           │
│  - 编写代码                             │
│  - 创建PR #12                           │
└───────────┬─────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────┐
│  Security Agent (security-review)       │
│  - 密钥扫描：通过                        │
│  - OWASP检查：通过                       │
│  - CVE扫描：通过                         │
└───────────┬─────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────┐
│  QA Agent (review-github-pr)            │
│  - 构建：通过                           │
│  - 健康检查：180ms                      │
│  - 编写通俗易懂的总结                   │
│  - 移至审查队列                         │
└───────────┬─────────────────────────────┘
            │
            ▼
┌─────────────────────────────────────────┐
│  发送通知（你在Telegram上）             │
│  "PR #12已就绪，回复YES发布。"           │
└───────────┬─────────────────────────────┘
            │
     ┌──────┴──────┐
     │             │
     ▼             ▼
  ┌─────┐      ┌──────┐
  │ YES │      │  NO  │
  └──┬──┘      └───┬──┘
     │             │
     │             ▼
     │      ┌────────────────┐
     │      │ Dev Agent      │
     │      │ 根据你的反馈迭代 │
     │      └────────────────┘
     │
     ▼
┌─────────────────────────────────────────┐
│  Ops Agent                              │
│  - 合并PR                               │
│  - 部署到生产环境                       │
│  - 运行健康检查                         │
│  - 确认URL已上线                        │
│  - 移至完成队列                         │
└─────────────────────────────────────────┘

Common Patterns

常见使用模式

Goal-Oriented Sessions

目标导向会话

Use

/goal

command to keep Hermes focused:

/goal Build a working MVP of TaskFlow with Google OAuth, deploy to Vercel, and set up monitoring — all within the next 2 hours

Hermes will:

Break down the goal into sub-tasks
Execute each step autonomously
Check in with you at key decision points
Persist progress across interruptions

使用

/goal

命令让Hermes保持专注：

/goal Build a working MVP of TaskFlow with Google OAuth, deploy to Vercel, and set up monitoring — all within the next 2 hours

Hermes会：

将目标分解为子任务
自主执行每个步骤
在关键决策点与你确认
中断后仍能保留进度

Custom Skill Creation

自定义Skill创建

Create project-specific skills:

bash

undefined

创建项目专属Skill：

bash

undefined

Message Hermes:

向Hermes发送消息:

"create a new skill for automated database backups"

Hermes will:

Hermes会:

- Use create-skill meta-skill

- 使用create-skill元Skill

- Generate skill template

- 生成Skill模板

- Save to ~/.hermes/skills/db-backup.md

- 保存到~/.hermes/skills/db-backup.md

- Make it available for invocation

- 使其可被调用


Skill structure:

```markdown
---
name: db-backup
description: Automated Supabase database backup to S3
triggers:
  - "backup the database"
  - "create db backup"
---


Skill结构示例：

```markdown
---
name: db-backup
description: Automated Supabase database backup to S3
triggers:
  - "backup the database"
  - "create db backup"
---

db-backup

What it does

功能说明

Creates timestamped backup of Supabase database and uploads to S3.

创建带时间戳的Supabase数据库备份并上传到S3。

Prerequisites

前置条件

Supabase CLI installed
AWS credentials configured
S3 bucket created

已安装Supabase CLI
已配置AWS凭证
已创建S3存储桶

Steps

步骤

Export database:
```
supabase db dump -f backup.sql
```
Compress:
```
gzip backup.sql
```

Upload:

aws s3 cp backup.sql.gz s3://my-backups/$(date +%Y%m%d-%H%M%S).sql.gz

Verify upload
Clean up local files
Notify completion

导出数据库：
```
supabase db dump -f backup.sql
```
压缩文件：
```
gzip backup.sql
```

上传到S3：

aws s3 cp backup.sql.gz s3://my-backups/$(date +%Y%m%d-%H%M%S).sql.gz

验证上传结果
清理本地文件
发送完成通知

Configuration

配置项

S3_BUCKET=${S3_BUCKET}
SUPABASE_PROJECT_REF=${SUPABASE_PROJECT_REF}

undefined

S3_BUCKET=${S3_BUCKET}
SUPABASE_PROJECT_REF=${SUPABASE_PROJECT_REF}

undefined

Scheduled Tasks

定时任务

Configure cron jobs in

~/.hermes/cron.d/

bash

undefined

在

~/.hermes/cron.d/

中配置cron任务：

bash

undefined

Hourly issue triage

每小时问题分类

0 * * * * hermes run auto-issue-triage

Daily deployment report

每日部署报告

0 9 * * * hermes run daily-report

Weekly security audit

每周安全审计

0 2 * * 0 hermes run security-review --full-audit

Every 15 minutes health check

每15分钟健康检查

*/15 * * * * hermes run health-check

undefined

*/15 * * * * hermes run health-check

undefined

Integration with Claude Code

与Claude Code集成

When a task requires deep multi-file editing:

bash

undefined

当任务需要深度多文件编辑时：

bash

undefined

Message Hermes:

向Hermes发送消息:

"refactor the authentication system to use sessions instead of JWT"

Hermes workflow:

Hermes工作流:

1. choose-engine analyzes complexity

1. choose-engine分析复杂度

2. Determines Claude Code is needed

2. 确定需要使用Claude Code

3. Scaffolds Claude Code session with:

3. 为Claude Code会话提供以下支持:

- Full project context

- 完整项目上下文

- Relevant files identified

- 识别相关文件

- Scope constraints

- 范围约束

- Security requirements

- 安全要求

4. Claude Code performs refactor

4. Claude Code执行重构

5. Hermes reviews changes

5. Hermes审查变更

6. Creates PR for your approval

6. 创建PR供你审批

undefined

undefined

Troubleshooting

故障排查

Hermes Not Loading Skills

Hermes未加载Skill

bash

undefined

bash

undefined

Verify skills directory

验证Skill目录

ls -la ~/.hermes/skills/

Re-run installer

重新运行安装脚本

bash /tmp/oh-my-hermes/install.sh

Check Hermes logs

查看Hermes日志

tail -f ~/.hermes/logs/hermes.log

undefined

tail -f ~/.hermes/logs/hermes.log

undefined

GitHub Integration Failing

GitHub集成失败

bash

undefined

bash

undefined

Verify token has correct permissions

验证令牌权限

Required: repo (full), workflow, admin:repo_hook

所需权限：repo（完整）、workflow、admin:repo_hook

Test token manually

手动测试令牌

curl -H "Authorization: Bearer ${GITHUB_TOKEN}"
https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}

Reconfigure in Hermes chat:

在Hermes聊天中重新配置:

"reconfigure github integration"

undefined

"reconfigure github integration"

undefined

Deployment Issues

部署问题

bash

undefined

bash

undefined

Verify Vercel token

验证Vercel令牌

vercel whoami

Check environment variables are set

检查环境变量是否已设置

hermes run verify-env

View deployment logs

查看部署日志

vercel logs ${VERCEL_PROJECT_ID}

Manual health check

手动健康检查

curl https://your-production-url.vercel.app/api/health

undefined

curl https://your-production-url.vercel.app/api/health

undefined

Monitoring Not Working

监控不工作

bash

undefined

bash

undefined

Verify Sentry DSN

验证Sentry DSN

echo ${SENTRY_DSN}

Test Uptime Kuma connection

测试Uptime Kuma连接

curl ${UPTIME_KUMA_URL}/api/status

Reconfigure monitoring

重新配置监控

"set up monitoring again"

undefined

"set up monitoring again"

undefined

Autonomous Loop Not Running

自主循环未运行

bash

undefined

bash

undefined

Check cron jobs are configured

检查cron任务是否已配置

crontab -l | grep hermes

Verify Hermes daemon is running

验证Hermes守护进程是否运行

ps aux | grep hermes

Restart Hermes

重启Hermes

systemctl restart hermes # if using systemd

systemctl restart hermes # 使用systemd的情况下

or

或

hermes restart

Check kanban state

查看看板状态

cat ~/.hermes/memory/kanban-state.json

undefined

cat ~/.hermes/memory/kanban-state.json

undefined

Advanced Configuration

高级配置

Custom Agent Behavior

自定义Agent行为

Modify agent behavior in

~/.hermes/config/agents.yaml

yaml

agents:
  pm:
    issue_scoring:
      user_impact_weight: 0.4
      business_priority_weight: 0.3
      technical_debt_weight: 0.3
    auto_triage_frequency: "0 * * * *"  # Hourly
  
  dev:
    max_parallel_tasks: 2
    preferred_engine: "claude-code"  # or "codex" or "hermes"
    
  security:
    require_all_checks: true
    fail_on_secrets: true
    weekly_audit_day: "sunday"
    
  qa:
    health_check_timeout: 5000  # ms
    required_response_time: 1000  # ms
    
  ops:
    auto_merge_on_approval: true
    deployment_health_check_retries: 3

在

~/.hermes/config/agents.yaml

中修改Agent行为：

yaml

agents:
  pm:
    issue_scoring:
      user_impact_weight: 0.4
      business_priority_weight: 0.3
      technical_debt_weight: 0.3
    auto_triage_frequency: "0 * * * *"  # 每小时
  
  dev:
    max_parallel_tasks: 2
    preferred_engine: "claude-code"  # 或 "codex" 或 "hermes"
    
  security:
    require_all_checks: true
    fail_on_secrets: true
    weekly_audit_day: "sunday"
    
  qa:
    health_check_timeout: 5000  # 毫秒
    required_response_time: 1000  # 毫秒
    
  ops:
    auto_merge_on_approval: true
    deployment_health_check_retries: 3

Notification Templates

通知模板

Customize notification format in

~/.hermes/config/notifications.yaml

yaml

templates:
  pr_ready:
    title: "PR #{pr_number} — {pr_title}"
    body: |
      What changed: {summary}
      
      Build: {build_status} | Preview: {health_status} ({response_time}ms)
      Security: {security_status}
      Preview: {preview_url}
      
      Reply YES to ship. Reply NO and tell me why.
    
  deployment_success:
    title: "✅ Deployed to production"
    body: |
      {project_name} v{version}
      URL: {production_url}
      Health: {health_status}
      Deploy time: {deploy_time}s

在

~/.hermes/config/notifications.yaml

中自定义通知格式：

yaml

templates:
  pr_ready:
    title: "PR #{pr_number} — {pr_title}"
    body: |
      变更内容：{summary}
      
      构建状态：{build_status} | 预览状态：{health_status} ({response_time}ms)
      安全检查：{security_status}
      预览URL：{preview_url}
      
      回复YES发布，回复NO并说明原因。
    
  deployment_success:
    title: "✅ 已部署到生产环境"
    body: |
      {project_name} v{version}
      URL：{production_url}
      健康状态：{health_status}
      部署耗时：{deploy_time}秒

Best Practices

最佳实践

Start with onboarding: Message
```
"set up oh my hermes"
```
— let the bot guide you
Use /goal for focus: Keep long sessions on track with explicit goals
Review security scans: Always check security-review output before merging
Monitor health checks: Configure alerts for failed health checks
Backup Hermes memory:
```
~/.hermes/memory/
```
contains valuable project context
Version control skills: Commit custom skills to your repo in
```
.hermes/skills/
```
Test in preview: Always validate preview URLs before approving production deploys
Keep tokens secure: Never commit tokens — use
```
.env
```
files and
```
.gitignore
```

从入门引导开始：发送消息
```
"set up oh my hermes"
```
— 让机器人引导你完成设置
使用/goal保持专注：通过明确的目标让长会话不偏离方向
审查安全扫描结果：合并前务必查看security-review的输出
监控健康检查：为失败的健康检查配置告警
备份Hermes记忆：
```
~/.hermes/memory/
```
包含有价值的项目上下文
版本控制自定义Skill：将自定义Skill提交到你的仓库
```
.hermes/skills/
```
目录
在预览环境测试：批准生产部署前务必验证预览URL
保护令牌安全：永远不要提交令牌 — 使用
```
.env
```
文件和
```
.gitignore
```

Integration Reference

集成参考

Vercel

bash

undefined

bash

undefined

Deploy

部署

vercel deploy --prod

Get deployment URL

获取部署URL

vercel ls ${PROJECT_NAME} --json | jq -r '.[0].url'

Set environment variable

设置环境变量

vercel env add SUPABASE_URL production

undefined

vercel env add SUPABASE_URL production

undefined

Supabase

bash

undefined

bash

undefined

Push migrations

推送迁移

supabase db push

Get connection string

获取连接字符串

supabase db connection-string

Run query

执行查询

supabase db query "SELECT * FROM users LIMIT 1"

undefined

supabase db query "SELECT * FROM users LIMIT 1"

undefined

GitHub API

bash

undefined

bash

undefined

Create issue

创建问题

curl -X POST
-H "Authorization: Bearer ${GITHUB_TOKEN}"
-H "Content-Type: application/json"
https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}/issues
-d '{"title": "Bug in login", "body": "Description", "labels": ["bug"]}'

Create PR

创建PR

curl -X POST
-H "Authorization: Bearer ${GITHUB_TOKEN}"
-H "Content-Type: application/json"
https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}/pulls
-d '{"title": "Fix login", "head": "fix-login", "base": "main", "body": "Fixes #42"}'

undefined

undefined

Sentry

bash

undefined

bash

undefined

Initialize

初始化

sentry-cli init

Upload source maps

上传源映射

sentry-cli releases files ${VERSION} upload-sourcemaps ./dist


This skill enables AI coding agents to guide developers through installing, configuring, and using Oh My Hermes to build autonomous software development workflows with Hermes Agent.

sentry-cli releases files ${VERSION} upload-sourcemaps ./dist


本Skill使AI编码Agent能够引导开发者安装、配置和使用Oh My Hermes，通过Hermes Agent构建自主软件开发工作流。