跳转至

📝 自动化记录规范

核心原则: 不要每次都发现问题之后再去执行 —— 建立自动化机制确保每次都执行
创建日期: 2026-03-16
最后更新: 2026-03-16


🎯 为什么需要自动化记录?

问题

  • 每日记忆文件经常忘记创建
  • 项目日志更新不及时
  • Git 提交不规范
  • 每次都要等发现问题才改进

解决

  • 自动化脚本scripts/auto-record.sh
  • 流程固化:写入 HEARTBEAT.md 和 Cron 任务
  • 强制检查:每次任务执行后必须调用记录脚本

📚 三层记录体系

┌─────────────────────────────────────────────────────────┐
│  第一层:全局记忆 (memory/YYYY-MM-DD.md)                │
│  - 关键对话摘要                                          │
│  - 决定和结论                                            │
│  - 待跟进事项                                            │
│  - 其他备注                                              │
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│  第二层:项目日志 (projects/*/logs/2026-WXX.md)         │
│  - 每日完成工作                                          │
│  - 任务清单追踪                                          │
│  - 问题与风险                                            │
│  - 人类/AI 工作时长统计                                   │
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│  第三层:系统日志 (logs/)                                │
│  - agent-cron.log (Cron 任务执行)                        │
│  - cron-execution.log (调度日志)                         │
│  - ebbinghaus-*.log (复习日志)                           │
└─────────────────────────────────────────────────────────┘

🔄 记录流程

任务执行后自动流程

任务完成
调用 auto-record.sh
1. 检查/创建 memory/YYYY-MM-DD.md
2. 更新 projects/*/logs/2026-WXX.md
3. 更新 projects/*/docs/01-周进度报告.md
4. Git 自动提交
记录完成 ✅

手动调用示例

1
2
3
4
5
6
7
8
# 项目评审后
./scripts/auto-record.sh "项目周评审" "完成智守+CodePilot 周评审,更新任务状态"

# 晨间检查后
./scripts/auto-record.sh "晨间检查" "完成天气、项目、邮箱检查"

# 真理探索后
./scripts/auto-record.sh "真理探索" "完成量子力学与造物主主题研究"

📋 记录内容规范

memory/YYYY-MM-DD.md

# YYYY-MM-DD 记忆日志

## 📌 关键对话摘要

### 主题 1: [主题名称]
**时间:** HH:MM - HH:MM  
**背景:** [简要说明]

**执行内容:**
- ✅ [完成的工作 1]
- ✅ [完成的工作 2]

## 🎯 今日决定和结论
- [ ] [决定 1]
- [ ] [决定 2]

## ⏳ 待跟进事项
- [ ] [待办 1]
- [ ] [待办 2]

## 💡 其他备注
- [备注 1]
- [备注 2]

---

*自动创建:YYYY-MM-DD HH:MM*

projects/*/logs/2026-WXX.md

### YYYY-MM-DD (周 X) - [任务类型]

**完成工作:**
- ✅ [工作 1]
- ✅ [工作 2]

**评审结论/进展:**
- [结论 1]
- [结论 2]

**明日计划:**
- [计划 1]
- [计划 2]

**问题与风险:**
- 🟡 [风险 1]
- 🟢 [风险 2]

🛠️ 自动化脚本

auto-record.sh

位置: scripts/auto-record.sh

功能: 1. 检查/创建今日记忆文件 2. 更新项目周日志 3. Git 自动提交

用法:

./auto-record.sh [任务类型] [任务描述]

示例:

./auto-record.sh "项目周评审" "完成智守+CodePilot 周评审"
./auto-record.sh "晨间检查" "完成天气、项目、邮箱检查"


📅 定时任务集成

Cron 任务中的记录调用

每个定时任务执行后,应在消息中包含记录要求:

1
2
3
4
5
6
7
8
# 示例:周一项目评审
$OPENCLAW_SEND "Read HEARTBEAT.md. 执行项目周评审:
[任务内容...]

【记录要求】
1. 更新 memory/$(date +%Y-%m-%d).md
2. 更新 projects/*/logs/$(date +%Y-W%V).md
3. 执行 ./scripts/auto-record.sh '项目周评审' '完成评审'"

✅ 检查清单

每次任务执行后

  • 今日记忆文件已创建/更新
  • 项目周日志已更新
  • 周进度报告已更新
  • Git 已提交(有变更时)
  • 记录内容完整(对话、决定、待办)

每周日

  • 生成周总结 (2026-WXX-summary.md)
  • 更新 MEMORY.md(长期记忆)
  • 规划下周任务

🎯 持续改进

如何确保每次都执行?

  1. 脚本自动化 - 用 auto-record.sh 代替手动操作
  2. 流程固化 - 写入 HEARTBEAT.md 和文档
  3. 定期检查 - Heartbeat 时检查记录完整性
  4. Git 钩子 - 考虑添加 pre-commit 钩子强制检查

发现遗漏时

  1. 立即补上遗漏的记录
  2. 分析为什么遗漏(流程问题?脚本问题?)
  3. 改进自动化脚本或流程
  4. 更新本文档

📊 记录统计

文件类型 数量 最后更新 状态
记忆文件 memory/YYYY-MM-DD.md 每日
项目日志 projects//logs/.md 每周
周进度报告 projects/*/docs/01-周进度报告.md 每周
系统日志 logs/*.log 实时

本规范持续更新,每次发现问题后立即改进并记录