用途:这是一条编码实践技能,主张每次触碰文件时都让它比原来好一点点,用持续的小改进替代专门的“清理冲刺”。
主要能力与规则:修复视野内、范围内的明显问题,如把变量 x 改名为 user_count、删除未使用的导入或死代码、补充缺失的类型标注、修正误导性注释、用命名常量替换魔法数字、简化过于复杂的条件、修复编译器或 linter 警告。清理应与功能改动分开提交,便于审查和回滚。
使用方式:应用前若存在 .agents/stack-context.md 应先阅读,并按检测到的技术栈惯用模式执行;框架细节可用 context7 MCP 或网络搜索确认,不要猜测。遇到无法顺手修复的大问题,应建 issue 或加 TODO(工单号)。
不算改进的情况:无功能变化地重写函数风格、全库迁移到新模式、添加功能或改变行为、按另一风格重排文件(应交给自动格式化工具)、在不完全理解时重构陌生代码。
限制与边界:若清理超过约 20 行或跨多个模块,就不属于童子军式改进,应单开工单和评审。共享代码库中小改进通常受欢迎,跨模块大重构需协调;若团队偏好最小 diff,可把清理放进单独 PR。
审查清单:清理是否确实低风险且明显正确、是否与功能分开提交、是否只涉及作者正在改动的代码、回滚清理后功能是否仍完整。相关技能包括 kiss、convention-over-configuration、dry。