Update nexus: fix conflicts and sync local changes

This commit is contained in:
Shen Wei
2026-04-26 12:06:50 +08:00
parent 191797c01b
commit f09834b5a5
2443 changed files with 254323 additions and 255154 deletions

View File

@@ -1,59 +1,59 @@
---
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 TruthSTATE.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获得完整历史
---
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 TruthSTATE.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获得完整历史