Multi-Agent Memory & Collaboration Architecture

概述

本 skill 定义了一套完整的多 agent 共享记忆与项目协作架构，解决以下核心问题：

1. 项目状态隔离 vs 知识共享：项目状态（todos/status）按项目隔离，知识库（decisions/patterns）跨项目共享
2. 跨时空知识链接：支持跨项目、跨时间搜索关键词，形成"智慧涌现"和"结构洞创新"
3. 版本控制：每个文件保留最近 3 个版本，支持回滚
4. 里程碑跟踪：SMART 原则的里程碑管理，RACI 责任模型
5. 周报与交接：结构化的周报和一页纸交接文档

何时使用

必须使用的场景：

• 多个 agent 协作开发多个项目
• 需要跨项目共享知识和经验
• 需要清晰的项目状态跟踪
• 需要定期汇报和交接

触发词：

• "初始化项目"
• "创建周报"
• "写交接文档"
• "更新里程碑"
• "搜索知识库"
• "项目协作"

目录结构

/root/.openclaw/
├── workspace-commander/     # 个人工作区（私有）
├── workspace-maker/
├── workspace-vibe/
├── workspace-killjoy/
├── workspace-main/
│
├── projects/                # 项目状态（隔离）
│   ├── <project-name>/
│   │   ├── status/          # 当前状态（每日更新）
│   │   │   ├── maker.md
│   │   │   ├── vibe.md
│   │   │   ├── commander.md
│   │   │   └── killjoy.md
│   │   │
│   │   ├── todos.md         # 待办事项（实时更新）
│   │   ├── context.md       # 项目背景/目标（初始化后很少改）
│   │   │
│   │   ├── weekly/          # 每周总结（每周一篇）
│   │   │   ├── 2026-W10.md
│   │   │   └── 2026-W11.md
│   │   │
│   │   ├── handoffs/        # 交接文档（重大节点更新）
│   │   │   ├── 2026-03-09-Phase1-交接.md
│   │   │   └── latest.md    # 符号链接，指向最新版本
│   │   │
│   │   ├── docs/            # 设计文档（按需创建）
│   │   │   ├── requirements/
│   │   │   │   └── YYYY-MM-DD-HH-mm-需求-{描述}.md
│   │   │   └── specs/
│   │   │       └── YYYY-MM-DD-HH-mm-设计-{描述}.md
│   │   │
│   │   ├── logs/            # 开发日志（每次完成任务后）
│   │   │   └── YYYY-MM-DD-HH-mm-开发日志-{任务名}.md
│   │   │
│   │   └── milestones/      # 里程碑跟踪（每周更新）
│   │       └── milestones.md
│   │
│   └── <another-project>/
│
├── knowledge/               # 共享知识库（跨项目）
│   ├── decisions/
│   │   └── decisions.md     # 关键决策（跨项目）
│   ├── patterns/
│   │   └── patterns.md      # 技术模式/经验（跨项目）
│   ├── glossary/
│   │   └── glossary.md      # 术语表/概念定义
│   └── index/
│       └── keywords.txt     # 关键词索引
│
└── archive/                 # 归档（完整历史）
    ├── <project-name>/
    │   └── YYYY-Wxx/
    │       ├── status-snapshot.tar.gz
    │       ├── weekly-YYYY-Wxx.md
    │       └── summary.md
    └── <another-project>/

核心原则

1. 分层共享

• 项目状态（隔离）：projects/<project>/status/, todos.md, context.md
• 知识库（共享）：knowledge/decisions/, knowledge/patterns/, knowledge/glossary/
• 归档（只读）：archive/

2. 文档命名规范

所有文档必须遵循时间戳命名：

YYYY-MM-DD-HH-mm-{类型}-{描述}.md

获取时间戳：

date +'%Y-%m-%d-%H-%M'

示例：

• 2026-03-09-14-30-需求-内容工厂.md
• 2026-03-09-15-20-设计-文章生成流程.md
• 2026-03-09-16-10-开发日志-功能A.md

3. RACI 责任模型

每个任务/决策都应该有明确的责任人：

• Responsible（执行者）：谁来做这件事
• Accountable（负责人）：谁对结果负责
• Consulted（咨询者）：需要咨询谁
• Informed（知情者）：需要通知谁

4. 版本控制

每个文件保留最近 3 个版本：

file.md       # 当前版本
file.md.1     # 上一个版本
file.md.2     # 上上个版本

备份脚本：

if [ -f file.md ]; then
  cp file.md.1 file.md.2
  cp file.md file.md.1
fi
echo "新内容" > file.md

文档模板

所有模板文件位于：~/.openclaw/skills/multi-agent-memory/templates/