📦 Operational Framework — 运营框架
v1.0.0为AI代理提供了一种有纪律、可复现的工作流程,用于记录决策、创建回滚快照,并为任何更改或功能实现生成简报。
运行时依赖
版本
需要回滚功能的任何工作
安装命令
点击复制技能文档
运营框架 一种实施变更的有纪律的方法,具有完整的可追溯性。 何时使用 实施改进或新功能 进行配置更改 需要回滚功能的任何工作 生成案例研究简报 架构(通用) / ├── decisions/ # 决策日志(每天一个JSON文件) │ └── .json # 示例:2026-05-08.json ├── rollbacks/ # 快照目录 │ └── / # 示例:2026-05-08_2005/ ├── briefings/ # 案例研究Markdown文件 │ └── .md # 示例:2026-05-08.md └── TODO.md # 持久任务列表 将 替换为 OpenClaw 工作空间的根目录(通常为 ~/.openclaw/workspace)。 决策日志记录(通用) 在开始进行任何更改之前记录每个重要的决策。 使用简单的 JSON 模式: { "id": "dec__", "timestamp": "", "title": "<简短描述>", "context": "<为什么这个决策很重要>", "options_considered": ["<选项1>", "<选项2>", "<选项3>"], "chosen": "<所选选项>", "reasoning": "<理由>", "expected_outcome": "<成功的样子>", "risk_mitigation": "<如何处理失败>", "status": "pending|implemented|reverted" } 如何日志记录: 手动编辑 decisions/ 中的文件(例如,2026-05-08.json)。 或者,如果您有 CLI 包装器,请运行: /decide "<标题>" --context "" --options "opt1|opt2|opt3" --chosen "opt2" --reasoning "<理由>" 用实际值替换占位符。 回滚系统(通用) 在修改任何内容之前进行轻量级快照。 快照可以是文件的简单副本或 git 提交。 典型工作流程: 选择一个名称(例如,2026-05-08_2005)。 将相关文件或整个工作空间复制到 rollbacks// 中。 验证副本。 如果需要,通过复制回去来恢复。 示例(shell 风格,适应您的环境): # 创建快照目录 mkdir -p rollbacks/2026-05-08_2005 # 复制您关心的文件(或整个工作空间) cp -r decisions rollbacks/2026-05-08_2005/ cp -r briefings rollbacks/2026-05-08_2005/ # ... 添加其他路径如有需要 列出快照: ls -1 rollbacks/ 恢复: cp -r rollbacks/2026-05-08_2005/* / 确切的命令可以被包装在一个脚本中以方便使用。 实施工作流程
- 决策阶段
- 快照阶段
- 实施阶段
- 验证阶段
- 简报阶段
上下文
[是什么触发了这个]决策
[是什么被决定的以及为什么]实施
[如何实施]结果
[成功/失败的证据]经验教训
- 什么做得好
- 下次会做什么不同
- 需要传播的模式
回滚点
[如果需要,引用快照] 快速命令(示例) 以下是您可以绑定到自己的 CLI 或脚本的示例命令。 它们不是内置的 OpenClaw 命令,但它们展示了典型的流程。 操作 示例 Shell / 伪命令 记录决策 echo '{...}' >> decisions/$(date +%F).json 创建快照 ./snapshot.sh (您的包装脚本) 列出快照 ls -1 rollbacks/ 恢复快照 ./restore.sh 生成简报 ./brief.sh <决策 ID> 打开 TODO vim TODO.md 请随意将这些命令适应到您偏好的工具(bash、Python 等)。 TODO 集成 在工作空间根目录中维护 TODO.md:2026-05-08 实施会话
活动
- [ ] 决策:实施 X
- [ ] 快照:AGENTS.md
已完成
- [x] 决策:添加内存回忆
- [x] 已实施:2026-05-08
- [x] 简报:briefings/2026-05-08.md
- 在实施前记录决策
- 总是有回滚路径
- 为未来的参考而记录
- 所有内容在会话重启时都保持不变