ByteNoteByteNote

字节笔记本

2026年8月28日

两个 Codex Skill:retrospective 让它长记性,fluent 让 session 不膨胀

API中转
¥120

Codex 用久了会出现两件事:同样的偏好要反复讲,session 越来越重、启动越来越慢。@mylifcc 做了两个配套 skill:codex-retrospective 负责从历史里长记性,codex-fluent 负责把旧会话归档而不是删掉。仓库在 majiayu000/spellbook

原帖:https://x.com/mylifcc/status/2059967391761891796

两个 skill 各管什么

codex-retrospective 让 Codex 定期回看过去几天或几周的会话,用尽量小的改动去更新 AGENTS.md,并抽出真正可复用的小 skill。适合刚复盘完一轮很烦的会话,或者每周/每月做一次「最近 7/30 天回顾」。

codex-fluent 管手感。启动变慢、旧聊天堆着不敢删、session 目录膨胀时用它。规则很死:先检查、先写 handoff,再归档。归档目录是 ~/.codex/archived_sessions/ 这类独立位置,不是直接 rm。

合在一起就是:一个改行为,一个改状态。作者建议的月度节奏是先 retrospective 近 30 天,再跑 fluent 诊断,然后只落地两边最好的几条。

怎么装

Skill 装到 Codex 当前文档路径 $HOME/.agents/skills。Spellbook 的安装脚本可以只装这两条:

bash
# 只给 Codex 装这两条
curl -fsSL https://raw.githubusercontent.com/majiayu000/spellbook/main/install.sh | bash -s -- --target codex --skills codex-retrospective,codex-fluent

或者手拷:

bash
git clone https://github.com/majiayu000/spellbook.git
cp -R spellbook/skills/codex-retrospective ~/.agents/skills/codex-retrospective
cp -R spellbook/skills/codex-fluent ~/.agents/skills/codex-fluent

装完重启 Codex,让它重新读 ~/.agents/skills。旧版 Spellbook 曾用 ~/.codex/skills,现在要指到 ~/.agents/skills

什么时候跑

  • 同一类错被你纠正过好几次:跑 retrospective
  • fluent 提示它总在问同一套偏好:也跑 retrospective
  • 启动明显变慢、旧会话不敢丢:跑 fluent
  • retrospective 抱怨「每次都要重读一大坨上下文」:接着跑 fluent

fluent 第一次必须只出报告,不改东西。对还可能继续的仓库会话,归档前要有 handoff 文档和一条能让新线程接着干的 reactivation prompt。改之前先做带时间戳的备份。

注意

这两条不是官方 Codex 内置 skill,是社区仓库。装之前看一眼 SKILL.md 和安装脚本会写到哪里。handoff 文档本身也可以喂给下一次 retrospective,别把归档当回收站。

链接

分享: