Files
nexus/wiki/concepts/STATE-yaml.md

42 lines
1.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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]] ← 审计日志集成
- [[去中心化协调]] ← 协调模式