技能介绍

它解决什么问题

Agent 在编码会话中反复犯错：用户纠正后不沉淀，命令失败后只临时修复，缺失功能只停留在当前上下文。这类经验如果只留在聊天记录里，下次会话仍会重复踩坑。这个技能把“学习、纠错、功能请求”变成项目里的 Markdown 日志，为后续 coding agent 提供可检索、可修复、可升级的经验库。

如何工作

核心流程是记录、归档、升级：

初始化：在项目根目录创建 .learnings/，包含 LEARNINGS.md、ERRORS.md、FEATURE_REQUESTS.md，不覆盖已有文件。
即时记录：用户纠正、命令失败、知识过时、外部工具失败时，按类型追加条目，使用 LRN-YYYYMMDD-XXX、ERR-...、FEAT-... 这类 ID，便于检索。
状态管理：条目从 pending 更新到 in_progress、resolved、wont_fix 或 promoted，并补充解决说明或引用关联条目。
项目记忆升级：当经验跨文件、跨任务适用，就蒸馏成短规则，写入 CLAUDE.md、AGENTS.md、.github/copilot-instructions.md；OpenClaw 环境也可落到 SOUL.md 或 TOOLS.md。
重复模式处理：先 grep 现有日志，若重复出现则补充 See Also、提高优先级，或在满足复现条件后升级为系统提示中的预防规则。

适用边界

它适合已有明确项目文件、需要跨会话保持上下文的工程型 Agent 工作流；不适合一次性脚本或无持久化目录的临时任务。日志默认应避开密钥、令牌、环境变量和完整源码，优先记录短摘要与脱敏摘录。升级文件要克制：只写入可复用规则，不把冗长事故记录直接塞进 CLAUDE.md 或 AGENTS.md。