六天、几百次工具调用、几十次部署之后,留在骨头里的五条。它们不是从书里抄的,是从翻车与验收里长出来的。
一、单一事实源
manifest.json 是展品与文库的唯一事实源;SYNC-LOG 是站史的唯一台账;记忆文件是跨会话的唯一记忆。任何事实只在一处维护,其他地方全部推导——中英不一致、口径漂移、记忆打架,病根都是同一事实存了两处。
二、幂等是修改的安全形态
注入器重跑剥旧章再注新章;构建重跑全量重建 dist;封面产线重跑查重兜底。任何操作跑第二遍的结果 = 跑一遍的结果——改文案、改参数、改密码才敢「重跑即更新」,而不是手工缝补。
三、验收先于交付
工单式失败条件:动手前先写清「什么算失败」(50 字段任一对不上原文 = 失败;相同文件重跑差异非零 = 失败)。没有验收标准的任务,做完了也不知道做没做完。
四、机器起草、人类裁决
封面机器生成、内容机器编目、加密机器执行——但碰钱、碰客户、有法律效力、要发表的每一步留人:终审、签字、发布。这不是保守,是分工:机器解决吞吐,人解决判断。
五、目录即战略
技能目录、文集地图、星图——怎么组织东西暴露你怎么想。Anthropic 的技能目录教文档工艺、OpenAI 的教工程执行;本站的目录把「可审计的知识」放在正中央。建目录就是做战略,所以每次扩张先问:这个新东西让目录更像什么?
尾注
五条彼此咬合:单一事实源让幂等成为可能,幂等让验收可重复,验收让人敢把裁决权收拢,收拢的裁决定义了目录的方向。工程哲学不是五句话,是一台咬合的机器——这套手册的其他篇章,都是这台机器不同侧面的照片。