用途:扫描仓库中的大源码文件,判断是否值得拆分,并输出重构计划。
主要能力:按代码行数阈值发现候选文件(测试文件阈值为2000 LOC),默认跳过生成、第三方依赖与构建产物路径,可用 --include-generated 纳入。生成 Markdown 表格作为完整报告,按内聚、耦合、归属与变更风险排序拆分价值,仅对最大的3个文件(用户另行指定除外)给出计划。
使用方式:从目标仓库运行 helper: uv run "<skill-dir>/scripts/large-file-refactor.py" [path] [--include-generated] path 可选,默认当前工作目录。随后用可用的语义符号/引用工具(优先 Serena)检查符号概览、引用、导入与相关历史,据此确定提取边界、目标模块名、迁移顺序与测试覆盖。
计划内容:每个文件含当前职责、语义检查步骤、2-5个目标模块、迁移顺序与验证方式,并以判定开头(拆分合理/保持完整/生成代码应改生成器)。
限制:文件大小匹配只是候选而非拆分依据;不得仅为减少行数而拆分;不执行重构,除非用户另行要求;使用便携式 LOC 估算而非 tokei 时需说明。