跨项目设计范式

从一堆互不相干的开源项目里,反复浮现出同一批骨架。这五条是它们共同的答案——每一条都能直接搬走用,不必先读那 29 张卡片。

为什么要把它们单独拎出来

单张卡片回答"这一个项目好不好用";范式回答"这一类问题别人是怎么解的"。

后者更值钱,因为它可迁移:你在自研工具时踩的坑,几乎都能在上面某个项目的历史里找到现成答案。本库每收录一批,就把新浮现的公共骨架沉淀到这里,形成一条不断加粗的规律线。

1. 先固化上下文,再动手

是什么:在让模型干任何活之前,先把「术语、风格、约束、禁区」写成一份被反复引用的固定文件,而不是每次对话临时交代。

证据:mattpocock/skills 的共享语言 GLOSSARY.md、marketingskills 的 product-marketing-context,是同一个套路——把上下文从"每次说一遍"变成"一次写死、处处引用"。

对你的用处:这是本库对 TextFlow 价值最高的一条。统一术语能实打实降 token、稳输出,尤其治本地小模型"散漫、跑偏"的毛病。

2. 结论要可核验

是什么:不要只给结论,要给证据链——它凭什么这么说、哪里没搞定。

证据:rea 的「证据契约」(交回伪代码时,连同指令、调用者、常量,以及它没能解析的部分);headroom 的 CCR(压缩-缓存-取回);SkillSpector 输出 SARIF。三者都在回答同一个问题:"凭什么信你?"

对你的用处:可直接固化为 TextFlow 节点的输出契约——每个节点产出都拆成「我看到的 / 我推断的 / 我没能搞定的」三部分。

3. 交付可继续改的产物,而非终点文件

是什么:不要把用户锁死在一个"成品"里,要交出能二次编辑的中间物。

证据:video-shotcraft 给的是 Remotion 工程 + 浏览器剪辑台,不是一段 mp4;OpenMontage 给的是流水线与审批门,不是一键成片。

对你的用处:比"一键出成品"更贴近真实生产——漫剧要反复调画面,你要能改,不是重做。

4. 约束先行 + 闸门过审

是什么:把约束放在生成之前,把闸门放在入账之前。

证据:webnovel-writer 的「合同链」(先定合同,再写正文);novel-studio 的「只有过审正文才进正史」(草稿与正史隔离)。

对你的用处:正是 TextFlow 节点产出契约该抄的结构——生成前先锁约束,落库前先过审。

5. 门槛也是设计对象

是什么:同一项能力,有没有"一键安装包 / 图形界面",决定了它能不能被普通人用上。

证据:本库 020–029 这批是最好的对照实验——Jan / Buzz / LosslessCut 与 GPT4All / Fooocus 的差别不在技术,在交付门槛:前者下载即用,后者要配环境。

对你的用处:对 TextFlow 的启示是——节点能力再强,也要有"非技术用户能点开"的入口;门槛从 L4 降到 L1,用户规模不是一个量级。


一句话:好的开源项目,最后会长成同一个样子——上下文固化、结论可查、产物可改、闸门前置、门槛下探。这五条,是本库 29 份卡片真正的产出。