用途
Compound Engineering 旨在让 AI 智能体自动学习并持续改进。它通过回顾智能体的会话,提取经验教训,更新记忆文件,使知识随时间不断累积。其核心理念是:智能体审视自身工作,提炼模式与教训,并更新自身指令,从而让明天的智能体比今天更聪明。
主要能力
- 回顾与更新记忆:扫描最近 24 小时的会话,提取学习内容与模式,更新 MEMORY.md 和 AGENTS.md,并提交推送更改。
- 每小时记忆快照:创建每小时记忆快照,将简要总结追加到 memory/YYYY-MM-DD.md。
- 自动化夜间回顾:通过 cron 设置自动化夜间回顾任务(默认 22:30 运行)。
- 提取内容:包括有效的模式(可重复采用的方法)、陷阱(失败或引发问题的事项)、用户偏好、关键决策及其理由、未完成事项(TODO)。
使用方式
快速开始命令:
# Review last 24 hours and update memory
npx compound-engineering review
# Create hourly memory snapshot
npx compound-engineering snapshot
# Set up automated nightly review (cron)
npx compound-engineering setup-cron
Clawdbot 集成
自动每小时记忆:在 HEARTBEAT.md 中添加每小时记忆快照说明,或使用 cron:
0 * * * * clawdbot cron run compound-hourly
夜间回顾任务:向 Clawdbot 添加 cron 任务:
{
"id": "compound-nightly",
"schedule": "30 22 * * *",
"text": "Review all sessions from the last 24 hours. For each session, extract: 1) Key learnings and patterns, 2) Mistakes or gotchas to avoid, 3) User preferences discovered, 4) Unfinished items. Update MEMORY.md with a summary. Update memory/YYYY-MM-DD.md with details. Commit changes to git."
}
手动回顾命令:可手动触发回顾,要求提取有效模式、遇到的陷阱、学到的偏好、关键决策及理由、未完成事项,并更新 MEMORY.md、memory/YYYY-MM-DD.md,必要时更新 AGENTS.md,提交信息为 "compound: daily review YYYY-MM-DD"。
记忆文件结构
MEMORY.md(长期) 包含:有效的模式、需避免的陷阱、用户偏好、项目上下文。
memory/YYYY-MM-DD.md(每日) 包含:会话记录、决策、学习内容、未完成事项。
每小时快照:可创建每小时快照,例如:
*/60 * * * * echo "## $(date +%H):00 Snapshot" >> ~/clawd/memory/$(date +%Y-%m-%d).md
或让智能体通过心跳检查时间并追加到每日文件。
设置脚本
夜间回顾(macOS launchd):提供 plist 配置示例,在 22:30 运行 clawdbot cron run compound-nightly。
每小时记忆(crontab):
0 * * * * /opt/homebrew/bin/clawdbot cron run compound-hourly 2>&1 >> ~/clawd/logs/compound.log
适用场景
适用于希望 AI 智能体在长期使用中自动积累经验、记住用户偏好、避免重复错误、逐步成为特定工作流专家的场景。其复合效应表现为:第 1 周智能体了解基础;第 2 周记住偏好;第 4 周预判需求;第 2 个月成为工作流专家。
限制与最佳实践
- 建议在睡前运行夜间任务,让其在一天结束时执行。
- 不要过度提取,聚焦重要学习内容而非噪音。
- 定期修剪 MEMORY.md 中过时信息(建议每月)。
- 记忆文件应纳入版本控制(Git)。
- 复合效应初期微妙,随时间推移效果显著。
其他信息
由 LXGIC Studios 构建。GitHub:github.com/lxgicstudios/ai-compound;Twitter:@lxgicstudios。