项目记忆与上下文管理

这套做法来自半年 AI 漫剧生产：几千条片子、每天换好几个对话。对话会被压缩、会换模型、会换人接手，靠“上次聊过”撑不住。核心只有一句：项目文件夹就是记忆；对话里说的不算，写进文件的才算；人定的规则原话记下，AI 的推测不记。

配套 skill multi-ai-handoff 管“谁执行、谁检查、谁拍板、怎么交接”；本 skill 管“东西放哪、记什么、断了怎么接上”。

1. 项目文件夹就是记忆

项目名/
  00_项目/                 ← 整个项目共用，跨单元
    规则台账.md            ← 人定过的规则（第 4 节）
    已定设定表.md          ← 确认过的事实：人物、世界观、接口、术语
    进度摘要.md            ← 每个单元做完写三到五行
    负责人备忘.md          ← 人的纠正和偏好（第 3 节）
    跑法.md                ← 可选：本项目怎么跑、哪些停点取消（第 7 节）
    交接.md                ← 可选：换对话、换人时的接手说明（第 8 节）
  第N集/                   ← 一个单元一个文件夹（集、章、迭代、批次都行）
    N_输入.md
    N_产出.md
    N_说明.md              ← 这次改了什么、待人定什么
    复核/                  ← 复核记录

• 文件名固定。每一步只认文件名，不认对话上下文：开工先看要读的文件在不在，缺了就停下报“哪一步、缺什么文件”，不替上游补。
• 进度 = 文件夹里有什么。不另外维护“运行状态”文件，不信旧对话里的“已完成”。
• 备份改名成 旧版_*、*_改前_*，判断进度时不算。
• 共用文件放 00_项目/，单元产物放各自文件夹，互不覆盖。

文件名按项目改，改了就在 跑法.md 或项目指令里写一张表，之后不再变。通用结构和两个虚构例子见 references/folder-layouts.md。

2. 四种东西，四个地方

只记人说过或明确认可的。 AI 自己推测的方法、没被采用的建议、一次性的实现细节，都不写成条目。转述只能缩小，不能扩大。

3. 纠正当场改，再按类写回

人说“不对”“漏了”“太长”“效果不行”时：先把这次改完，再判断这条纠正属于哪类，写回去，下次自动带上。

新条目推翻旧条目时，旧条目标“已替代”，不删。

4. 规则台账

00_项目/规则台账.md 是项目里唯一的规则来源。文件、对话、skill 说法冲突时，按台账写的优先序裁决。

## 优先序
负责人最新原话 > 跑法.md > 项目指令 > skill 默认

## 规则
| 编号 | 规则 | 原话 | 出处 | 日期 | 状态 | 替代 | 落地位置 |
|---|---|---|---|---|---|---|---|
| R001 | 每集开工前先问跑不跑 | “每集先问我” | 对话 | 2026-03-02 | 已替代 | R014 | 跑法.md |
| R014 | 预算内核对后直接生成 | 决策卡选“核对后直接生成” | 决策卡 | 2026-04-10 | 现行 | — | 跑法.md 第 2 节 |

• 原话原样抄；只点了决策卡的，写卡上选项原文。查不到原话的不算现行，记“待定”。
• 状态只用三个：现行、已替代、待定。已替代的不删，“替代”栏指向新编号。
• “落地位置”写这条规则落在哪些文件、第几节，规则或 skill 升级后按它逐条核对还落不落得住。
• 新项目没有台账时，开局从项目指令、备忘、聊天里的决定收集已定规则建一份；互相矛盾又查不到原话的记“待定”，问人。

完整模板见 templates/rule-ledger.md。scripts/check_project.py 可以检查台账格式和关键文件（第 9 节）。

5. 断了怎么接上

用户说“继续”、新开对话、换了 AI 时：

