Self-Improvement Skill 是一个用于让编码智能体持续改进的技能，核心做法是把学习成果和错误记录到 markdown 文件中，供后续处理为修复，并把重要的学习内容提升为项目记忆。
用途与触发场景
该技能应在以下情况使用：命令或操作意外失败、用户纠正 Claude、用户想要缺失的功能、API 或外部工具失败、知识已过时、发现了更好的做法。它也提供了快速参考表，指导不同情况应记录到哪个文件：命令/操作失败记录到 .learnings/ERRORS.md；用户纠正记录到 .learnings/LEARNINGS.md 并标注 correction 类别；用户想要缺失功能记录到 .learnings/FEATURE_REQUESTS.md；API/外部工具失败记录到 .learnings/ERRORS.md 并附集成详情；知识过时记录到 .learnings/LEARNINGS.md 并标注 knowledge_gap 类别；发现更好方法记录到 .learnings/LEARNINGS.md 并标注 best_practice 类别。若与已有条目相似，可用 See Also 建立链接并考虑提升优先级；若学习内容广泛适用，可提升到 CLAUDE.md、AGENTS.md 和/或 .github/copilot-instructions.md。
主要能力
技能提供三类记录格式。学习条目追加到 .learnings/LEARNINGS.md，包含 ID、Logged 时间戳、Priority、Status、Area、Summary、Details、Suggested Action 和 Metadata（Source、Related Files、Tags、See Also）。错误条目追加到 .learnings/ERRORS.md，包含 ID、Logged、Priority、Status、Area、Summary、Error、Context、Suggested Fix 和 Metadata（Reproducible、Related Files、See Also）。功能请求条目追加到 .learnings/FEATURE_REQUESTS.md，包含 ID、Logged、Priority、Status、Area、Requested Capability、User Context、Complexity Estimate、Suggested Implementation 和 Metadata（Frequency、Related Features）。
ID 生成格式为 TYPE-YYYYMMDD-XXX，TYPE 可为 LRN、ERR、FEAT，YYYYMMDD 为当前日期，XXX 为顺序编号或随机 3 个字符。
技能支持解决条目：当问题修复后，将 Status 从 pending 改为 resolved，并在 Metadata 后添加 Resolution 块。其他状态值包括 in_progress、wont_fix、promoted。
技能支持将学习提升为项目记忆：当学习内容跨多个文件或功能适用、任何贡献者都应知道、能防止重复错误、或记录项目特定约定时，应进行提升。提升目标包括 CLAUDE.md、AGENTS.md、.github/copilot-instructions.md，并提供了简化的提升示例。
技能还支持重复模式检测，通过 grep 搜索、See Also 链接、提升优先级来识别重复问题，并考虑系统性修复。定期审查可在新重大任务开始前、完成功能后、进入有历史学习的区域时、活跃开发期间每周进行，并提供了快速状态检查命令。
技能提供检测触发条件，用于自动记录用户纠正、功能请求、知识缺口和错误。并给出了优先级指南和区域标签。
技能支持将学习自动提取为可复用技能，给出了提取标准、提取工作流程、手动提取方式、提取检测触发条件和技能质量门禁。
技能支持多智能体：Claude Code 通过 hooks 激活，Codex CLI 同样通过 hooks，GitHub Copilot 需手动激活。还提供 Copilot Chat 集成提示。
使用方式
首先在项目根目录创建 .learnings/ 目录：mkdir -p .learnings。从 assets/ 复制模板，或创建带标题的文件。然后按照对应格式追加记录。启用自动提醒需通过智能体 hooks，这是可选项，必须显式配置 hooks。快速设置是在项目中创建 .claude/settings.json 并配置 UserPromptSubmit hook 调用 ./skills/self-improvement/scripts/activator.sh；完整设置还包括 PostToolUse 调用 ./skills/self-improvement/scripts/error-detector.sh。可用 hook 脚本包括 scripts/activator.sh（UserPromptSubmit，提醒评估学习）和 scripts/error-detector.sh（PostToolUse Bash，命令出错时触发）。技能提取可运行 ./skills/self-improvement/scripts/extract-skill.sh skill-name --dry-run 或 ./skills/self-improvement/scripts/extract-skill.sh skill-name。
适用场景与限制
该技能适用于使用 Claude Code、Codex CLI 或 GitHub Copilot 的编码智能体，用于持续记录和沉淀项目学习与错误。它也给出了 Gitignore 选项：保持学习本地（.learnings/）、在仓库中跟踪学习、或混合方式。限制方面，hook 集成需显式配置，GitHub Copilot 不支持 hook 需手动激活。其他未提供的信息暂未提供。