持续自省改进日志

问题从哪来

编码代理在一次会话里踩过的坑，往往在下次会话里原样重演：命令失败只留在终端滚动条里，用户一句「不对，应该……」也不会自动变成仓库里的约定。没有结构化落盘，纠错、知识缺口和功能诉求就只能靠人肉重复说明，后续代理也无法批量消化成修复或文档。

技能如何工作

本技能约定在项目或工作区根目录维护 .learnings/，用 Markdown 做可检索、可升级的日志层，而不是临时聊天备注。

• ERRORS.md：记录命令非零退出、异常、外部 API/工具集成失败；尽量写复现步骤与相关路径，避免整段粘贴密钥或完整配置文件。
• LEARNINGS.md：用户纠正（correction）、过时认知（knowledge_gap）、更优做法（best_practice）；可与 simplify-and-harden 的 Pattern-Key 去重并累计 Recurrence-Count。
• FEATURE_REQUESTS.md：用户明确提出的能力缺口。

条目使用统一 ID（如 LRN-YYYYMMDD-001），带 Status（pending / resolved / promoted 等）与优先级。修复后更新状态；若规则已适用于全项目，则提炼后写入 CLAUDE.md、AGENTS.md、.github/copilot-instructions.md，或在 OpenClaw 工作区写入 SOUL.md、TOOLS.md。首次使用前只创建缺失文件，不覆盖已有内容。

适用边界

这是流程与格式约束，不替代理自动改代码。日志默认可按 .gitignore 保持本地；跨会话共享（如 OpenClaw 的 sessions_send）仅在可信环境且用户明确要求时使用，且应发送脱敏摘要而非完整 transcript。Hook 提醒为可选 opt-in，需自行配置。