用途:在修复、编辑、更改、调试或处理任意 Python 代码时应用“童子军规则”(The Boy Scout Rule),即“离开营地时要比来时更干净”,对应 Robert C. Martin 在 Clean Code 中提出的“签入模块时要比签出时更干净”。核心理念是不必让每个模块完美,只需让它比接手时好一点,从而使系统随演化逐渐变好、团队整体关心系统、阻止软件持续劣化。
主要能力:每次触碰代码时寻找至少一处小改进。可立即完成的快速改进包括:重命名命名不佳的变量(触发 clean-names)、删除冗余注释(触发 clean-comments)、移除死代码或未使用的导入、用命名常量替换魔法数字、把深层嵌套块提取为命名良好的函数。时间允许时做的更深改进包括:拆分做多件事的函数(触发 clean-functions)、消除重复(DRY,触发 clean-general)、补充缺失的边界检查、提高测试覆盖率(触发 clean-tests)。
技能编排:该技能会根据任务类型协调专用技能,如编写/审查任意 Python 触发 python-clean-code(主技能),命名变量、函数、类触发 clean-names,编写或编辑注释触发 clean-comments,创建或重构函数触发 clean-functions,审查代码质量触发 clean-general,编写或审查测试触发 clean-tests。
AI 行为:处理代码时先完成被请求的任务,再识别至少一处小清理机会,应用相应专用技能,并注明所做的改进(例如“同时清理:将 x 重命名为 results 以提高清晰度”)。审查代码时加载 python-clean-code 做完整规则检查,按规则编号标记违规,建议渐进式改进而非整体重写。
心态与限制:不要留下比接手时更差的代码,不要说“那不是我的代码”,不要等待专门的重构冲刺,不要做与任务无关的大规模改动;要做到每次提交都做一处小改进,看到问题就修,即使不是自己造成的,让改动与任务成比例,留下质量改进的痕迹。具体安装命令、收费与平台信息暂未提供。