一个仓库,一颗星,没有 README。里面却藏着这套系统的 Fermi 估算:默认目录里的 skill 数 × 每次会话 = 你预付的上下文税。装五十个 skill 的人,每次开机先交一遍五十份的过路费,不管今天用不用。
这个人把 skill 写成了带签名的函数:input1 是什么文件、processing 用哪个 skill、output1 是什么,全摆在门口。连"这个输出改的是哪个输入"都要登记。出了问题可以指着签名说哪一格断了——大多数人的 skill 是一段随笔,坏了连案发现场都没有。
最讲究的一个规矩:架构决策文档只许写期望的终态,文件名就叫 desired__structure.md。作者的理由值得抄下来——proposed 会诱人写对比,而对比是最先腐烂的部分;plan 模棱两可。名字叫 desired 的文件,想写"过去是什么样"时,文件名先说不。还有那句:讲道理的答案,就是穿了好看衣服的猜测。查了原仓库,这句话真的在 _meta/decisions.md 里,一个字不差。
下一根钉子:签名约束了输入输出,约束不了语义漂移。skill 的"返回类型"可以声明,"返回质量"谁来查?