# Hermes Agent ACP Skill

> 仓库地址：https://github.com/Rainhoole/hermes-agent-acp-skill
> 作者/组织：Rainhoole
> 成熟度：beta
> 分析日期：2026-04-15

## 一句话总结
一个 Hermes Agent skill，实现 ACP 风格的 multi-agent delegation，支持向 Hermes subagents、Codex 和 Claude Code 分发任务，含上下文隔离和安全控制。

## 项目定位与架构
hermes-agent-acp-skill 解决的是复杂工作流中的任务分解和委派问题——工程团队需要不同的专用 sub-agent 处理不同职责（coding、testing、risk assessment、synthesis）。

架构简洁：skill 接受任务数组（含 goal 定义和 agent 指定），通过 `agent=...` 语法路由到对应 handler。关键设计原则是 context isolation——委派的工作不污染父执行状态。

安全控制包括 external_timeout_seconds（默认 900）和 external_max_output_chars（默认 24000），防止外部 agent 调用失控。

## 关键技术特性
- **Agent Routing**：`agent=...` 语法指定目标 agent（Hermes subagents、Codex、Claude Code）
- **Context Isolation**：委派工作不污染父执行状态
- **Safety Guardrails**：timeout（900s）和 output limit（24000 chars）
- **结构化任务分发**：`delegate_task()` 接受 goal + agent 的任务数组
- **Multi-framework 支持**：同时支持 Hermes、Codex 和 Claude Code

## 设计亮点与创新
Context isolation 是 multi-agent delegation 的关键挑战——如果子任务的上下文泄漏到父 agent，会导致 context window 膨胀和推理干扰。通过严格隔离解决这个问题是正确的设计选择。timeout + output limit 的安全控制简单但实用。

## 局限性与风险
文档极其精简，缺少安装步骤、详细 API 文档和使用示例。timeout 和 output 限制对长时间或大输出任务可能过于保守。不清楚如何处理子 agent 失败的情况。缺少 error handling 和 retry 机制的文档。

## 与生态系统的关联
与 zouroboros-swarm-executors（CLI tool 包装为 persona）和 opencode-hermes-multiagent（17 个专用 agent）在 multi-agent orchestration 维度上互补。ACP skill 更侧重于单个 Hermes Agent 向外委派任务，而非全局编排。可与 Mission Control（agent 舰队管理）配合使用。