用途：扫描代码库中体量过大的源文件与测试文件，找出重构候选，并基于语义证据给出拆分建议，而不是单纯按行数拆分。
主要能力：源文件以 1000 LOC、测试文件以 2000 LOC 为发现阈值；支持指定路径或目录，默认当前工作目录；--include-generated 可纳入默认跳过的生成、vendored、依赖和构建产物路径。脚本会输出 Markdown 表格作为完整报告，并保留全部匹配行。
使用方式：先定位技能目录，再从目标仓库运行 uv run "<skill-dir>/scripts/large-file-refactor.py" [path] [--include-generated]。若已通过斜杠或美元命令注入指令，则直接遵循，不再重复调用。默认只为最大的 3 个文件撰写重构计划，除非用户明确要求其他数量。计划包含当前职责、语义检查、拆分提案（2-5 个目标模块）、迁移顺序与验证方式，并以“拆分合理 / 保持完整 / 生成文件应改生成器”的明确结论开头。可用的语义符号与引用工具中，若安装了 Serena 则优先使用，用以查看符号概览、引用、导入与相关历史。
适用场景：大型单体文件、职责混杂、变更频繁或耦合高的代码；需要先评估再决定是否拆分的情况。
限制：匹配只是候选，不等于应当拆分；表格仅用于体量排序，重构优先级需单独评估。不要仅为减少行数而拆分，应沿用项目既有模块边界与命名。默认仅报告和规划，只有用户已授权或后续批准时才实施。若使用 --include-generated 且文件为生成或 vendored，应改从生成器、schema 或上游源入手。脚本若使用便携式 LOC 估算而非 tokei，需明确报告。