立论
三层法 Three layers of law
项目一变老,指令就开始堆积、彼此冲突:最初的规格、后来推翻它的重构、陈旧的记忆、上一个智能体的交接、你此刻的要求、刚跑出的与交接说法不符的测试结果。扁平的系统提示词让模型靠猜来化解;Codewhale 用一部嵌套的宪章给出明确的位阶。顺序由执行框架强制生效——有测试断言它不会漂移——换掉模型,结构依然完好。
自 v0.9.0 起
宪章优先的初始设置——首次启动依次引导语言、模型、权限和你的宪章;之后随时 /setup。模型可以起草,由你批准。
位阶,从最稳到最活
三层之下依次是项目说明(AGENTS.md)、记忆与交接。你此刻的要求和实时工具证据仍然主宰当前回合——模型可以被给到很多层,但它被要求不去报告工具没有返回的事实。
内置宪章
基础法。其中的位阶条款为一切冲突固定裁决顺序——过期的交接不会稀里糊涂地压过刚跑出的测试结果。
/constitution——你的常备法
结构化数据,不是裸的提示词编辑器:引导式设置把它渲染成面向模型的 prose 区块。可由模型协助起草,经你批准生效,跨项目随身携带。
仓库自己的法
受保护的不变量、分支策略、验证要求、升级条件——作为仓库本地的权威区块加载,位阶高于项目说明、记忆与交接。
诚实的边界
审批、沙箱、网络与信任控制由代码强制执行——宪章文本永远越不过它们。
在推理里可以被看到
位阶会体现在模型的推理里:它在裁决时直接援引条款。下面是示意,概括了这类推理的样子,并非某一次会话的逐字记录。
Per Article II (truth) and V (verification), I report what's actually in the tree — not what the previous agent claimed.
Article II · TruthArticle V · Verification
如实报告了总结遗漏的未提交改动,而不是照搬旧说法。
The user's current request outranks the runtime statute — so I keep executing the task, not stopping on a technicality.
Article III · User agencyArticle VII · Hierarchy
完成了用户真正要求的工作。
Deleting community credit would break the project's own ethos. Relocate it instead — zero names lost.
Community ethos
把 200 行贡献记录迁到 docs/CONTRIBUTORS.md,并在 README 中给出链接。