Crewden code reading

Multi-Agent 小队编排的秘诀

不是造一个“超级总控 Agent”,而是把 Agent 放进一个可追踪、可交接、可审查的轻量公司操作系统。

7

个组织机制

Goal、Task、Inbox、Delegate、Handoff、Review、Knowledge。

01 / 14
核心判断

秘诀不在“多几个 Agent”,而在“让工作流动起来”

常见 demo

Manager → Workers

一个 Manager 拆任务,几个 Worker 执行,最后汇总。容易变成一次性表演。

Crewden

共享工作系统

目标、任务、私信、委派、审查、知识都落到系统对象里。

结果

低幻觉协作

Agent 不靠猜上下文,而靠 inbox、task context、evidence 和 review 闭环。

02 / 14
Mental model

把 Agent 当“员工”,不是“函数调用”

岗位 / 能力
收件箱
任务板
交接
审查
知识沉淀

真正的编排,是把“谁负责什么、做到哪一步、有什么证据、下一步交给谁”变成系统状态。

03 / 14
Architecture

一张图看懂:Hub + Daemon + Agent Runtime

Hub / Server

保存 Agent、Channel、Task、Goal、DM、Delegation、Review、Knowledge;负责投递、唤醒、事件广播。

server/src/delegation.ts
server/src/taskDelivery.ts
server/src/routes/internalAgent.ts

Daemon / Runtime

在机器上启动 Claude/Codex/Gemini;给每个 Agent 独立 workspace、transcript、session、inbox queue。

daemon/src/agentProcessManager.ts
daemon/src/drivers/claude.ts

04 / 14
Shared state

共享对象替代聊天历史

Goal

目标、背景、成功标准、约束、风险。

Task

负责人、状态、验收标准、依赖、产物。

Delegation / DM

谁委派给谁、内容、状态、投递结果。

Review

证据、清单、审批或要求修改。

Knowledge

长期决策、runbook、经验、项目归档。

Inbox

Agent 每次醒来先看该处理什么。

05 / 14
Wake prompt

Agent 被唤醒时,拿到的是“工作上下文”

不是只把用户消息塞给模型,而是附上队列数量、channel/thread、当前消息、任务 inbox summary。

You have 3 queued messages.
Use `crewden inbox` or `crewden message read ...`

[target=#Task abc time=...]
@task-board: Task assigned or updated...

Current task inbox summary:
- assigned tasks
- claimable tasks
- next commands
06 / 14
Tooling

协作动作被结构化成工具,而不是靠自然语言“商量”

MCP

send_message / send_dm / delegate_agent / list_tasks
优先使用,结果机器可读。

CLI

crewden task handoff / review request / knowledge search
Agent 可直接执行组织动作。

Marker fallback

[[CREWDEN_DELEGATE_AGENT]]
工具失效时 stdout 仍能触发事件。

07 / 14
Delegation

委派不是转发一句话,而是一条可追踪链路

`delegateAgent()` 会解析目标、落库、写 audit、创建 DM、投递或唤醒目标 Agent。

findAgentByNameOrId
createAgentDelegation
createDirectMessage
deliver 或 agent:start
queued / delivered / started / failed
08 / 14
Task board

任务板才是真正的项目经理

Assigned tasks

明确交给某个 Agent 的任务,会直接通知或自动启动。

notifyTaskAssignee(task)

Claimable tasks

未分配任务会按 Agent role / capability / responsibilities 进行粗匹配,让合适 Agent 主动认领。

matchesAgentCapability(agent, task)

这让“没人管的活”也能流动起来。

09 / 14
Handoff

真正减少损耗的是交接,不是委派

多 Agent 最大成本是上下文丢失。Crewden 要求 handoff 带 notes、goal、next-step,把“做到哪”和“下一步”写入 TaskContext。

crewden task handoff task-1 \
  --to reviewer-agent \
  --notes "analysis done; risk in API auth" \
  --next-step "verify test deployment"

TaskContext:
- previousAgentId
- handoffNotes
- progressEvents
10 / 14
Review gate

防止 Agent 自嗨完成:Done 前先 Review

todo

任务进入系统

in_progress

Agent 执行

in_review

提交 evidence + checklist

changes

Reviewer 要求修改

done

通过验收

11 / 14
Knowledge

小队不是每次从零开始:经验要沉淀进 Knowledge

Decision

为什么选这个方案,未来不要重复争论。

Runbook

下次怎么操作,命令是什么,坑在哪里。

Learning

失败教训、调试路径、验证方式。

这和 Skill 的思想类似:把一次成功经验,变成下一次可加载的组织能力。

12 / 14
7 secrets

小队编排的 7 个秘诀

01

共享对象,不靠聊天历史。

02

Agent 有 inbox、workspace、session。

03

编排靠工作流,不靠总控人格。

04

协作动作必须结构化。

05

Handoff 必须带上下文。

06

Done 前必须有 evidence + review。

13 / 14
Final thesis

真正的智能不只在模型里,而在组织操作系统里。

Crewden 的 multi-agent 编排,是把“公司如何协作”的隐性规则,编码成 Agent 可以执行的工具、对象和状态机。

下一步优化方向

能力路由:从字符串匹配升级到 embedding / workload-aware routing。

调度策略:全局优先级、依赖 DAG、风险等级。

审查质量:强制 evidence 类型和自动验证。

14 / 14