用途:这是一个面向 Python 代码质量的技能,适用于编写、修复、编辑或审查代码时,按照 Clean Code 核心原则进行约束与检查。
主要能力:涵盖若干关键规则,包括 G5(DRY,每条知识只保留一处权威表示)、G16(避免晦涩意图,宁可直白不要炫技)、G23(优先用多态替代 if/else 条件分支)、G25(用命名常量替代魔法数字)、G30(函数只做一件事)、G36(得墨忒耳法则,避免层层穿透调用)。同时提供一份审查清单,用于核对 AI 生成代码是否满足:无重复、意图清晰且无魔法数字、以多态替代条件、函数单一职责、无得墨忒耳法则违规、处理边界条件、移除死代码。
使用方式:在编写或审查 Python 代码时应用上述规则与清单。资料中的示例代码展示了重复税率改为 TAX_RATES 字典、用 pack_coordinates 替代位运算、将按员工类型分支改为各类多态方法、用 SECONDS_PER_DAY 替代 86400、以及用 context.get_scratch_dir() 替代多层属性访问等做法。资料未提供具体安装命令或调用接口,暂未提供。
适用场景:Python 项目的代码编写、重构与代码审查,尤其是需要统一质量标准和提升可读性时。
限制:资料仅给出原则、示例与清单,未说明支持的 Python 版本、工具集成方式、配置项、性能影响或收费信息,这些内容暂未提供。