工作流：一部作品从计划到 done

生命周期

planned ──▶ drafting ──▶ verifying ──▶ review ──▶ done
  │            │              │            │
  │            │              │            └─ reviewer 打分 ≥12/14
  │            │              └─ source-verifier 把定位升到 L1/L2
  │            └─ close-reader 写 01–05
  └─ curator 建目录、写论点假设、开研究问题

每次推进都要改 README.md 的 status 与 updated，否则 make check 会提醒。

七个步骤

1. 立卡（curator）

make new-work ARGS="kafka the-trial --title 审判 --year 1925"

生成目录与七个文件骨架（planned 状态只有 README）。在 README 里写：

## 论点：一句话，可被反驳
## 研究问题：2–4 个能在文本里找到证据的问题
## 状态：当前档位 + 下一手交给谁

2. 定位（curator + source-verifier）

确认版本：初版/修订/全集、译者、是否删节。写进 sources/bibliography.yaml 与 06-context.md「版本」。
没有确定版本前不许开始引文——否则引的可能是另一个译本。

3. 精读（close-reader）

按 docs/methodology/close-reading-protocol.md 三遍读法。产物：01–05。

摘录（05）默认要做到 excerpt_target: 20，并按章节配额继续扩：

make quotes ARGS="--author wang-xiaobo"   # 看现有条目

扩的时候先补 R-（定位 + 机制想清楚），拿到书再批量把 R- 升成 Q-——这比“等有书再开始”高效得多。

make promote ARGS="R-KAFKA-TRIAL-014 --text '原文粘贴' --page 213 --confidence 高"
make promote ARGS="--from-file paste.md"   # 批量

promote 会分配新序号、拼好解析、刷新目录与 INDEX；核：中 表示句子主体确定但个别字词待核，核：低 不存在（那只能留在 R-）。

4. 核校（source-verifier）

逐条过 05-excerpts.md 的 定位： 行：能升 L1 的升，升不了的写明原因。产出待核清单放进 06-context.md「出处」。

5. 收口（close-reader）

写 06-context.md：版本、位置（在作家作品序列中的坐标）、影响与争议（标 [二手]）。

6. 文体（style-editor）

按 docs/agents/writing-voice（见 AGENTS.md 第 6 节）通读：删空词、拆长句、补“我不确定”、删金句结尾。

7. 验收（reviewer）

make check
make stats

按 docs/methodology/quality-rubric.md 打分，写 P0/P1/P2。过线后 status: done，重跑 make index。

新增一位作家要动哪些文件

make new-author ARGS=“slug --name 中文名 --name-en 'Latin Name' --born 1900 --died 1970 --order 11”
填 author.md 五个小节（选择理由必须给具体文本证据）
sources/bibliography.yaml 加该作家条目（kind: primary）
至少建一个作品目录（步骤 1）
make index，然后 make check

退选也要留痕：删除作家目录前，把退选理由写进 docs/charter.md 的选择记录，再删。

常见错误

现象	原因	处理
`check` 报 INDEX 过期	改了 front matter 没重跑 index	`make index`
引文块报“定位格式不符”	`- 定位：` 行缺 `《书名》` 或 `L1/L2` 标记	照 `05-excerpts.md` 模板改
字数不足	只写了结论没写机制	回文本找证据，不是加形容词
引文占比超限	用原文代替分析	砍引文，扩解析
状态卡在 verifying	页码核不了	允许停在 L2，但必须在 `06-context.md` 写明原因

提交

git add -A
git commit -m "kafka/the-trial: 补第九章守门人寓言的 L2 定位"

一次提交只做一件事。CI 跑 make check + 单元测试，红了不许合并。