Self Improvement (done properly) — 自我提升（正确进行）

自我改进 捕获、审查、推广和提取可重用的经验教训，以便在未来的会话中避免重复相同的错误。 核心思想 使用此技能进行可重用的学习，而不是处理每一个小问题。 一个好的记录通常具有以下属性之一： 它纠正了一个错误的假设。 它揭示了一个项目特定的约定。 它需要真正的调试或调查。 它可能会再次发生。 它应该改变未来的工作流程、记忆或工具。 不要记录诸如明显的打字错误、预期的验证失败或可以立即解决且没有可转移经验的错误等常见问题。 重要路径模型 此技能有两个不同的根： 技能根 —— 资源存放的位置： scripts/... references/... assets/... 工作区根 —— 项目或活动工作区存放的位置： .learnings/LEARNINGS.md .learnings/ERRORS.md .learnings/FEATURE_REQUESTS.md CLAUDE.md, AGENTS.md, .github/copilot-instructions.md, SOUL.md, TOOLS.md 永远不要将经验教训写入安装的技能目录中。始终以工作区根为目标。 快速决策表 情况 该怎么办 用户纠正你或更新事实 记录一个经验教训 非明显的命令/ API /工具失败 记录一个错误 用户要求一个缺失的功能 记录一个功能请求 你发现了一个可重用的解决方法或约定 记录一个经验教训 一个模式不断重复 搜索相关条目，链接到“也见”并考虑推广 一个经验教训具有广泛的适用性或重复 推广它到项目记忆中 一个已解决的、一般的模式可以帮助其他项目 提取一个新的技能 标准工作流程 1）首先找到工作区根 在读取或写入 .learnings/ 之前，确定 WORKSPACE_ROOT。好的默认值：当前代码库的存储库根、OpenClaw 工作区根或包含正在编辑的文件的目录。如果不确定，优先选择包含 .git、AGENTS.md、CLAUDE.md 或用户的活动项目文件的目录。 2）如果需要，初始化 .learnings/ 使用辅助工具而不是手动创建文件： python3 scripts/learnings.py init --root /absolute/path/to/workspace 这将创建： .learnings/LEARNINGS.md .learnings/ERRORS.md .learnings/FEATURE_REQUESTS.md 3）在进行风险或熟悉的工作之前审查现有的经验教训 首先审查：你正在返回一个以前失败的区域、任务涉及基础设施、CI、部署、身份验证、数据迁移或生成的代码、用户明确地说“记住这个”、“我们以前遇到过这种情况”或类似的情况。 使用辅助工具： python3 scripts/learnings.py status --root /absolute/path/to/workspace python3 scripts/learnings.py search --root /absolute/path/to/workspace --query "pnpm" --limit 5 4）在记录之前搜索以避免重复 在创建新条目之前，始终搜索相关条目： python3 scripts/learnings.py search --root /absolute/path/to/workspace --query "关键词或模式" --limit 10 如果已经存在一个类似的条目：优先使用“也见”链接、重用或添加一个稳定的 Pattern-Key 以处理重复问题、仅当重复问题足以证明时才增加优先级、优先更新现有的模式故事而不是创建近似重复的条目。 5）记录正确类型的条目 经验教训：用于更正、知识空白、最佳实践和可重用的约定。 python3 scripts/learnings.py log-learning \ --root /absolute/path/to/workspace \ --category correction \ --priority high \ --area backend \ --summary "项目使用 pnpm 工作区，而不是 npm" \ --details "尝试使用 npm install。锁文件和工作区配置显示 pnpm。" \ --suggested-action "在假设 npm 之前检查 pnpm-lock.yaml。" \ --source error \ --related-files pnpm-lock.yaml pnpm-workspace.yaml \ --tags package-manager,pnpm 错误：用于非明显的故障、异常或工具/API 问题。 python3 scripts/learnings.py log-error \ --root /absolute/path/to/workspace \ --name docker-build \ --priority high \ --area infra \ --summary "Docker 构建在 Apple Silicon 上由于平台不匹配而失败" \ --error-text "错误：无法解析：没有匹配的平台 linux/arm64" \ --context "docker build -t myapp . on Apple Silicon" \ --suggested-fix "使用 --platform linux/amd64 重试或更新基础镜像" \ --reproducible yes \ --related-files Dockerfile 功能请求：当用户需要一个缺失的功能或一个重复的摩擦点应该成为一个功能时使用。 python3 scripts/learnings.py log-feature \ --root /absolute/path/to/workspace \ --capability export-to-csv \ --priority medium \ --area backend \ --summary "用户需要将报告导出到 CSV" \ --user-context "需要与非技术利益相关者共享每周报告" \ --complexity-estimate simple \ --suggested-implementation "在现有的 JSON 输出旁边添加 --output csv" \ --frequency recurring \ --related-features analyze-command,json-output 6）将经过验证的经验教训推广到记忆中 当经验教训广泛适用、重复或是任何未来贡献者都可以使用时，推广它。