Codex Closeout Archive(Codex 关闭归档技能)
当用户明确要求关闭、归档、结束、收集或保存一次 Codex 对话时,使用此技能。它将对话转换为一个轻量级的过程资产,然后归档该对话。
用户的明确关闭请求就是资产化的决策。一旦调用此技能,不要重新讨论该线程是否值得保存;每次关闭都会创建一个简洁的过程资产。
为什么需要此技能
Codex 线程通常包含着真正的工作:意图转变、用户更正、证据路径、文件更改、外部源检查以及最终决策。如果线程仅在应用中归档,下一个对话可能会失去决策变更的原因。
此技能保留了可重用的轨迹,而无需复制整个对话记录。它保护了:
- 可追溯性:未来的工作可以找到原始会话、文件和证据。
- 决策连续性:关键的转折点和更正能够跨线程存留。
- 低摩擦关闭:每次结束都会产生一个有用的工件,而不是一个庞大的归档系统。
不要仅仅因为对话变得安静或代理想要整洁地结束而使用此技能。只有在用户请求的下一个状态是关闭、归档、收集或保存时,才使用它。
不可协商项
- 每次使用此技能时都必须创建一个过程资产。
- 默认使用相关的项目文件夹。
- 保持时间线简洁:通常 5-12 个关键转折点。
- 保留关键转折点、用户更正、决策、输出文件和证据路径。
- 不要在资产中粘贴完整的原始对话记录、完整的 Slack 或 DM 内容、凭据或敏感导出内容。
- 不要删除、移动或重写原始的 Codex 会话文件。
- 写入并验证资产后,归档当前对话,除非用户要求准备资产但不结束线程。
工作流程
1. 确定目标路径
选择代表当前项目的最小现有文件夹。
按以下顺序优先选择:
- 用户明确命名的项目文件夹。
- 如果线程与仓库相关,则为仓库或工作区根目录。
- 本地
AGENTS.md、工作区说明或用户操作系统要求的持久项目、区域或操作文件夹。 - 当没有更明确的项目文件夹时,使用当前工作目录。
仅当存在多个可能的目标文件夹且写入错误的文件夹会产生清理工作时,才询问一个简洁的问题。
如果用户的环境有持久的记录系统,请在写入前遵循其最近的 AGENTS.md 或等效项目说明。
使用如下文件名:
<主题简称>__codex-process-asset__YYYY-MM-DD.md
如果没有明显的主题简称,则使用:
codex-closeout__YYYY-MM-DD.md
2. 定位证据
在写入资产之前,记录证据路径。
查找:
- 当前工作区路径。
- 当前或已归档的 Codex 会话 JSONL 路径。
- 可用时,从 JSONL 的
session_meta负载获取的线程 ID。 - 在对话期间创建、编辑、移动或验证的文件。
- 读取或写入的外部系统,如果安全可保留,则附上链接或查询名称。
会话文件通常位于:
~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl
~/.codex/archived_sessions/rollout-*.jsonl
在 Windows 上,~ 通常解析为用户档案目录。
如果当前活动会话在磁盘上尚不可见,请明确写出:
Codex 会话证据:当前活动线程;JSONL 在关闭时未定位。
可选辅助脚本:
python scripts/extract_session_events.py --latest
python scripts/extract_session_events.py --session "/path/to/rollout.jsonl"
仅使用辅助脚本获取原始事件清单。自行整理最终的时间线。
3. 编写过程资产
使用以下结构:
# <标题> Codex 过程资产
归档日期:YYYY-MM-DD
归档时间:YYYY-MM-DD HH:mm+TZ
工作区:`<绝对路径>`
本地项目:`<绝对路径>`
Codex 会话证据:`<绝对路径或活动线程注释>`
线程 ID:`<id 或 unknown>`
## 1. 资产类型
本文件是一个过程资产。它保留了 Codex 对话的关键演化过程,而不是完整的原始对话记录。
## 2. 保存原因
- <关闭为何重要>
- <未来读者应从该资产中恢复什么>
## 3. 简洁时间线
| 时间 | 事件 | 含义 |
| --- | --- | --- |
| <时间> | <关键转折点> | <为何重要> |
## 4. 输出与证据
| 类型 | 路径 / 链接 | 备注 |
| --- | --- | --- |
## 5. 决策与更正
- <最终决策>
- <重要用户更正>
- <已澄清的边界>
## 6. 待处理事项
- <事项 或 “无记录”>
## 7. 边界
- 未复制原始私人消息、凭据和完整的 Codex JSONL 内容。
- 原始会话文件保留在原位。
## 8. 检索标签
- <标签>
保持文字简洁。资产应在一到两分钟内可重读。
4. 更新附近索引
当存在时,更新最小的附近发现面:
- 项目文件夹中的
README.md或index.md(如果包含工件表或源映射)。 - 项目文件夹中的
CHANGELOG.md(如果存在)。 AGENTS.md或等效工作区策略要求的任何本地运行日志或项目索引。
除非没有合理的项目文件夹,否则不要仅为关闭而创建新文件夹。
5. 验证
在最终确定之前:
- 确认过程资产存在于预期路径。
- 在资产中搜索会话证据路径或活动线程注释。
- 确认任何索引或 changelog 更新提及了新资产。
- 列出更改过的文件。
6. 最终响应与归档
简要回复:
- 过程资产路径。
- 任何已更新的索引或 changelog 文件。
- 证据路径状态。
- 任何仍待处理的事项。
然后归档当前对话。在 Codex Desktop 中,将归档指令作为最后一行发出:
::archive{reason="关闭过程资产已创建,对话已归档"}
仅在用户要求准备关闭但不结束线程时,才跳过归档指令。
示例
对如下提示使用此技能:
- "结束此 Codex 线程并创建一个可跟踪的过程资产。"
- "归档此对话,保留关键决策和证据路径。"
- "用一个简洁的过程资产关闭此线程。"
- "执行关闭并将输出路径和会话证据留在项目文件夹中。"