我在Claude Code中使用的一个简单但非常有效的规则是这个"comments[.]md"文件。 它防止Claude在已经自我文档化的代码上写出像"增量计数器"这样的糟糕注释。

在 /.claude/rules/comments.md: --- globs: ["*.ts", "*.tsx", "*.js", "*.jsx", "*.py"] alwaysApply: true description: 评论政策 --- ## 评论政策 ### 不可接受的评论 - 重复代码功能的评论 - 注释掉的代码（删除它） - 明显的评论（"递增计数器"） - 用评论代替良好的命名 ### 原则 代码应该是自文档化的。如果你需要评论来解释代码的功能，考虑重构以使其更清晰。