60 lines
2.0 KiB
Markdown
60 lines
2.0 KiB
Markdown
---
|
||
title: "Shared State Coordination"
|
||
type: concept
|
||
tags: [multi-agent, coordination, architecture]
|
||
sources: [autonomous-project-management]
|
||
last_updated: 2026-04-22
|
||
---
|
||
|
||
## 定义
|
||
多 Agent 通过读写共享状态文件（而非消息传递）实现协调的通信范式。在 [[autonomous-project-management]] 中具体实现为共享的 `STATE.yaml` 文件。
|
||
|
||
## 核心机制
|
||
- **单一真相来源**（Single Source of Truth）：STATE.yaml 作为项目协调的单一事实来源
|
||
- **文件读写协调**：各子 Agent 读取自己被分配的任务，写入进度/完成状态
|
||
- **轮询自驱动**：Agent 主动轮询 STATE.yaml，发现任务解锁后自动拾取
|
||
- **无需消息队列**：避免引入额外的消息传递中间件依赖
|
||
|
||
## STATE.yaml 结构示例
|
||
```yaml
|
||
project: website-redesign
|
||
updated: 2026-02-10T14:30:00Z
|
||
|
||
tasks:
|
||
- id: homepage-hero
|
||
status: in_progress
|
||
owner: pm-frontend
|
||
notes: "Working on responsive layout"
|
||
|
||
- id: api-auth
|
||
status: done
|
||
owner: pm-backend
|
||
output: "src/api/auth.ts"
|
||
|
||
- id: content-migration
|
||
status: blocked
|
||
owner: pm-content
|
||
blocked_by: api-auth
|
||
|
||
next_actions:
|
||
- "pm-content: Resume migration now that api-auth is done"
|
||
```
|
||
|
||
## 优势
|
||
- **去中心化**：无中心协调器，单点故障风险低
|
||
- **版本可控**：Git 作为审计日志，完整可追溯
|
||
- **简单可靠**：无需额外的消息队列或 RPC 中间件
|
||
- **持久化**：状态天然持久，支持断点恢复
|
||
|
||
## 与消息传递模式对比
|
||
| 维度 | 共享文件协调 | 消息传递协调 |
|
||
|------|-------------|-------------|
|
||
| 中间件依赖 | 仅文件系统 | 需要 MQ/Pub-Sub |
|
||
| 状态持久性 | 天然持久 | 需要额外存储 |
|
||
| 并发控制 | 文件锁 | 队列ACK |
|
||
| 调试难度 | 高（需读文件） | 中（需追踪消息流） |
|
||
| 适用场景 | 并行独立任务 | 有序依赖链 |
|
||
|
||
## 衍生概念
|
||
- [[Git-as-Audit-Log]]：将所有 STATE.yaml 变更提交至 Git，获得完整历史
|