Cortex 多代理协调协议

用纯 Markdown 文件让一个「幕僚长」代理调度一群工作代理。

Star 数
★ 13
最近更新
7 个月前
License
MIT

30 秒速览

可在哪里用
通用 · 跨平台Claude CodeCodex · OpenAI API · Claude API(部分支持)
开始前需要
Claude Code CLIGitShell / 命令行网络访问本地文件系统
典型场景
你同时维护接单服务与仪表盘两个项目,想让一个幕僚长代理分别向 billing-dev、dashboard-dev 派活并在 Telegram 上收日报。
主要局限
开箱即用的插件路径绑定 Claude Code,非 Claude Code 用户需要自行按 docs/protocol.md 与 docs/adapters/ 写适配代码。
官网
agentweave.github.io/cortex ↗ 来自 GitHub 仓库设置
维护状态
超过半年没有提交最近提交 2026-04-07

这个 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 保留。

  1. 你同时维护接单服务与仪表盘两个项目,想让一个幕僚长代理分别向 billing-dev、dashboard-dev 派活并在 Telegram 上收日报。
  2. 团队已有 Obsidian 笔记库,希望直接把 vault 当团队目录,用 Markdown 文件承载代理笔记与任务。
  3. 幕僚长用 Claude Code、工作代理用 Codex 或 Gemini CLI 的混合团队,通过 docs/adapters/ 的适配器让异构运行时协同。
  4. 工作代理无法与幕僚长同时在线,只能在夜间空闲时段执行任务,依赖文件队列异步取活。
  5. 想在任务文件中保留可审计的 assigned/started/completed 时间线,并借 git 提交历史追溯被清理的旧任务。
  6. 只想用终端或远程控制、不接 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
49/ 100 五分制 2.5 / 5
信任安全 12/29
可靠稳定 6/14
适用触发 10/18
规范维护 10/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全12 / 29 · 2.1/5

文档说明协调经共享团队目录中的 Markdown 文件完成,并解释 Telegram 只由独立插件处理,能看出主要数据流;/setup 会询问目录和 Telegram chat ID,/join 检测近期心跳并询问是否启动,提供部分确认。扣分原因:worker 心跳提示会继续任务、修改 task 文件,/leave 会删除本地文件和 hook,/setup 也会写入配置与目录,但没有细致权限边界或逐项确认;配置保存 Telegram chat ID,未见敏感信息保护说明;依赖安全证据有限;外部影响及恢复说明较薄;作者字段可见,但发布者身份未验证且没有明确维护或安全更新渠道。

可靠稳定6 / 14 · 2.1/5

README、技能和配置文件把产品描述为无运行时的 Markdown 协议及 Claude Code 插件,并列出安装和工作流程;但 /join 说明会自动启动 heartbeat,而 CLAUDE.md 将技能称为提示词、没有运行时代码,二者关系及 cron 能力依赖没有充分解释。插件和协议 spec、适配器被列出,但样本未包含其内容,无法确认各运行时依赖可用性。遇到未配置或未注册状态时,/join、/register、/setup 给出明确停止提示;其他操作失败处理未展示。

适用触发10 / 18 · 2.8/5

README 面向协调多个项目 Agent 的用户,提供 chief of staff、worker、Telegram、终端和远程控制场景,并称可由其他运行时通过协议接入;技能明确区分协调者和 worker,也规定参数及缺失配置时的行为。扣分原因:跨运行时适配仅有链接和概述,实际适配细节不在样本中;心跳与 Claude Code cron/hook 的具体环境要求较强,环境设置说明不完整。

规范维护10 / 18 · 2.8/5

目录结构、技能职责和团队文件格式有清楚说明,README 给出安装、配置、slug 示例及任务状态示例,MIT LICENSE 与元数据一致。扣分原因:已知限制只有少量说明(例如依赖共享目录及 Telegram 插件),未提供版本变更记录;CLAUDE.md 是仓库编辑约定而非产品用户指南;作者字段虽出现,但维护责任和更新渠道不明确。

