clean-comments

此工具作为原始代码的智能清理助手，旨在通过移除文件中的杂讯来提升维护性。在现代软件开发中，过多或多余的注释会分散开发者对实际逻辑的注意力，且经常会因代码更新而过时。此技能强制执行“代码即文档”的哲学，确保注释仅用于澄清复杂的业务逻辑、边缘案例或非显而易见的架构决策，而非重述简单的语法操作。

本工具特别适合准备 Pull Request、进行团队代码审查或执行存储库重构的工程师。通过分析注释背后的意图，它能选择性地移除显而易见的描述，同时严格保护有价值的上下文，例如效能评估、错误报告引用（如 issue #1234）或关键的迁移警告。它鼓励开发者编写更简洁、具自我说明性的代码，进而减轻阅读存储库人员的认知负荷。

• 自动识别并移除重述代码执行过程的多余内联注释。

• 保留高价值的上下文，包括决策点、复杂算法细节与非直观的实现说明。

• 将冗长的文档区块浓缩为简洁的单行说明，强调“为什么”而非“是什么”。

• 过滤掉已完成任务的过时 TODO 或 FIXME 注释。

• 支持单次处理最多 15 个文件，以确保审查周期可管理且具预测性。

• 建议在预审阶段使用，以确保审查者专注于逻辑而非文档杂讯。

• 应信任可读性高的代码作为主要文档；仅在代码意图无法被新开发者推断时才添加注释。

• 进行简化时，优先解释业务逻辑或架构限制，而非变量命名惯例。

• 本工具设计旨在与现代存储库结构无缝衔接，包括 TypeScript、Python 及其他复杂单体存储库中的常见语言。

• 限制：此过程严格致力于提升清晰度；建议始终检查工具建议，确保团队特定的关键文档未被误删。