1. 先读 00_项目/交接.md（有的话）和 规则台账.md。
2. 列出当前单元文件夹里的标准文件，按“已有文件 → 接到哪一步”的判定表接。几行同时命中，取进度最远的那一行。判定表每个项目写一份，写法和例子见 references/resume-rules.md。
3. “已确认”只看人的原话。不确定就当没确认，停在该停点。

半稿与回退

• 产物只有一半：从缺的地方增量补，保留已有部分，不整步重跑。
• 人点名回退某一项：只重跑那一项所在的步，上游不动，改完停在同一个停点。
• 上游文件被改：它之后各步的产物都算过期，从被改那一步之后重接；复核记录里哈希对不上的自动失效（见 multi-ai-handoff 的复核闸门）。
• 可选读的文件（上一单元的摘要、备忘）第一个单元还没有，跳过，不算缺。

6. 多单元并行与共享文件

• 默认一个单元做完才开下一个，因为后面的修改可能改到上游，下一个单元要读最终版。
• 人要求并行时可以并行，但上一单元后来改了共享内容，要告诉人下一单元哪里可能受影响。
• 共享文件同一时间只有一处在写；几个单元都要写时，按单元编号顺序写。
• 每个单元的文件夹可以在不同对话里推进，开工前先读 00_项目/ 共享文件的最新版。

7. 跑法与授权

默认的停点和“每步先问”写在各 skill 里。负责人想放宽（例如取消某个停点、改成复核通过就往下走、预算内直接生成），要同时满足两条才生效：

1. 写进 00_项目/跑法.md 或项目指令；
2. 规则台账.md 里有对应的现行条目，附原话。

只有一条、或台账状态不是“现行”，就照 skill 默认。放宽什么都不取消这些：花超预算的钱、删文件、改锁定内容、改核心方向、合并规则改动。只有负责人本人能决定项目采用哪种跑法，AI 不替新项目引用旧项目的授权。模板见 templates/run-mode.md。

8. 换对话、换人时的交接文件

对话要结束、或要交给另一个 AI 时，写 00_项目/交接.md，新对话第一句就让它先读。只写这几块：

1. 背景：一两段，为什么做这件事。
2. 已定：人原话确认过的，带日期。
3. 待定：要问人的，每条给推荐。
4. 进度：勾选清单，写到文件路径。
5. 素材位置：路径加一句说明。
6. 人的工作习惯：照做的几条。

“已定”和“待定”分开写，是交接里最重要的一点：接手的 AI 最容易把建议当成已定，或者把已定的事再问一遍。模板见 templates/handoff-file.md。

9. 巡检

开局、每个单元开工前、规则或 skill 升级后、说法冲突时，跑一次：

python3 scripts/check_project.py --project <项目根> [--require 已定设定表.md 进度摘要.md] [--out 00_项目/巡检.md]

查：台账在不在、有没有优先序、每条有编号和合法状态、“已替代”指向存在的编号、现行条有原话；00_项目/ 下的关键文件缺失（提醒）或 0 字节（问题）；文件不是 UTF-8（问题）。退出码 0 无问题，1 有问题，2 参数错。规则内容有没有互相矛盾，脚本查不了，要读文件判断，并写明读了哪个文件哪一行。

10. 规则进化

做完一个单元、开下一个之前，回看一次：

1. 回看：人在停点的回退和意见、备忘新增条目、返工原因、花费。
2. 先记：现象、原因、下次怎么做，记进经验文件。只出现一次的标“待验证”。
3. 够条件才改规则：同一问题出现两次；或人明确说要这样；或“待验证”项有了结果。三者满足其一才改。改的时候删掉被取代的旧写法，不只往后堆。
4. 这些先问人：停点、费用和重试上限、交付格式、人定过的要求、风格基调。
5. 不在单元中途改规则、换版本；不为了验证规则专门花钱；不回头改已经采用的产物。

11. 不做

• 不把对话里的“已完成”“已确认”当事实，以文件和人的原话为准。
• 不维护和文件夹重复的状态文件。
• 不替人写“已确认 / 已批准”。
• 不把一次性的做法概括成长期规则。