用途:techdebt 是技术债清理专用技能,针对近期代码改动分析并移除冗余、重复代码,同时保证代码通过 linter 与格式化检查。
主要能力:识别未使用导入、未使用变量或参数、死代码、被注释掉的代码块、不再需要的兼容层、被立即覆盖的赋值;发现可提取为辅助函数的复制粘贴逻辑、可合并的重复模式、重复类型定义或常量;处理过于复杂的条件、可扁平化的嵌套、魔法数字或字符串、命名不一致、缺少类型提示等问题。
使用方式:先用 sl status、sl diff --stat 查找改动文件;若无未提交改动,则用 sl log 查找带 [torchrec] 标签的近期提交。分析后先向用户展示按高、中、低优先级分类的问题摘要并请求确认,再应用修复。随后按文件类型运行 arc lint -a <changed_files> 或 arc lint,Python 文件再运行 arc pyre check-changed-targets,最后复跑 linter 并汇总改动。
适用场景:TorchRec 仓库中近期改动的清理与质量把关。支持参数:文件路径可限定分析范围;lint-only 跳过分析只跑 linter;analyze-only 只展示分析不改动。
限制:不改变代码行为或语义,不新增功能,不添加过多文档或注释,改动保持最小;除非提取辅助模块明显有益,否则不新建文件;必须保留现有测试;重大改动前须获用户确认。优先处理近期改动代码,其次相邻代码。