用途:这是一个语言无关的整洁代码参考技能,基于 Robert Martin 的《Clean Code》及相关著作,用于编写可维护代码,并在代码质量审查、命名规范、重构、代码坏味道、SOLID 原则、可读性与结构改进、单元测试编写与审查等场景中自动激活。
主要能力:提供 SOLID 五项原则速查——单一职责(SRP,一个变更原因)、开闭(OCP,对扩展开放、对修改关闭)、里氏替换(LSP,子类型必须可替换)、接口隔离(ISP,不强制依赖未用方法)、依赖倒置(DIP,依赖抽象而非具体)。同时给出整洁代码实践:有意义命名、函数小而只做一件事且保持单一抽象层级、注释解释原因而非内容、格式一致、以异常替代错误码并快速失败、不返回 null、单元测试遵循 F.I.R.S.T 原则、识别并重构代码坏味道,以及“童子军规则”——每次触碰代码都让它更干净。
使用方式:在代码提交前可按清单自查:命名是否表意、函数是否只做一件事、注释是否解释为什么、是否存在重复逻辑(DRY)、是否遵循 SOLID、是否可测试、错误是否被优雅处理。示例使用通用伪代码,可按目标语言适配:PHP 的 class、function、->、类型提示;JavaScript/TypeScript 的 class、箭头函数、点号;Python 的 class、def、点号、类型提示;Java/C# 可直接映射并使用访问修饰符。
适用场景与限制:适用于任何编程语言的代码审查与重构指导。资料未提供具体安装命令、收费、价格或平台支持信息,暂未提供;技能内容为原则性参考,不构成特定语言或项目的强制规范。