Cortex 多代理协调协议
用纯 Markdown 文件让一个「幕僚长」代理调度一群工作代理。
- Star 数
- ★ 13
- 最近更新
- 7 个月前
- License
- MIT
- FA 评分
- 49/100 · 缺口较多
30 秒速览
- 可在哪里用
- 通用 · 跨平台Claude CodeCodex · OpenAI API · Claude API(部分支持)
- 开始前需要
- 典型场景
- 你同时维护接单服务与仪表盘两个项目,想让一个幕僚长代理分别向 billing-dev、dashboard-dev 派活并在 Telegram 上收日报。
- 主要局限
- 开箱即用的插件路径绑定 Claude Code,非 Claude Code 用户需要自行按 docs/protocol.md 与 docs/adapters/ 写适配代码。
- 官网
- agentweave.github.io/cortex ↗ 来自 GitHub 仓库设置
- 维护状态
- 超过半年没有提交最近提交 2026-04-07
- 源码审查
- 49/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Cortex 是一套开源协议,通过共享目录里的纯 Markdown 文件(带 YAML frontmatter)来协调多个 AI 代理。它自带一个 Claude Code 插件,包含 /setup、/register、/join、/leave 四个技能,但协议本身不依赖特定模型运行时,Codex、Cursor、Gemini CLI、OpenCode 等只要能读写文件都能接入。执行模型是「一个幕僚长 + 若干工作代理」:幕僚长接收你的指令,把任务写入 agents/<slug>/tasks.md,工作代理按心跳轮询任务文件,自行认领并汇报状态。代理之间不做直接通信,所有协调都经由团队目录完成,因此代理无需同时在线。
首次运行 /setup 会创建团队目录结构、写入 ~/.cortex/config.yaml 并注册幕僚长代理;/register <name> 在 <team_dir>/agents/<slug>/ 下生成代理笔记与空的 tasks.md;/join <name> 读取代理笔记,在当前项目生成 .cortex.md 完整协议文件,并更新 CLAUDE.local.md 使代理在会话启动时自动同步,同时启动心跳(默认每 15 分钟轮询)。任务文件遵循 ready → in-progress → done 状态机,附 Started/Completed 时间戳与 ### Summary 段落,格式沿用 Shuttle Protocol。幕僚长按 daily_briefing 与 daily_review 时间点发送简报,并通过 <!-- cortex:last-tick --> 存活时间戳识别疑似掉线但仍持有任务的代理;每日审查会清理 7 天前的 done 任务、把 Session Log 裁剪为每代理最新一条,历史内容由 git 保留。
- 你同时维护接单服务与仪表盘两个项目,想让一个幕僚长代理分别向 billing-dev、dashboard-dev 派活并在 Telegram 上收日报。
- 团队已有 Obsidian 笔记库,希望直接把 vault 当团队目录,用 Markdown 文件承载代理笔记与任务。
- 幕僚长用 Claude Code、工作代理用 Codex 或 Gemini CLI 的混合团队,通过 docs/adapters/ 的适配器让异构运行时协同。
- 工作代理无法与幕僚长同时在线,只能在夜间空闲时段执行任务,依赖文件队列异步取活。
- 想在任务文件中保留可审计的 assigned/started/completed 时间线,并借 git 提交历史追溯被清理的旧任务。
- 只想用终端或远程控制、不接 Telegram 的用户,用 /join 与心跳轮询完成无人值守的日常调度。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 配置文件
.claude-plugin/marketplace.json~/.cortex/config.yaml
如何安装或部署这个 Agent?
本地克隆安装:
claude plugins marketplace add /path/to/cortex --scope user
claude plugins install cortex@agentweave从 GitHub 安装:
claude plugins marketplace add https://github.com/agentweave/cortex --scope user
claude plugins install cortex@agentweave市场名 agentweave 来自仓库中的 .claude-plugin/marketplace.json,该文件是插件被发现和安装的必要条件。安装完成后在 Claude Code 中运行 /setup,按提示填写团队目录路径(默认 ~/cortex-team)、Telegram chat ID(可选)、心跳间隔与每日日程时间。
如何使用这个 Agent?
在项目目录内加入成为某个代理:
/join Chief of Staff这会生成 .cortex.md 协议文件、更新 CLAUDE.local.md,并自动启动心跳(每 15 分钟轮询一次),每次会话重新运行 /join 时心跳会重启。注册并入职一个工作代理:
/register Billing Dev然后在工作代理的项目目录执行:
/join Billing Dev退出时用 /leave Billing Dev 删除 .cortex.md、清理 CLAUDE.local.md 并把该代理状态设为 inactive。配置文件 ~/.cortex/config.yaml 形如:
team_dir: ~/cortex-team
heartbeat_minutes: 15
daily_briefing: "09:00"
daily_review: "18:00"
telegram_chat_id: "your-chat-id"
chief_of_staff_project: "~/Projects/chief-of-staff"这个 Agent 有哪些优点和局限?
- 协调层是纯 Markdown 文件,任何能读写文件的运行时都能参与,Claude Code、Codex、Cursor、Gemini CLI、OpenCode 有官方适配器示例,可混编团队。
- 代理之间不直接通信,工作代理可以数小时后才取任务,不要求所有代理同时在线。
- 任务文件有明确的 ready → in-progress → done 状态机与 Started/Completed 时间戳,配合 git 提交历史可审计、可回溯被裁剪的旧数据。
- 用 <!-- cortex:last-tick --> 存活时间戳识别「有在办任务但已掉线」的代理,并提供每日审查自动清理 7 天前的 done 任务。
- MIT 许可,团队目录可用 Obsidian vault、git 仓库或任意目录,目录结构(agents/、projects/、templates/)清晰。
- 开箱即用的插件路径绑定 Claude Code,非 Claude Code 用户需要自行按 docs/protocol.md 与 docs/adapters/ 写适配代码。
- 采用「自己发提示词、自己收回复」的方式,缺少独立的守护进程;心跳依赖会话启动时运行 /join 才生效,会话不开就不轮询。
- Telegram 仅当作通知通道,且必须另装官方 Claude Code Telegram 插件,Cortex 自己只读取 telegram_chat_id。
- 多代理同时写同一任务文件存在并发覆盖风险,文档未描述锁或冲突解决机制。
- 配置文件 ~/.cortex/config.yaml 为全局单份,跨团队切换需要改动全局配置。
- 插件安装依赖 .claude-plugin/marketplace.json,仓库中其他运行时的适配器属于示例而非可安装产物。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Cortex 多代理协调协议 当前 | 49 · 缺口较多 | — | ★ 13 | 7 个月前 | — | Claude Code |
| RepoBrain 代码库智能问答引擎 | 54 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 1.4k | 9 天前 | Python | Codex · Claude Code |
| Ordewell | 87 · 表现良好 | 命令行工具免费 + 模型费 | ★ 211 | 1 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| Brigade | 71 · 存在缺口 | 命令行工具免费 | ★ 83 | 今天 | Python | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
文档说明协调经共享团队目录中的 Markdown 文件完成,并解释 Telegram 只由独立插件处理,能看出主要数据流;/setup 会询问目录和 Telegram chat ID,/join 检测近期心跳并询问是否启动,提供部分确认。扣分原因:worker 心跳提示会继续任务、修改 task 文件,/leave 会删除本地文件和 hook,/setup 也会写入配置与目录,但没有细致权限边界或逐项确认;配置保存 Telegram chat ID,未见敏感信息保护说明;依赖安全证据有限;外部影响及恢复说明较薄;作者字段可见,但发布者身份未验证且没有明确维护或安全更新渠道。
README、技能和配置文件把产品描述为无运行时的 Markdown 协议及 Claude Code 插件,并列出安装和工作流程;但 /join 说明会自动启动 heartbeat,而 CLAUDE.md 将技能称为提示词、没有运行时代码,二者关系及 cron 能力依赖没有充分解释。插件和协议 spec、适配器被列出,但样本未包含其内容,无法确认各运行时依赖可用性。遇到未配置或未注册状态时,/join、/register、/setup 给出明确停止提示;其他操作失败处理未展示。
README 面向协调多个项目 Agent 的用户,提供 chief of staff、worker、Telegram、终端和远程控制场景,并称可由其他运行时通过协议接入;技能明确区分协调者和 worker,也规定参数及缺失配置时的行为。扣分原因:跨运行时适配仅有链接和概述,实际适配细节不在样本中;心跳与 Claude Code cron/hook 的具体环境要求较强,环境设置说明不完整。
目录结构、技能职责和团队文件格式有清楚说明,README 给出安装、配置、slug 示例及任务状态示例,MIT LICENSE 与元数据一致。扣分原因:已知限制只有少量说明(例如依赖共享目录及 Telegram 插件),未提供版本变更记录;CLAUDE.md 是仓库编辑约定而非产品用户指南;作者字段虽出现,但维护责任和更新渠道不明确。
产品把任务、状态和会话记录放在可读写的共享 Markdown 文件中,提供注册、加入、离开及周期心跳流程,足以支撑基本协调;任务模板和状态示例便于使用。扣分原因:定期轮询、手动同步和目录维护都增加持续管理成本,文档没有量化这些成本或说明适用团队规模。
安装步骤、文件路径、字段和任务状态示例让多项功能主张可追溯到具体操作;README、技能和元数据在产品名称与版本上部分相互印证。扣分原因:关键协议和适配器文件未包含在样本,多个能力仅由 README 或技能单方面陈述;文档通常能区分操作步骤与说明性主张,但没有系统标示未经验证的能力。
- worker 心跳指令允许 Agent 自动继续并修改任务文件;使用前应审阅任务内容和目标项目权限。
- README 称 /leave 会移除 .cortex.md、清理本地配置并把团队状态设为 inactive;团队目录的旧数据清理也会删除超过 7 天的已完成任务,应确认目录版本控制与恢复方式。
- 配置会保存 Telegram chat ID,且 Telegram 集成依赖单独插件;请确认配置文件访问范围以及外部消息路由。
常见问题
Cortex 需要付费订阅吗?
不用 Claude Code 能用吗?
必须接 Telegram 吗?
任务文件和会话日志会被删掉吗?
如果工作代理中途掉线会怎样?
Cortex 多代理协调协议 官网是什么?
Cortex 多代理协调协议 开源吗?
Cortex 多代理协调协议 安全吗?
Cortex 多代理协调协议 还在维护吗?
Cortex 多代理协调协议 是谁开发的?
谢谢反馈,我们会据此改进页面。