有效结果7 / 13 · 2.7/5

产品把任务、状态和会话记录放在可读写的共享 Markdown 文件中,提供注册、加入、离开及周期心跳流程,足以支撑基本协调;任务模板和状态示例便于使用。扣分原因:定期轮询、手动同步和目录维护都增加持续管理成本,文档没有量化这些成本或说明适用团队规模。

证据核验4 / 8 · 2.5/5

安装步骤、文件路径、字段和任务状态示例让多项功能主张可追溯到具体操作;README、技能和元数据在产品名称与版本上部分相互印证。扣分原因:关键协议和适配器文件未包含在样本,多个能力仅由 README 或技能单方面陈述;文档通常能区分操作步骤与说明性主张,但没有系统标示未经验证的能力。

风险与缓解建议
  • worker 心跳指令允许 Agent 自动继续并修改任务文件;使用前应审阅任务内容和目标项目权限。
  • README 称 /leave 会移除 .cortex.md、清理本地配置并把团队状态设为 inactive;团队目录的旧数据清理也会删除超过 7 天的已完成任务,应确认目录版本控制与恢复方式。
  • 配置会保存 Telegram chat ID,且 Telegram 集成依赖单独插件;请确认配置文件访问范围以及外部消息路由。
证据充分度:低 评估于 2026年11月8日 审查版本 6ba5646e1bf2
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/cortex.svg?lang=zh)](https://followagents.com/zh/agents/cortex)
<a href="https://followagents.com/zh/agents/cortex"><img src="https://followagents.com/badge/cortex.svg?lang=zh" alt="FARS 评测"></a>

常见问题

Cortex 需要付费订阅吗?
Cortex 本身是 MIT 许可的开源项目,不收费;但代理能力由你使用的模型提供,需要自备 Claude Code 或其他运行时的额度与密钥。
不用 Claude Code 能用吗?
可以。协议是运行时无关的,docs/protocol.md 定义了团队目录格式、代理笔记、任务文件与协调规则,docs/adapters/ 提供了 Codex、Cursor、Gemini CLI、OpenCode 与通用适配器示例,但非 Claude Code 路径需要你自己实现轮询与任务状态更新。
必须接 Telegram 吗?
不必须。telegram_chat_id 是可选项,Telegram 由独立的 Claude Code Telegram 插件处理,Cortex 只负责把消息发到该 ID;不接时用终端或远程控制与幕僚长交互。
任务文件和会话日志会被删掉吗?
每日审查会删除超过 7 天的 done 任务、把 Session Log 裁剪为每代理最新一条;因此团队目录应设为 git 仓库,被清理的内容仍可从 git log 找回。
如果工作代理中途掉线会怎样?
代理在任务文件里更新 <!-- cortex:last-tick --> 时间戳,幕僚长据此发现仍持有进行中任务但心跳过期的代理,判定其可能已下线。
Cortex 多代理协调协议 官网是什么?
Cortex 多代理协调协议 的 GitHub 仓库填写的官网是 https://agentweave.github.io/cortex/。这个链接由仓库作者设置;源码在 GitHub(agentweave/cortex)。
Cortex 多代理协调协议 开源吗?
开源。源码在 GitHub(agentweave/cortex),许可证是 MIT。
Cortex 多代理协调协议 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 Cortex 多代理协调协议 的“信任与安全”打了 12/29 分。评审检查的 8 项安全措施没有完全缺失的。
Cortex 多代理协调协议 还在维护吗?
GitHub 仓库自 2026-04-07 以来没有新提交,已超过半年。可能是项目已经完成,也可能已经停更,用之前建议先看看 issue 区。
Cortex 多代理协调协议 是谁开发的?
Cortex 多代理协调协议 由 GitHub 账号 agentweave 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念