Write Clear Code Comments 今日发布

解决代码注释随时间腐化、掩盖真实设计意图这一常见问题的实用技能。由 EIS-ITS 团队开发，已通过 Skillstore 安全审计，确认零风险。

劣质注释是代码维护中的隐形杀手——注释没有随代码变更而更新，反而用过时信息误导后续阅读者。该技能教会 AI 编程助手有策略地添加注释：仅在注释能传递代码本身无法表达的意图、权衡和复杂逻辑时才写注释，而不是简单复述代码在做什么。

主要能力包括：指导何时应添加注释而非直接改进变量命名或代码结构；鼓励注释解释意图、权衡取舍和复杂算法；支持函数文档字符串、API 说明、类接口注释等多种形式；帮助审查并删除过时、临时或变更记录类注释；适用于所有编程语言和源代码文件。

适用场景：为复杂业务规则和算法添加注释；在代码审查中判断新增注释是否真正解释意图；将过时注释替换为持久性解释；建立团队统一的注释标准。