用途:当当前分支的改动中出现明显由大语言模型生成的、影响可读性与可维护性的代码模式时,使用该工作流进行清理。
常见冗余特征:逐字复述下一行的注释;仅包装重抛、无其他处理的 try/except Exception;类型系统已排除的输入校验;只被调用一次的“辅助”函数;私有函数上的多段文档字符串;绑定对话上下文的注释(如“Added for issue #N”“Used by foo”);不可达的防御分支(如非 Optional 构造后仍判断 config is not None)。
使用方式:先列出改动文件:git diff origin/main...HEAD --name-only。对每个非平凡文件阅读 diff 并查找上述特征,做最小化删除,保留所有可观察行为,然后对每个涉及模块重跑针对性测试。
限制:不要删除系统边界(HTTP、子进程、文件 IO)处真正的错误处理;不要删除解释非显而易见 WHY 的注释;若不确定,保留并在报告中提出删除建议。
最终报告应包含:改动文件、移除的冗余类别(每类一行)、运行的测试及结果、未应用的删除建议。