docs: 清理账本第一版设计留下的文档残留;任务书 03 加清理清单
WORK_LOG、结构.md 来源说明里"12 种记录""900–1400 行"已过时。任务书 03 新增"先清理第一版留下的东西":列明要删的文件、函数、测试、注释,并要求用搜索结果证明清干净。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
+16
-2
@@ -14,7 +14,21 @@
|
||||
- 恢复时只核对、不重做写入(CLAUDE.md"中断后怎么恢复"),所以记录照写就是,不需要通用的去重。只在方法要求"只能有一次"的地方加唯一约束。
|
||||
- Jev 是一个判别器,和程序检查地位相同,不单独成一种记录。
|
||||
|
||||
已经写好的代码里,存储、禁改触发器、提交内容检查、作者自评拆成封存,都还用得上。可见性、截止序号、通用唯一键和重复写入的处理、Jev 记录,以及第一版之后加出来的写入前提检查,按这一版删掉或改写。
|
||||
已经写好的代码里,存储、禁改触发器、提交内容检查、作者自评拆成封存,都还用得上。
|
||||
|
||||
### 先清理第一版留下的东西
|
||||
|
||||
第一版的设计已经作废,按它写出来的代码、测试、注释、文档都要清掉,不留"以后也许用得上"的部分。改完要读起来像一开始就按这一版写的(CLAUDE.md"怎么改一份文件"):
|
||||
|
||||
- `src/ledger/visibility.ts` 和 `tests/ledger-visibility.test.ts`:整个删掉。
|
||||
- `snapshot`、`Viewer`、截止序号:从代码、导出和测试里删掉。
|
||||
- 通用唯一键(`keyOf`、`joinKey` 一类)、"同样内容重写当作已经写过"的处理和它的测试:删掉,只留第一部分说的三处唯一约束。
|
||||
- `jev` 这种记录:删掉,改为写进"退回"和"决定"的内容里。
|
||||
- 第一版之后加出来、不在第三部分四种里的写入前提检查:删掉,测试一并删掉。
|
||||
- 注释里提到快照、截止序号、可见性、"同内容重写"的地方:按这一版改写或删掉。
|
||||
- `docs/结构.md` 第八部分你写的 ledger 那一段:按这一版重写。
|
||||
|
||||
清完以后,在 `src/ledger/`、`tests/`、`docs/` 里搜 `snapshot`、`cutoff`、`Viewer`、`visib`、`keyOf`、"快照"、"截止"、"当作已经写过",除了这份任务书和结构.md 开头的来源说明,应该一处都搜不到。把搜索命令和结果写进报告。
|
||||
|
||||
## 开工前先读
|
||||
|
||||
@@ -165,7 +179,7 @@
|
||||
1. 提交号,新增文件列表,每个文件的行数,ledger 的总行数。
|
||||
2. `npm run check` 和 `npm test` 的完整输出。
|
||||
3. 最终的记录种类表:每种存什么,谁会写它。
|
||||
4. 按这一版删掉了第一版里的哪些东西。
|
||||
4. 按这一版删掉了第一版里的哪些东西,以及"先清理第一版留下的东西"那一节最后的搜索命令和结果。
|
||||
5. 独立审阅提出的问题,以及每条怎么处理的(修了的附测试名,没修的写"不写会怎样"的答案)。
|
||||
6. 你和这份任务书、结构.md、方法.md 不一致的地方,以及为什么。
|
||||
7. **规则不清楚的地方**:读 CLAUDE.md、结构.md、方法.md 时,哪里让你犹豫、哪里两份文件说法不一致、哪里你是靠猜的。没有就写"没有"。
|
||||
|
||||
Reference in New Issue
Block a user