经验库维护
把反复犯的错追到源头改 skill 和规则
功能与用途
当项目里的 .learnings 经验库越堆越乱、同类错误反复出现时,这个 Skill 会先把学习记录和错误日志聚类诊断,找出重复条目,再顺着线索去改造成问题的源头,比如某个 skill 的说明、模板、hook 或项目规则,让错误不再发生。改完还要验证,再把已解决的记录归档清理,并同步 Codex 和 Claude Code 两边的共享技能。
适用场景
- 治理反复发生的同类错误:当项目中某类错误或踩坑记录频繁复发时,通过审计脚本聚类分析,追溯至具体的技能文件、模板或校验逻辑进行源头修复。
- 跨平台共享技能同步:在同时使用 Codex 与 Claude Code 的工程中,修改通用规则后同步双端技能内容,同时保留各平台专属的环境配置与命令。
- 经验库审计与验证归档:当经验库文件过长堆积时,排查已得到机制性修复的记录,将解决条目转入历史归档并移出活跃文件,维持规则库精简有效。
适用人群
- 用 Codex 或 Claude Code 做日常开发、维护 .learnings 目录的开发者
- 管理团队 AI 编码规范和 hooks 的技术负责人
- 同时维护 Codex 与 Claude Code 双平台技能配置的人
使用步骤
- 先让它读 RULES.md、LEARNINGS.md、ERRORS.md 三个文件,再跑审计脚本得到报告
- 从报告里挑优先级高的目标:同一 skill 出现 2 次以上、或归档加活跃合计 3 次以上的问题
- 顺着报告定位源头文件,改动必须落在可执行机制上,比如加硬性约束、改模板、加校验脚本,而不是只在记录里写一句「下次注意」
- 验证改动有效后,把对应记录写进 archive 归档并从活跃文件移除,最后同步双平台技能目录
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-14
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
维护 .learnings/ 经验库,把过多或反复出现的学习记录、错误日志、规则失效问题聚类诊断,追溯并修改对应 skill、模板、hook、校验脚本或项目规则;修复并验证后再归档或移除已解决记录;同时检查 Codex .agents/skills 与 Claude Code .claude/skills 的共享功能同步。用户提到 learnings 太多、错误反复犯、清理经验库、维护自我学习、压缩错误日志、从错误中修技能、同步 Codex 和 Claude Code 技能时触发。
使用前准备
- 需要 Python 3 环境来跑审计和同步脚本
- 项目里要有 .learnings 目录和 AGENTS.md 或 CLAUDE.md 等规则文件
- 需要了解项目使用的 skill 目录结构(.agents/skills 或 .claude/skills)
依赖与权限
- 读取用户主动提供的内容