self-documenting

将注释和文档保持在不可避免的最低限度，使代码成为唯一的真相来源。注释仅回答“为什么”，最多三行；文档记录决策和架构，绝不描述系统如何工作；CLAUDE.md 和 AGENTS.md 仅包含约定，不记录情境性事实；任何内容均不通过路径、符号或行号指向代码。在编写或编辑代码、注释、文档字符串、README、设计文档、CLAUDE.md、AGENTS.md、规则或技能时，均需遵循此原则，即使请求中未提及文档。

模型生成摘要（rules/v1 · 2026-11-14 21:16）：将注释和文档保持在不可避免的最低限度，使代码成为唯一的真相来源
这是模型对公开材料的总结，不是官方声明，请以原链内容为准。

存档时间线

版本	存档时间	内容哈希	内容
v1	2026-11-14 21:16	ff1b5c56	可取

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本

纠错与举报（发现条目失效、署名有误或涉及侵权？）

提交举报 / 纠错

侵权举报经核验成立后，我们会即时下线该条目并删除已存的内容副本。