📝 自动化记录规范
核心原则: 不要每次都发现问题之后再去执行 —— 建立自动化机制确保每次都执行
创建日期: 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 自动提交
↓
记录完成 ✅
|
手动调用示例
| # 项目评审后
./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 任务中的记录调用
每个定时任务执行后,应在消息中包含记录要求:
| # 示例:周一项目评审
$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 '项目周评审' '完成评审'"
|
✅ 检查清单
每次任务执行后
每周日
🎯 持续改进
如何确保每次都执行?
- 脚本自动化 - 用
auto-record.sh 代替手动操作 - 流程固化 - 写入 HEARTBEAT.md 和文档
- 定期检查 - Heartbeat 时检查记录完整性
- Git 钩子 - 考虑添加 pre-commit 钩子强制检查
发现遗漏时
- 立即补上遗漏的记录
- 分析为什么遗漏(流程问题?脚本问题?)
- 改进自动化脚本或流程
- 更新本文档
📊 记录统计
| 文件类型 | 数量 | 最后更新 | 状态 |
| 记忆文件 | memory/YYYY-MM-DD.md | 每日 | ✅ |
| 项目日志 | projects//logs/.md | 每周 | ✅ |
| 周进度报告 | projects/*/docs/01-周进度报告.md | 每周 | ✅ |
| 系统日志 | logs/*.log | 实时 | ✅ |
本规范持续更新,每次发现问题后立即改进并记录