将经验教训和错误记录到 Markdown 文件中,以实现持续改进。编码代理可后续将这些内容处理为修复方案,重要的经验教训会升级到项目记忆中。
OpenClaw 是此技能的主要运行平台,它基于工作区实现提示词注入,并支持技能自动加载。
通过 ClawdHub 安装(推荐):
手动安装:
该技能基于以下原始仓库适配 OpenClaw:
OpenClaw 会将以下文件注入到每个会话中:
然后创建日志文件(或从 目录复制):
- — 记录纠正内容、知识缺口、**实践
- — 记录命令执行失败、异常信息
- — 记录用户请求的功能
当经验教训被验证具有广泛适用性时,需将其升级到工作区文件中:
OpenClaw 提供了跨会话共享经验的工具:
- sessions_list — 查看活跃/最近的会话
- sessions_history — 读取其他会话的记录
- sessions_send — 将经验发送到其他会话
- sessions_spawn — 创建子代理处理后台任务
如需在会话启动时自动触发提醒:
完整配置细节请参考 。
对于 Claude Code、Codex、Copilot 或其他代理,在项目中创建 目录:
从 目录复制模板文件,或手动创建带头部的日志文件。
在 、 或 中添加引用,提醒自己记录经验教训(作为钩子提醒的替代方案)。
自我改进工作流
当发生错误或收到纠正时:
- 将内容记录到 、 或
- 审核并将具有广泛适用性的经验升级到:
- - 项目事实和约定
- - 工作流和自动化规则
- - Copilot 上下文配置
追加到 :
追加到 :
实际的错误信息或输出内容
追加到 :
格式:
- 类型:(经验)、(错误)、(功能)
- 年月日:当前日期(格式:YYYYMMDD)
- 序号:连续数字或3位随机字符(例如:、)
示例:、、
当问题修复后,更新对应条目:
- 将 修改为
- 在元数据后添加解决信息块:
其他状态值:
- - 正在处理该问题
- - 决定不处理(在解决信息备注中说明原因)
- - 已升级到 CLAUDE.md、AGENTS.md 或 .github/copilot-instructions.md
当某条经验被验证具有广泛适用性(非一次性修复)时,需将其升级到项目的永久记忆中。
- 经验适用于多个文件/功能
- 所有贡献者(人工或AI)都应知晓的知识
- 可预防重复错误
- 记录项目特定的约定
- 提炼:将经验浓缩为简洁的规则或事实
- 添加:将内容添加到目标文件的对应章节(文件不存在则创建)
- 更新原始条目:
- 将 修改为
- 添加 / /
原始经验(详细版):
升级到 CLAUDE.md(简洁版):
原始经验(详细版):
升级到 AGENTS.md(可操作版):
如果记录的内容与已有条目相似:
- 先检索:
- 关联条目:在元数据中添加
- 提升优先级:如果问题重复出现,提高条目的优先级
- 考虑系统性修复:重复出现的问题通常表明:
- 缺少文档(→ 升级到 CLAUDE.md 或 .github/copilot-instructions.md)
- 缺少自动化(→ 添加到 AGENTS.md)
- 架构问题(→ 创建技术债务工单)
通过此工作流从 技能中提取重复模式,并将其转化为持久的提示词指导。
- 从任务摘要中读取
- 对每个候选项,使用 作为稳定的去重标识
- 在 中检索是否存在该标识的条目:
- 如果找到:
- 增加
- 更新 时间
- 添加指向相关条目/任务的 链接
- 如果未找到:
- 创建新的 条目
- 设置
- 设置 、 以及 / 时间
当满足以下所有条件时,将重复模式升级到代理上下文/系统提示词文件:
- 至少出现在 2 个不同任务中
- 发生在 30 天内
升级目标:
- / (适用于 OpenClaw 工作区级别的指导)
升级后的规则应编写为简短的预防规则(编码前/编码中应做什么), 而非冗长的事件记录。
在合适的节点审核 目录:
- 开始新的重大任务前
- 完成某个功能后
- 处理有历史经验记录的领域时
- 活跃开发期间每周一次
- 标记已修复的条目为已解决
- 升级适用的经验记录
- 关联相关条目
- 升级重复出现的问题
当发现以下情况时自动记录:
纠正内容(→ 分类为 的经验记录):
- "不,那不对..."
- "实际上,应该是..."
- "你错了..."
- "这已经过时了..."
功能请求(→ 功能请求记录):
- "你还能..."
- "我希望你能..."
- "有没有办法..."
- "为什么你不能..."
知识缺口(→ 分类为 的经验记录):
- 用户提供了你不知道的信息
- 引用的文档已过时
- API 行为与你的理解不符
错误(→ 错误记录):
- 命令返回非零退出码
- 异常或堆栈跟踪
- 意外输出或行为
- 超时或连接失败
用于按代码库区域筛选经验记录:
- 立即记录 - 问题发生后立即记录,上下文最清晰
- 具体详细 - 确保后续代理能快速理解
- 包含复现步骤 - 尤其是错误记录
- 关联相关文件 - 便于后续修复
- 提出具体修复方案 - 而非仅写"调查原因"
- 使用一致的分类 - 便于筛选
- 积极升级 - 如有疑问,优先添加到 或
- 定期审核 - 过时的经验记录会失去价值
仅本地保留经验记录(每个开发者独立):
在仓库中跟踪经验记录(团队共享): 不添加到 .gitignore - 经验记录成为团队共享知识
混合模式(跟踪模板,忽略条目):
通过代理钩子启用自动提醒。此功能为可选开启 - 需显式配置钩子。
在项目中创建 :
此配置会在每次提交提示词后注入经验评估提醒(约 50-100 个 token 开销)。
详细配置和故障排除请参考 。
当某条经验足够有价值、可转化为可复用技能时,使用提供的工具提取。
满足以下任一条件即可提取为技能:
- 确定候选项:找到符合提取标准的经验记录
- 运行工具(或手动创建):
- 自定义 SKILL.md:使用经验内容填充模板
- 更新经验记录:将状态设为 ,添加
- 验证:在新会话中读取技能,确保内容独立完整
如偏好手动创建:
- 创建
- 使用 模板
- 遵循 Agent Skills 规范:
- 包含 和 的 YAML 前置信息
- 名称需与文件夹名称一致
- 技能文件夹内不存放 README.md
发现以下信号时,应将经验提取为技能:
对话中:
- "将此保存为技能"
- "我总是遇到这个问题"
- "这对其他项目也有用"
- "记住这个模式"
经验记录中:
- 多个 链接(重复问题)
- 高优先级 + 已解决状态
- 分类为 且适用范围广
- 用户反馈称赞该解决方案
提取前需验证:
- [ ] 解决方案已测试且有效
- [ ] 描述清晰,无需依赖原始上下文
- [ ] 代码示例独立可运行
- [ ] 无项目专属的硬编码值
- [ ] 遵循技能命名规范(小写、连字符分隔)
该技能可在不同 AI 编码代理中运行,且支持代理专属的激活方式。
激活方式:钩子(UserPromptSubmit、PostToolUse) 配置:在 中配置钩子 检测方式:通过钩子脚本自动检测
激活方式:钩子(与 Claude Code 相同模式) 配置:在 中配置钩子 检测方式:通过钩子脚本自动检测
激活方式:手动(无钩子支持) 配置:添加以下内容到 :
检测方式:会话结束时手动审核
激活方式:工作区注入 + 代理间消息传递 配置:参考上文「OpenClaw 配置」章节 检测方式:通过会话工具和工作区文件检测
无论使用何种代理,遇到以下情况时应应用自我改进技能:
- 发现非显而易见的内容 - 解决方案并非立即可知
- 纠正自身错误 - 初始方案有误
- 学习项目约定 - 发现未文档化的模式
- 遇到意外错误 - 尤其是诊断难度大的错误
- 找到更优方案 - 改进了原始解决方案
Copilot 用户可在相关提示词中添加以下内容:
完成此任务后,评估是否有需要按照自我改进技能格式记录到 目录的经验。
或使用快捷提示词:
- "将此记录到经验中"
- "基于此解决方案创建技能"
- "检查 中的相关问题"
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/232686.html