自我改进学习日志

问题背景

编码 Agent 在一次会话里踩过的坑，往往在下次对话里还会重演：命令失败只留在终端滚动区，用户口头纠正没有落盘，「应该用 pnpm 而不是 npm」这类约定也散在聊天记录里。没有结构化记录时，后续 Agent 或人类贡献者很难系统性复盘，更谈不上把重复教训写进项目级上下文。

技能如何工作

本技能以工作区根目录下的 .learnings/ 为落盘中心，首次使用前只创建缺失文件，不覆盖已有内容。

• ERRORS.md：记录命令非零退出、异常、外部 API/工具失败等，尽量附复现步骤与集成细节。
• LEARNINGS.md：用户纠正、知识过时（knowledge_gap）、更好做法（best_practice）等；可与 Simplify & Harden 联动，用稳定的 Pattern-Key 去重并累计 Recurrence-Count。
• FEATURE_REQUESTS.md：用户明确提出的能力缺口（「能不能也…」类诉求）。

条目使用统一 ID（如 LRN-YYYYMMDD-001、ERR-…、FEAT-…），带 Status（pending / resolved / promoted 等）、优先级与 Area 标签。修复后更新状态；若规则已适用于全项目，则提炼后写入 CLAUDE.md、AGENTS.md、.github/copilot-instructions.md，或在 OpenClaw 工作区写入 SOUL.md / TOOLS.md，并把原条目标为 promoted。

重复主题应先 grep .learnings/，用 See Also 串联并考虑抬高优先级；满足 recurrence 条件时，把短句「预防规则」写进系统提示类文件，而不是堆长篇事故叙述。OpenClaw 场景还可通过 sessions_send 等做跨会话摘要传递（需用户明确同意且避免泄露密钥）。

边界与注意

不要默认记录密钥、令牌、私钥、环境变量或完整源码/配置；优先摘要与脱敏片段。Hook 与 PostToolUse 错误检测为可选、需显式配置，不是默认行为。.gitignore 可选择仅本地保留日志或团队共享——涉及敏感排障信息时需自行权衡。技能源自 OpenClaw 生态对 pskoett-ai-skills/self-improvement 的改造思路，通用 Agent 只需在项目根维护 .learnings/ 并在 AGENTS.md 等文件中自我提醒即可。