用途：当用户提出应长期生效的纠正、偏好或策略时，使用 learn 将其固化为持久指导。一次性、仅限当前任务或文件的指令不适用。
主要能力：从当前对话中找出最近的持久性纠正、规避项或偏好；判断作用范围（项目级或全局）；在写入前确认目标 AGENTS.md 与措辞；跳过重复项，遇冲突先询问如何解决；每条新增条目末尾追加 (Codex learning)。
使用方式：先确定范围。若规则明显与仓库结构、工具或工作流绑定，优先建议项目 AGENTS.md；否则默认全局，除非用户明确说 project、project-root 或 workspace。确认应轻量：说明将写入什么、写到哪里，默认视为持久且全局可接受，用户可回复 no、stop、project 等更改或取消。若上下文中没有新内容或已存在，运行 scripts/extract_recent_transcript.py，从最后一条用户消息向前扫描 JSONL，找到最近的持久性纠正后重复上述步骤。
目标位置：global 默认 ~/.codex/AGENTS.md；project 为仓库根目录的 AGENTS.md（无仓库时为 cwd）。若仓库根与 cwd 都有 AGENTS.md，分别标记为 project-root 与 workspace。若子文件夹存在多个 AGENTS.md，且规则可能只与某个子区域相关，优先建议最近的子 AGENTS.md，并始终显示完整路径；不存在则先建议仓库 AGENTS.md。最终选择由用户决定；目标不存在时询问是否创建，仍默认全局。
写入规则：优先放入现有合适章节；没有则新建简洁章节；仅当无更合适章节时才用 ## Codex Learnings。条目应简洁具体，如 Avoid X 或 Do Y instead of Z。
文档与 AGENTS 的取舍：若指导应让人可见、与当前工具或工作流紧密耦合、或可能随代码库变化，优先写入仓库文档；仅当规则既持久又面向该范围的智能体时，才用 AGENTS.md。
限制：本技能只写 AGENTS.md，绝不写入或更新 MEMORY.md、memory_summary.md 或其他记忆文件；写入持久偏好前必须确认；流程结束后不得绕过上述步骤继续写入。脚本输出为 JSON，含 session_id、rollout_path、cwd 及 AGENTS.md 候选与建议。