# hermes-workflow-rules

**Repository Path**: shdowzh/hermes-workflow-rules

## Basic Information

- **Project Name**: hermes-workflow-rules
- **Description**: 三段式 Hermes Agent 固定工作流：前置检查 + 结构化规划 + 5W1H 知识分层。仅靠提示词约束智能体严格按流程运行。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-14
- **Last Updated**: 2026-06-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Hermes Workflow Rules

> 三段式 Hermes Agent 固定工作流——仅靠提示词，约束智能体严格按流程运行。

为解决 Hermes 智能体 **自行臆测、越权执行、知识体系陈旧** 三类核心缺陷，本仓库提供一套三段式固定工作流，仅依靠提示词即可约束智能体严格遵循，落地实测效果显著。

---

## 🎯 设计思路

### 1. 前置检查流程 —— 弥补训练数据滞后

读取真实时间 → 三级联网判断 → 核验运行环境 → 输出执行计划。

**联网判定准则**：
- 时效信息 → 强制联网
- 主观分析 → 直接回复
- 中间场景 → 以 **100% 确信度阈值** 兜底

### 2. 结构化规划强制约束 —— 解决盲目执行、过程不透明、无法追溯

每次任务前必须输出五项前置方案：

> **任务目标 / 所需信息 / 执行步骤 / 待调用工具 / 待确认问题**

### 3. 以 5W1H 强制分层知识

| 维度 | 内容 | 落盘位置 |
|------|------|----------|
| **When / Why / How** | 流程方法 | `skills/` |
| **What / Where** | 环境事实 | `MEMORY.md` |
| **Who** | 用户身份 | `USER.md` |

### 4. 落地配置

把设备、语言、时区、偏好、风格、输出路径等录入 USER.md；将第 1–3 条规范固化为 **workflow-rules 技能**；并在 MEMORY.md 中设置最高优先级条目，强制每轮对话自动加载该技能，保障约束机制持续生效。

### 5. 交付方式

拆成三组独立提示词，交由智能体自主完成全套初始化配置。

---

## 📦 仓库结构

```
hermes-workflow-rules/
├── README.md                          ← 你正在看
├── LICENSE                            ← MIT
└── prompts/
    ├── 01-skill-workflow-rules.md     ← 生成 SKILL（流程规则，完全通用）
    ├── 02-user-profile.md             ← 生成 USER.md（用户画像，需个性化）
    └── 03-memory-bootstrap.md         ← 生成 MEMORY.md（环境记忆，自动探测）
```

---

## 🚀 快速上手

### 第一步：克隆仓库

```bash
git clone https://gitee.com/shdowzh/hermes-workflow-rules.git
cd hermes-workflow-rules
```

### 第二步：依次喂给 Hermes Agent

打开三个 prompt 文件，**复制全文**贴到 Hermes Agent 对话窗口：

1. **`prompts/01-skill-workflow-rules.md`** → 生成 `workflow-rules` 技能
2. **`prompts/02-user-profile.md`** → 生成 `USER.md`（**需要按提示修改占位项**）
3. **`prompts/03-memory-bootstrap.md`** → 生成 `MEMORY.md`

### 第三步：重启 Hermes Agent 会话

新会话开始时，规则会通过记忆 + 技能自动加载，约束生效。

---

## ⚠️ 跨平台与个性化说明（重要）

### ✅ 完全通用（任何人、任何平台）

- **`prompts/01-skill-workflow-rules.md`** —— Q1-Q2-Q3、五项计划、知识分层是普适方法论，**直接用**

### ⚠️ 模板示例，需按自己情况修改

- **`prompts/02-user-profile.md`** 内的：
  - 沟通语言（默认中文 → 你可改为英文/其他）
  - 时区（默认本地时区，按需指定）
  - 工具偏好（默认本地免费优先 → 你可改为其它）
  - 文件输出路径（默认 `~/Desktop/Files/HermesAgent/`）

- **`prompts/03-memory-bootstrap.md`** 内的：
  - 第一条"用户要求"是仓库作者的强制规则，**别人可按需保留或弱化**

### 🌐 平台支持

| 平台 | 路径探测 | 系统信息 | 工具探测 | `date` 命令 |
|------|----------|----------|----------|-------------|
| macOS | ✅ | ✅ | ✅ | ✅ |
| Linux | ✅ | ✅ | ✅ | ✅ |
| Windows | ✅（APPDATA）| ✅ | ✅ | ⚠️ 用 PowerShell `Get-Date` |

提示词内已自动覆盖三平台路径候选，**包括 Hermes Desktop App、CLI 默认 profile、CLI 自定义 profile**。

---

## 📐 知识分层一览

```
                    ┌──────────────────┐
        Who ───────►│   USER.md        │  是谁
                    └──────────────────┘
                    ┌──────────────────┐
       Where ──────►│   MEMORY.md      │  在哪 / 有啥
        What ──────►│                  │  受什么约束
                    └──────────────────┘
                    ┌──────────────────┐
        When ──────►│                  │  何时 → date 实测
         Why ──────►│   SKILL.md       │  为何 → Q1-Q2-Q3
         How ──────►│                  │  怎做 → 五项计划
                    └──────────────────┘
```

**变化频率分层**：用户画像（几乎不变）→ 记忆（换机器更新）→ 技能（按需加载、可迭代版本）。

---

## 🔧 常见问题

**Q：必须三个都用吗？**
A：不必须。最小集是 `prompts/01`（SKILL），单独使用即可获得"前置检查 + 结构化规划"。02 和 03 是把规则与画像绑定到当前账号，让约束在新会话自动生效。

**Q：USER.md 和 MEMORY.md 字符数有限制吗？**
A：是。Hermes 每轮把它们注入上下文，必须紧凑。USER.md ≤ 1375、MEMORY.md ≤ 2200（提示词内已校验）。

**Q：和 Hermes 内置的 `plan`、`workflow-rules` 技能冲突吗？**
A：本方案用相同名字 `workflow-rules` 覆盖写入，是预期行为。如需保留官方版，请在第二步前重命名本 SKILL 的 `name` 字段。

**Q：Windows 下 `date` 命令不一样怎么办？**
A：SKILL 已写"date 或等效命令"。PowerShell 用户用 `Get-Date`，CMD 用户可用 `echo %date% %time%`。

---

## 📜 License

[MIT](./LICENSE)

---

## 💡 设计哲学

> **变化快的东西放热区，变化慢的东西放冷区。**
>
> 流程方法（变化最慢）→ 技能；环境事实（换机器变）→ 记忆；用户身份（几乎不变）→ 画像。
>
> 这不是又一个 prompt 工程技巧，而是把 5W1H **按生命周期解耦**后落进 Agent 的三层架构。