---
title: "STATE.yaml"
type: concept
tags: [coordination, multi-agent, state-management]
last_updated: 2026-04-15
---

## Summary
去中心化项目协调文件格式，YAML 结构定义任务 ID、状态（in_progress/done/blocked）、owner、开始时间、备注、blocked_by 依赖关系。所有 agent 读写同一文件实现协调。

## Format Structure
```yaml
project: project-name
updated: ISO-timestamp

tasks:
  - id: task-id
    status: in_progress | done | blocked
    owner: agent-label
    started: ISO-timestamp
    completed: ISO-timestamp
    blocked_by: other-task-id
    notes: "描述"

next_actions:
  - "agent-label: 具体下一步行动"
```

## Key Properties
- 单一事实来源（Single Source of Truth）
- Git 版本控制可获取完整变更历史
- blocked_by 字段实现自动依赖触发

## Compared To
- [[Multi-Agent Hierarchy]]：层级架构 vs 平铺协调
- [[共享内存模式]]：内存读写 vs 文件持久化

## Key Connections
- [[Autonomous Project Management]] ← 核心协调机制
- [[GitOps]] ← 审计日志集成
- [[去中心化协调]] ← 协调模式