菜单
维护 .learnings/ 经验库，把过多或反复出现的学习记录、错误日志、规则失效问题聚类诊断，追溯并修改对应 skill、模板、hook、校验脚本或项目规则；修复并验证后再归档或移除已解决记录；同时检查 Codex .agents/skills 与 Claude Code .claude/skills 的共享功能同步。用户提到 learnings 太多、错误反复犯、清理经验库、维护自我学习、压缩错误日志、从错误中修技能、同步 Codex 和 Claude Code 技能时触发。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
多篇既有学习笔记的批量更新编排。用于用户想一次更新一个目录、文件列表、Obsidian vault 子目录或多篇旧笔记，例如“批量更新这些笔记”“多篇笔记过时了”“把一组笔记更新到新版本”“refresh multiple notes”。先生成更新清单和批量计划，经用户确认后逐篇调用 note-updater 局部 patch，避免全文重写和批量误覆盖。
旧笔记批量导入、盘点和规范化。用于用户已经有一堆 Markdown/Obsidian/零散学习笔记，想接入本项目工作区、按项目 Obsidian 规范补 frontmatter、标签、双链、Callout、MOC，并保留原始文件时使用。触发词：旧笔记导入、已有笔记、一堆笔记、批量整理、迁移到这个项目、按项目规范、import existing notes、normalize notes。
学习笔记需求澄清与引导。分析用户学习需求，引导明确学习目标和方向，调用 workflow-orchestrator 生成项目结构。触发词：想学、帮我整理、研究一下、了解一下、不知道从哪开始、research planning、explore topic。
业务工作流实例化器。由 planner 技能调用，接收 workflow_id、topic、project_slug 等参数，按 .claude/workflows/{workflow-id}/state-template.md 生成 workspace/workflow-runs/{run-id}.workflow.md。不直接面向用户；通用状态格式和状态流转由 workflow-todo-state 负责。
Create or retrofit reusable named workflow state machines for multi-step agent projects. Use when a project needs recoverable workflow state files, multiple workflow definitions, phase gates, restart-safe agent workflows, explicit skipped/blocked states, workflow routing rules, or reusable workflow templates across repositories.
自我学习阶段。回顾本次学习会话，记录学习心得和错误到 .claude/rules/learnings/，当文件超阈值时自动压缩去重，更新 RULES.md，促进系统持续改进。
| name | maintain-learnings |
| description | 维护 .learnings/ 经验库，把过多或反复出现的学习记录、错误日志、规则失效问题聚类诊断，追溯并修改对应 skill、模板、hook、校验脚本或项目规则；修复并验证后再归档或移除已解决记录；同时检查 Codex .agents/skills 与 Claude Code .claude/skills 的共享功能同步。用户提到 learnings 太多、错误反复犯、清理经验库、维护自我学习、压缩错误日志、从错误中修技能、同步 Codex 和 Claude Code 技能时触发。 |
让 .learnings/ 保持小而有用：它是发现流程缺陷的雷达，不是永久堆放错误的仓库。重复错误必须优先修源头，验证有效后再清理活跃记录。
先读取：
.learnings/RULES.md.learnings/LEARNINGS.md.learnings/ERRORS.md然后运行审计脚本。Codex 示例：
python3 .agents/skills/maintain-learnings/scripts/audit_learnings.py --root . --skills-dir .agents/skills --rules-file AGENTS.md --hooks-path .codex/hooks
Claude Code 示例：
python3 .claude/skills/maintain-learnings/scripts/audit_learnings.py --root . --skills-dir .claude/skills --rules-file CLAUDE.md --hooks-path .claude/hooks
优先处理：
RULES.md 但仍在 ERRORS.md / LEARNINGS.md 中复发。根据审计报告读取对应源文件：
<skills-dir>/<skill>/SKILL.md<skills-dir>/<skill>/references/AGENTS.md / CLAUDE.md / 项目自定义规则文件.codex/hooks/ / .claude/hooks/ / 项目自定义 hookscripts/修复必须落到可执行机制之一：
SKILL.md 中加入明确步骤、硬性约束或验证 checklist。不要只把“下次注意”追加到 .learnings/。如果没有源头修改，不能清理对应错误记录。
至少验证两件事：
python3 -c 'from pathlib import Path; p=Path("<skills-dir>/<skill>/SKILL.md"); t=p.read_text(encoding="utf-8"); assert t.startswith("---\n") and "\n---" in t[4:]; assert "name:" in t and "description:" in t; print("skill metadata ok")'
如果项目同时使用 Codex 和 Claude Code，修改任何共享 skill 后都运行：
python3 .agents/skills/maintain-learnings/scripts/sync_platform_skills.py --root . --skill <skill>
如果另一侧缺失，先 dry-run：
python3 .agents/skills/maintain-learnings/scripts/sync_platform_skills.py --root . --from-platform agents --to-platform claude --skill <skill>
确认后应用：
python3 .agents/skills/maintain-learnings/scripts/sync_platform_skills.py --root . --from-platform agents --to-platform claude --skill <skill> --apply
保留平台专属内容：
agents/openai.yaml）只留在 .agents/。只处理已经验证修复的记录：
.learnings/archive/YYYY-MM-DD-maintenance.md 追加归档块，包含原记录摘要、修复路径、验证方式、处理结果。.learnings/LEARNINGS.md 或 .learnings/ERRORS.md 移除对应详细记录。.learnings/RULES.md 中的简短铁律。.learnings/。