no-comments
这是一条面向代码编写、编辑与审核的规则型技能,核心只有一条:不要在你新增或修改的代码行上写注释。技能通过一套从重命名、函数提取、类型建模、结构重构、测试表达到源码外记录的分级阶梯,引导把“想写注释”的冲动转化为让代码自解释的改动。它明确区分机器读取的指令(如 lint 开关、shebang、代码生成标记、法律要求的许可证头等)和普通注释,前者必须原样保留;同时规定不得清理他人已有注释、不得为了规避规则而破坏代码正确性,并把真正的理由放到 PR 描述、提交信息、ADR、wiki 或问题跟踪器中。