# Zouroboros Swarm Executors

> 仓库地址：https://github.com/marlandoj/zouroboros-swarm-executors
> 作者/组织：marlandoj
> 成熟度：experimental
> 分析日期：2026-04-15

## 一句话总结
一个已弃用的 CLI tool executor 管理器，将 Claude Code、Hermes、Gemini、Codex 等命令行工具转化为 Zo Computer swarm 中的 AI persona，通过 bash bridge 脚本实现统一调度。

## 项目定位与架构
Zouroboros Swarm Executors 是 Zo Computer 生态的组件，负责将本地 CLI 工具包装为可被 swarm orchestrator 调度的"AI persona"。核心抽象是 bridge protocol："accept a prompt as input, return text via stdout"。

四个内置 executor：Claude Code（25-120s，复杂代码变更）、Hermes（15-60s，web research/安全审计）、Gemini（2-12s，1M+ token 大上下文分析）、Codex（3s，快速代码生成）。通过 `executor-registry.json` 注册发现，orchestrator 根据 persona matching 路由任务。

**注意：该仓库已 archived，开发迁移至 Zouroboros monorepo。**

## 关键技术特性
- **Bridge Protocol**：bash 脚本接受 prompt ($1)，返回 stdout 文本，支持超时控制
- **共享身份系统**：SOUL.md/IDENTITY 文件对所有 executor 可见
- **统一 memory 集成**：与 swarm memory system 共享状态
- **OmniRoute 模型路由**：统一 AI proxy 系统
- **自定义 executor**：模板 bridge script + registry 注册两步即可扩展
- **Fallback chain**：orchestrator resolved model → executor env var → CLI default

## 设计亮点与创新
将异构 CLI 工具统一为"persona"的抽象层设计优雅——无论底层是 Claude、Hermes 还是 Gemini，对 orchestrator 都是接受 prompt、返回文本的统一接口。每个 persona 可声明 expertise domains，实现语义级任务路由。

## 局限性与风险
**已弃用（archived）**，不再接受更新。同步 bridge 接口无 streaming 支持。仅限本地执行（需 CLI 工具已安装）。超时强制终止可能导致不完整输出。Gemini 跳过 OmniRoute 的特殊处理增加了系统复杂度。

## 与生态系统的关联
展示了 Hermes Agent 作为 multi-agent swarm 中一个 executor 的使用模式——Hermes 不是唯一的 agent，而是与 Claude Code、Gemini、Codex 并列的专用工具。这种"异构 agent 编排"的思路与 opencode-hermes-multiagent（17 个专用 agent）和 hermes-agent-acp-skill（multi-agent delegation）异曲同工。