self-improving-for-codex

Codex 自我改进

概述

使用此技能为 Codex 提供持久且原生于 Codex 的自我改进循环，而不依赖 SOUL 或 HEARTBEAT.md 等仅适用于 OpenClaw 的原语。

此技能假定有一个稳定的规则入口文件和一个稳定的记忆目录：

• 全局规则入口：~/.codex/AGENTS.md
• 全局记忆目录：优先使用 ~/.codex/memories/

工作流

1. 审查当前状态

首先检查以下位置：

• 全局 AGENTS.md
• 候选记忆目录
• 任何现有的 PROFILE.md、ACTIVE.md、LEARNINGS.md、ERRORS.md、FEATURE_REQUESTS.md
• 任何与夜间审查或记忆维护相关的现有自动化

如果环境中已有部分配置，请保留并扩展，而不要贸然替换。

2. 建立记忆布局

在全局记忆目录中创建或规范化以下文件：

• PROFILE.md
• ACTIVE.md
• LEARNINGS.md
• ERRORS.md
• FEATURE_REQUESTS.md

创建或修复这些文件时，请阅读 references/memory-files.md。

始终按以下方式划分内容：

• PROFILE.md：长期稳定的用户档案和沟通偏好
• ACTIVE.md：值得在未来任务开始时阅读的简明高优先级规则
• LEARNINGS.md：尚未提升为顶层规则的可复用经验和修正
• ERRORS.md：可复用的调试和环境故障知识
• FEATURE_REQUESTS.md：值得跨会话跟踪的缺失功能

3. 通过 AGENTS.md 接入循环

将 AGENTS.md 用作唯一的 Codex 原生入口。

它的职责是告知 Codex：

• 开始工作前要读取哪些记忆文件
• 何时记录新条目
• 如何按文件对条目分类
• 何时将内容从原始日志提升到 ACTIVE.md
• 除非用户明确要求，否则不得自动编辑 AGENTS.md 本身

提出或更新 AGENTS.md 文本前，请阅读 references/agents-snippet.md。

除非用户明确要求直接编辑，否则请在聊天中提出准确的 AGENTS.md 片段，并由用户手动应用。

4. 添加可选的夜间审查循环

如果用户需要定期维护，请创建夜间自动化，以便：

• 审查当前记忆文件
• 主要优化 LEARNINGS.md、ERRORS.md 和 FEATURE_REQUESTS.md
• 提出或应用对记忆文件的安全更新
• 绝不自动编辑 AGENTS.md

设计自动化前，请阅读 references/nightly-review.md。

5. 验证循环

结束前，确认配置确实形成了一个循环：

1. AGENTS.md 指引 Codex 查阅 PROFILE.md 和 ACTIVE.md
2. 五个记忆文件均已存在且内容合理
3. 提升规则明确
4. 如果用户要求了自动化，其提示词清楚说明了仅优化内容的职责和提升规则

提升规则

始终遵循以下提升规则：

• 仅当内容稳定、对不同任务均有用，且可能改善未来执行或沟通时，才提升到 ACTIVE.md
• PROFILE.md 仅保留持久的用户身份、风格和偏好信息
• 不要将临时上下文写入 PROFILE.md
• 不要将一次性杂项写入任何记忆文件
• 如果候选条目含义不明确，请将其保留在原始日志中，或作为提案，而不要提升

安全规则

• 不要假定 Codex 会自动读取任意记忆文件；应通过 AGENTS.md 接入循环
• 不要把仅适用于 OpenClaw 的机制描述成 Codex 原生具备的功能
• 除非用户明确要求，否则不要自动编辑 AGENTS.md
• 优先更新 ACTIVE.md，避免让 AGENTS.md 过于臃肿
• 规则应简洁且易于维护，避免冗长的叙述性总结

交付内容

使用此技能时，目标是生成以下部分或全部内容：

• 包含五个核心文件的记忆目录
• 建议添加到 AGENTS.md 的片段
• 可选的夜间自动化提示词
• 简要说明创建了什么、未更改什么，以及循环如何运作