| 场景 | Codex 技能 | Claude 技能 | 触发词 | 归档去向 |
| 项目收尾 / 会话结束 | readme-ref | doc-sync | 归档、结束会话、同步一下 | 项目 README / docs / AGENTS.md |
| 交流内容沉淀 | md-sync | md-create | MD同步 | H:\M_MD\TEMP\ |
| 每日工作复盘 | ai-worklog | codex-daily-worklog | 生成工作日志 | docs/worklogs/ 或 H:\M_MD\TEMP\ |
前言
跟 AI 协作写代码，最爽的是「聊着聊着就把事办了」。
最烦的也是这个。
聊完关掉窗口，三天后你自己都忘了当时定了啥约束、改了哪几个文件、为啥没走方案 B。
代码在 Git 里还能翻，但那些散落在对话里的判断、踩坑、临时约定，没了就是没了。
我后来给自己配了三套「收尾技能」，分工很明确。
项目里的知识，归项目。
聊出来的干货，归个人知识库。
一天干了啥，单独成日报。
这三件事听起来像一回事，其实完全不是。搞混了，要么把聊天记录硬塞进 README，要么项目改了半天文档里一个字没动。
这篇文章就把这三套技能掰开讲，顺便把 Codex 版和 Claude 版的名字对应关系说清楚。
先搞懂一件事，三种归档，三种受众
你可以把整个工作流想成三个桶。
第一个桶是项目知识。 给下一个接手的同事、下游系统、或者下次打开这个仓库的 AI 看的。载体是 README、docs/、AGENTS.md / CLAUDE.md，还有各平台自己的 agent memory。
第二个桶是个人知识库。 这次聊天本身就有价值，比如技能对比、排查记录、选型分析。它不一定该写进某个项目的 README，但值得留一份能独立阅读的 Markdown，扔到 H:\M_MD\TEMP\。
第三个桶是工作日志。 管你要的是「今天干了啥」的管理视角摘要，按天汇总，方便周报、复盘、跟领导对齐。
三个桶，三个技能家族。别混。
第一套，readme-ref / doc-sync，项目知识同步
核心定位
这是「知识库编辑」，不是「聊天记录存档员」。
readme-ref 是 Codex 里的名字，doc-sync 是 Claude 里的名字，本质上是同一个技能的两个安装副本。干的事一样，把项目里的多层知识对齐到「当前真相」。
管哪些文件
这个技能会盘点并同步这些东西。
-
项目根
README.md -
AGENTS.md/CLAUDE.md（给 AI 看的项目规则手册） -
docs/目录下的架构、接入、运维、交接文档 -
Agent 记忆系统（Claude Code 在
~/.claude/projects/.../memory/，Codex 用AGENTS.md等，各平台路径不同）
它核心理念是「三层知识、三种受众」。
| 层级 | 给谁看 | 写什么 |
| Agent memory | 跨会话的 AI 自己 | 非显而易见的约束、踩坑、协作习惯 |
| CLAUDE.md / AGENTS.md | 当前项目里的 AI | 硬规则、红线、命令速查、结构约定 |
| README + docs/ | 人类同事、下游、未来接手的人 | 怎么接入、怎么运维、架构说明 |
适用场景
-
一个开发阶段做完，准备收工
-
你说「归档」「结束会话」「这个阶段做完了」
-
发现文档跟代码对不上，或者记忆里有过期信息
-
要把项目交给同事或另一个 Agent，需要「新人能直接上手」
-
跨项目改动，上下游两边的 docs 都得跟着改
怎么用
触发词很宽，同步一下、整理文档、更新记忆、收尾、/readme-ref、/doc-sync 都能唤起。
执行时它会先 git status 看这次会话实际动了啥，再按变更类型查 sync-matrix，判断该改哪些文件。顺序一般是先改 docs/（外部读者优先），再改项目规则文档，最后理 memory。
完成后会给你一份摘要，标明「同步完成」「部分完成」还是「同步阻塞」。
注意事项
这块是我觉得最值得认真读规则的地方，翻车也最容易翻在这儿。
别把 CLAUDE.md 写成变更日志。 每次开发完往顶部塞一段「2026-xx-xx 某某功能上线」，半年后真正的规则就被挤到看不见了。历史叙事归 git log，不归规则手册。
不要乱新建 Markdown 文件。 只是缺一个小节、一张表，补到现有文档里就行。不要为了「记录这次改了什么」单独造一个新文件。
不要写猜测。 真相优先级是代码 > 测试输出 > 项目文档 > memory。没确认的东西别写进知识库。
删 memory 要慎重。 那些「代码里看不出来但真的会踩坑」的约束，删了下一个 Agent 会重踩。
注意文档膨胀。 CLAUDE.md 超过大约 300 行就该先精简，而不是继续往上堆。超尺寸时，同步补漏反而没意义，因为 AI 根本读不到重点。
跨项目别漏改。 改了上游 API，下游项目的 integration-guide 也得对齐，这是历次同步最常漏的场景。
第二套，md-sync / md-create，交流内容归档到个人知识库
核心定位
把当前对话整理成一篇能独立阅读的 Markdown，存到个人知识库目录。
md-sync 在 Codex，md-create 在 Claude，功能基本一致。你输入 MD同步，它就把这场聊天改写成结构化文章，不是逐条转录聊天记录。
归档去哪
固定目录 H:\M_MD\TEMP\。
文件名规则 YYYYMMDD_###_article-title.md，比如 20260609_001_readme-ref-md-sync-ai-worklog-技能介绍.md。同一天多篇就递增序号。
适用场景
-
跟 AI 聊完一轮有价值的分析、对比、排查，想留档
-
技能介绍、工具选型、会议纪要、教程笔记这类「交流型内容」
-
内容跟某个具体项目的 README 无关，或者不适合写进项目 docs
-
你说
MD同步，或者明确要把当前线程整理成 md
会产出什么样的文档
不是聊天原文拷贝。它会提炼主题，按内容选结构，比如。
-
问题解决型，背景 / 目标 / 实施 / 结果 / 后续
-
教程型，概览 / 步骤 / 关键命令 / 注意事项
-
规划型，目标 / 约束 / 方案 / 决策
保留有用的命令、路径、决策和踩坑，去掉来回废话。
注意事项
归档是强制步骤，不是可选项。 光在聊天里贴 Markdown 不算完成，必须落到 H:\M_MD\TEMP\ 并回报完整路径。
别拿它替代项目文档同步。 个人知识库里的文章，不会自动更新项目的 README 或 AGENTS.md。聊的是项目改造，收尾还得走 readme-ref / doc-sync。
标题要描述成果，不是描述聊天过程。 好的标题像「三套日常工作归档技能对比」，差的标题像「关于归档的一次讨论」。
和 readme-ref 的分工。 一句话记，md-sync 存「聊出来的文章」，readme-ref 改「项目里的手册」。
第三套，ai-worklog / codex-daily-worklog，每日工作日志
核心定位
按天汇总你在 Codex 里干了啥，生成面向工作复盘的管理摘要。
ai-worklog 是 Codex 技能目录里的正式版本。codex-daily-worklog 是更早的私有版本，思路接近，但实现和输出路径略有不同。
两个版本怎么分
| 对比项 | ai-worklog | codex-daily-worklog |
| 数据来源 | ~/.codex/session_index.jsonl、当日 sessions、archived_sessions |
Codex 会话 + 当前目录 Git 活动 |
| 默认输出 | 当前工作目录 docs/worklogs/YYYY-MM-DD-ai-worklog.md |
H:\M_MD\TEMP\YYYY-MM-DD-worklog.md |
| 详细模式 | 支持 --include-details 输出命令、文件、关键节点 |
相对简单 |
| 指定日期 | 支持 --date YYYY-MM-DD |
偏当天 |
适用场景
-
下班前想快速复盘今天跟 AI 协作做了哪些事
-
写周报需要捞当天的任务线索
-
指定某一天，比如
--date 2026-06-08，补生成漏掉的日志
输出长什么样
按线程汇总，每块大致包括。
-
线程主题 / 任务
-
当天做了什么
-
主要产出
-
遗留问题 / 待办
详细模式会多命令、涉及文件、关键节点。
注意事项，这块得说实话
我自己用下来，ai-worklog 没有预期的好用，这是实话。
原因大概这几条。
它看到的是「会话索引」，不是完整审计日志。 首版不保证 100% 还原每一步工具调用，跨设备也不同步。
线程标题和用户消息质量决定摘要质量。 如果你开会话时标题很模糊，生成的日志也会泛。
跟 md-sync 不重叠。 工作日志要的是「今天做了哪些事」的清单视角；md-sync 要的是「这场聊天值得留成文章」的深度整理。一天聊十个话题，日志给你十条摘要，不会给你十篇 polished 文章。
降级是常态。 找不到完整操作记录时，脚本仍会生成，但会注明覆盖范围可能不完整。看到降级提示别当成最终版。
输出路径要想清楚。 ai-worklog 默认落在项目里的 docs/worklogs/，codex-daily-worklog 落在 H:\M_MD\TEMP\。用之前确认你要把日报跟项目走，还是跟个人知识库走。
三套技能怎么配合，一张表看完
| 你现在的状态 | 该用哪个 | 触发方式 |
| 刚改完项目代码，怕下次 AI 或同事接不住 | readme-ref / doc-sync | 「归档」「结束会话」 |
| 聊出一篇值得收藏的分析或教程 | md-sync / md-create | 「MD同步」 |
| 下班了想汇总今天所有 Codex 会话 | ai-worklog | 「生成工作日志」 |
| 既要项目文档对齐，又要留个人笔记 | 先 readme-ref，再 md-sync | 两个都做，顺序别反 |
| 项目改造 + 个人笔记 + 日报 | 三个各干各的 | 见上，别用一个顶替另外两个 |
推荐收工顺序。
-
代码改完、测试过
-
跑 readme-ref / doc-sync，把项目知识对齐
-
如果这场聊天本身有独立价值，跑 md-sync / md-create
-
一天结束时，按需跑 ai-worklog
常见踩坑
坑一，会话结束只说了「再见」，没触发归档。
代码提交了，CLAUDE.md 还是上周的版本，下次开新会话 AI 按过期规则干活。解决很简单，养成习惯，收工时说「归档」或「结束会话」。
坑二，把 md-sync 当项目文档更新器。
个人知识库文章写得再漂亮，项目的 integration-guide 也不会自动变。该走 readme-ref 就走 readme-ref。
坑三，readme-ref 把 CLAUDE.md 越写越长。
看似在「同步」，其实在堆历史叙事。超 300 行先精简，再补漏。
坑四，工作日志指望它替代手工复盘。
ai-worklog 是辅助线索，不是绩效报告。重要决策还是自己在 md-sync 归档里写清楚。
坑五，Codex 和 Claude 技能名搞混。
记住对应关系就行，readme-ref = doc-sync，md-sync = md-create。功能一样，装在哪个平台就用哪个名字唤。
收尾
跟 AI 协作，真正贵的不是生成代码那几分钟，是上下文断裂之后你重新摸一遍项目的几小时。
这三套技能干的事，说白了就一句，在上下文消失之前，把该留的东西留对地方。
项目里的归项目，聊出来的归知识库，一天干了啥单独记账。
下次收工别光关窗口，想想该触发哪一个。
相关技能路径
Codex，~/.codex/skills/readme-ref、~/.codex/skills/md-sync、~/.codex/skills/ai-worklog
Claude，~/.claude/skills/doc-sync、~/.claude/skills/md-create
评论
发表评论