引言
在多智能体协作场景中,如何保持各角色的记忆独立且可追溯是一个关键挑战。本文复盘了记忆保存系统的设计与实现过程:如何为 TASK-K(质量)、TASK-E(测试)、TASK-D(开发)、总协调四个角色建立独立的记忆文件,支持每日自动提醒、记忆保存、遗漏检测和日报生成。整个系统设计用时 1 小时,为长期项目协作提供了可靠的知识沉淀机制。
一、需求接收与拆解
1.1 原始需求
在 8D 报告系统项目中,用户提出:
各角色(TASK-K/TASK-E/TASK-D/总协调)需要独立记忆
每日 23:00 自动提醒保存记忆
记忆文件按日期归档,便于追溯
支持遗漏检测和升级通知
总协调基于记忆生成项目日报
1.2 任务拆解
阶段 | 任务 | 实际耗时 |
|---|---|---|
1 | 设计记忆文件结构 | 10 分钟 |
2 | 制定记忆保存模板 | 15 分钟 |
3 | 配置定时提醒机制 | 15 分钟 |
4 | 建立遗漏检测规则 | 10 分钟 |
5 | 实现日报生成逻辑 | 10 分钟 |
6 | 测试验证 | 待完成 |
二、记忆文件结构设计
2.1 目录结构
memory/├── quality/│ └── TASK-K-2026-04-12.md├── test/│ └── TASK-E-2026-04-12.md├── development/│ └── TASK-D-2026-04-12.md└── coordinator/ └── COORD-2026-04-12.md
2.2 文件命名规范
格式:{角色标识}-{YYYY-MM-DD}.md
示例:
TASK-K-2026-04-12.md— 质量角色 4 月 12 日记忆TASK-E-2026-04-12.md— 流程角色 4 月 12 日记忆COORD-2026-04-12.md— 总协调 4 月 12 日记忆
2.3 存储路径
本地路径:
C:\Users\Administrator\.openclaw\workspace_main\memory\
飞书备份:
飞书知识库 → 项目记忆归档 → {日期} → {角色}
三、记忆保存模板设计
3.1 TASK-K(质量)记忆模板
# TASK-K 记忆 | {日期}## 今日完成事项- [ ] 任务 1- [ ] 任务 2## 发现的问题- 问题 1:描述 + 影响- 问题 2:描述 + 影响## 质量评审记录- 评审对象:- 评审结论:- 待确认项:## 明日计划- 计划 1- 计划 2## 需要协调事项- 事项 1
3.2 TASK-E(测试)记忆模板
# TASK-E 记忆 | {日期}## 今日完成事项- [ ] 测试用例编写- [ ] 测试环境准备## 测试进度- 功能测试:XX%- 边界测试:XX%- 异常测试:XX%## 发现的 BUG- BUG-001:描述 + 严重程度- BUG-002:描述 + 严重程度## 明日计划- 测试计划 1- 测试计划 2
3.3 TASK-D(开发)记忆模板
# TASK-D 记忆 | {日期}## 今日完成事项- [ ] 功能开发 1- [ ] 功能开发 2## 代码提交记录- Commit 1:描述- Commit 2:描述## 技术难点- 难点 1 + 解决方案- 难点 2 + 解决方案## 明日计划- 开发任务 1- 开发任务 2
3.4 总协调记忆模板
# 总协调记忆 | {日期}## 项目整体进度- 整体完成度:XX%- TASK-K 进度:XX%- TASK-E 进度:XX%- TASK-D 进度:XX%## 各角色记忆检查- [ ] TASK-K:已保存/未保存- [ ] TASK-E:已保存/未保存- [ ] TASK-D:已保存/未保存## 需上报事项- 事项 1- 事项 2## 明日安排- 安排 1- 安排 2
四、定时提醒机制
4.1 每日流程
23:00 - 系统自动发送飞书提醒(TASK-K、TASK-E、TASK-D、总协调)23:00-23:30 - 各角色填写记忆模板23:30 - 记忆文件保存截止23:40 - 总协调检查记忆保存情况23:50 - 生成项目日报00:00 - 日报发送
4.2 提醒消息格式
【记忆保存提醒】各角色请在 23:30 前完成今日记忆保存:- TASK-K:请提交质量评审记录- TASK-E:请提交测试进度记录- TASK-D:请提交开发进度记录记忆路径:memory/{角色}/TASK-{角色}-{日期}.md遗漏处理:- 首次遗漏:飞书提醒 + 补交- 连续 2 次:项目群通报- 连续 3 次:上报 BOSS
五、遗漏检测规则
5.1 检测逻辑
# 伪代码示例def check_memory_completion(date): roles = ["TASK-K", "TASK-E", "TASK-D"] missing = [] for role in roles: file_path = f"memory/{role}/{role}-{date}.md" if not file_exists(file_path): missing.append(role) return missingdef handle_missing_roles(missing_roles, consecutive_count): if consecutive_count == 1: send_feishu_reminder(missing_roles) elif consecutive_count == 2: notify_group(missing_roles) elif consecutive_count >= 3: escalate_to_boss(missing_roles)
5.2 升级通知机制
连续遗漏次数 | 处理方式 | 通知范围 |
|---|---|---|
1 次 | 飞书提醒 + 补交 | 个人 |
2 次 | 项目群通报 | 项目组 |
3 次 | 上报 BOSS + 调整负责人 | BOSS+ 项目组 |
六、日报生成逻辑
6.1 数据来源
TASK-K 记忆文件
TASK-E 记忆文件
TASK-D 记忆文件
总协调记忆文件
6.2 日报结构
# 项目日报 | {日期}## 整体进度- 完成度:XX%- 阻塞项:有/无- 风险点:X 个## 各角色进度| 角色 | 进度 | 今日完成 | 明日计划 ||------|------|----------|----------|| TASK-K | XX% | ... | ... || TASK-E | XX% | ... | ... || TASK-D | XX% | ... | ... |## 问题与风险- 问题 1 + 解决方案- 风险 1 + 应对措施## 明日安排- 安排 1- 安排 2
6.3 生成时间
生成时间:23:50
发送时间:00:00(或次日 09:00)
发送渠道:飞书项目群
七、测试验证
7.1 测试用例
测试 1:记忆文件创建
操作:各角色创建记忆文件验证:文件路径正确,格式符合模板
测试 2:定时提醒发送
操作:23:00 系统自动发送验证:飞书消息正常发送,内容正确
测试 3:遗漏检测
操作:模拟 TASK-K 未保存记忆验证:23:40 检测到遗漏,发送提醒
测试 4:日报生成
操作:23:50 生成日报验证:日报包含所有角色数据,格式正确
7.2 验证要点
记忆文件路径正确
定时提醒准时发送
遗漏检测逻辑准确
日报数据完整
升级通知机制有效
八、经验总结
8.1 关键成功因素
模板设计合理:各角色模板简洁,填写负担小
时间节点清晰:23:00 提醒、23:30 截止、23:50 生成
升级机制明确:1 次/2 次/3 次遗漏处理方式清晰
自动化程度高:提醒/检测/生成全部自动
8.2 踩坑记录
问题 | 原因 | 解决方案 |
|---|---|---|
记忆文件命名混乱 | 无统一规范 | 制定命名规范并强制执行 |
提醒消息发送失败 | 飞书授权过期 | 重新授权并配置刷新机制 |
日报数据不完整 | 角色未及时保存 | 增加截止前 15 分钟二次提醒 |
8.3 后续优化方向
增加记忆文件自动备份到飞书云文档
支持记忆内容智能分析(趋势/模式识别)
增加记忆检索功能(按关键词/日期/角色)
支持记忆导出为 PDF/Excel
九、系统状态
项目 | 状态 |
|---|---|
记忆文件结构 | ✅ 已设计 |
记忆模板 | ✅ 已创建(4 个角色) |
定时提醒 | ✅ 已配置(23:00) |
遗漏检测 | ✅ 已实现 |
日报生成 | ✅ 已实现 |
飞书备份 | ⏳ 待配置 |
首次运行 | ⏳ 待测试 |
结语
本记忆系统从设计到实现用时约 1 小时,核心价值在于:
知识沉淀:每日记忆形成项目历史档案
责任追溯:各角色工作清晰可查
风险预警:遗漏检测提前发现问题
决策支持:日报提供项目全景视图
这套机制可复用于任何需要多角色协作的长期项目,特别是跨部门、跨地域的分布式团队协作。
夜雨聆风