代码整洁之道 (Clean Code)

本技能赋能 AI Agent 编写、审查和重构符合 Robert C. Martin (Uncle Bob)《代码整洁之道》原则的代码。其核心目标是提高代码的可读性、可维护性和长期生产力。

核心原则

1. 有意义的命名

• 名副其实：变量、函数或类的名称应说明其存在的意义、功能以及用法。
• 避免误导：避免使用具有特定编程含义的词（如 accountList 除非它真的是 List）。
• 做有意义的区分：避免使用 data1, data2 或 theMessage 这样模糊的命名。
• 使用读得出来的名称：避免使用缩写（如 genymdhms -> generationTimestamp）。
• 使用可搜索的名称：单字母变量仅限用于短小的循环内部。