用途:Clean Code 提供实用而非教条的重构模式与编码标准,帮助识别并修复代码坏味道,提升可读性与可维护性。
主要能力:识别常见坏味道,包括函数过长(超过30行)、嵌套过深(超过3层)、魔法数字或字符串、重复代码、死代码。提倡用命名函数替代注释说明意图,用早返回与守卫子句降低嵌套,将魔法值提取为命名常量,复制粘贴3次以上再抽取,删除死代码并依靠 Git 历史找回。SOLID 原则的实用版本:单一职责要求函数只做一件事、模块只处理一个关注点;开闭原则主张用新代码扩展而非修改可用代码,可用组合、接口或策略模式;里氏替换要求子类型在父类型适用处可用,不应覆盖方法抛出未实现;接口隔离主张小而专注的接口;依赖倒置要求依赖抽象并传入依赖而非内部创建。
使用方式:用 grep 与 awk 统计函数分布以定位长函数;用 grep 查找 data、temp、result、info、stuff 等含糊变量名;用 npx ts-unused-exports tsconfig.json 查找未使用导出;用 grep 循环粗略检测可能未使用的函数;用早返回、查找表或基于类型的多态简化条件。命名约定:函数用动词加名词(getUser、validateEmail、parseResponse),布尔值用 is/has/should 前缀(isActive、hasPermission),集合用复数(users、orderItems),避免无具体含义的 handle、process、manage。
适用场景:适合日常重构、代码审查与团队编码规范制定。
限制:该技能明确以务实优先,认为三行相似代码优于过早抽象;建议每次小步重构并运行测试,测试失败说明改变了行为而非结构;注释应解释“为什么”而非“什么”。资料未提供具体平台支持范围、安装方式、价格或效果数据。