# hermes-agent

**Repository Path**: ecuzu/hermes-agent

## Basic Information

- **Project Name**: hermes-agent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-02
- **Last Updated**: 2026-11-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# hermes-agent — Agent 军团科学管理框架

把「多智能体持续接管软件项目研发」做成一套可复制的工程框架：**任务卡驱动、路径守卫、TDD 门禁、教训沉淀、cron 自迭代**。
本仓库提炼自生产环境三项目（ROS 2 机器人 / Spring Boot 单体 / 电商微服务）的 600+ 用例门禁与 14+ 张已完成自治任务卡实践。

![输入图片说明](docs/%E6%88%AA%E5%9B%BE%202026-11-06%2014-22-17.png)
## 它解决什么问题

Agent 主导开发三大顽疾（来自 26MB 会话事件审计的量化结论）：
1. **协议类失败**（45.7%）→ 任务卡带 `allowed_paths`，越界即红，守卫机判；
2. **教训不沉淀**（同类 bug 反复发生）→ `memory/lessons.yaml` 只收「已被回归用例钉住」的教训，带 `expires_at` 强制复核；
3. **自我进化无节奏** → hermes cron 每工作日 tick 推进 ≤2 卡，周日 sleep-time 复盘批量收 lesson。
![输入图片说明](docs/%E6%88%AA%E5%9B%BE%202026-11-06%2014-22-52.png)
## 目录

```
agentops/            # 核心闭环（Python，无第三方依赖）
  loop/              #   backlog.yaml 任务卡 + plan.py 状态机校验
  evals/             #   守卫评测集（allow/deny/warn 案例，防 agent 权限退化）
  memory/            #   lessons.yaml + check.py（教训存活率巡检）
  guard/             #   allowed_paths 越界拦截
  checks/            #   配置漂移检测（hermes/openclaw MCP 面真值对账）
  inventory.py       #   本机 agent 清单机判（输出前自动 _assert_no_secrets）
hermes_board/        # agent CLI 会话与任务执行看板（只读观察子系统，纯标准库）
agentops_hub/        # workspace 级自迭代中枢 v2（卡片库/门禁/闭环运行器）
scripts/             # hermes 自迭代伴生工具（安装/评审/配置校验/evolve）
hermes_dispatch/     # profile ACL 模板（engineer/reviewer/readonly 三档）
docs/                # 科学管理方案 v2（DDD+TDD 军团总案）
```

## 快速开始

```bash
python3 scripts/secret_scan.py .          # 推送前脱敏门禁（命中即非零退出）
cp agentops/loop/backlog.example.yaml agentops/loop/backlog.yaml
python3 -m agentops.loop.plan --check     # 任务卡格式校验
python3 -m agentops.inventory             # INVENTORY_OK agents=N drift=0

# 会话执行看板（只读：解析各 agent CLI 历史会话 → 任务/失败/经验统计）
PYTHONPATH=. python3 -m hermes_board sources            # 六套 CLI 数据源盘点
PYTHONPATH=. python3 -m hermes_board ingest --cli codex # 采集入库（增量、脱敏）
PYTHONPATH=. python3 -m hermes_board serve              # 本地只读 Web 看板 127.0.0.1:8788
```

推送/发布前一条命令复算全部判据：`bash scripts/all_gate.sh` → `ALL_GATE_OK`
自治 tick 开工前逐战线台账预检：`python3 scripts/legion_preflight.py` → `PREFLIGHT_OK`（含 registry 对账与暂存压力读数）

## 任务卡法典（核心抽象）

| 字段 | 语义 |
|---|---|
| `objective` / `inputs` | 干什么 + 真实证据路径 |
| `acceptance` | **一条可机判命令**，无证据视为未完成 |
| `allowed_paths` | 写范围硬边界，越界即拒 |
| `risk_level` | `auto`（直接干）/ `confirm`（外层确认）/ `human`（只出报告） |
| `status` | backlog→planned→in_progress→review→done，blocked 任意态 |

TDD 节奏铁律：先提交 **失败用例（RED）** 再改实现；`-DskipTests`、`skip` 标记一律不算通过证据。
DDD 纪律：聚合根为唯一写入模型；跨限界上下文只走 OHS/ACL，禁止跨模块裸 import。

## 安全声明

- 本仓库只提交 `*.example` 配置模板，凭据零入库；CI/本地用 `scripts/secret_scan.py` 把关。
- guard/evals 是纵深防御不是沙箱：收窄 agent 能力面请用 profile ACL（见 hermes_dispatch/profiles/）。

## License

- 新增工程（含 `agentops_hub/`、`hermes_board/`）：Apache-2.0（见 `LICENSE`）
- 历史快照（`agentops/` v1 框架等，2026-11 之前的 master 提交）：MIT（见 `LICENSE-MIT`）