用途：修复代码结构组织问题，包括函数复杂度过高、单文件过大、目录嵌套过深以及 barrel 文件导出异常，使代码更易理解、测试与维护。
主要能力与优先处理顺序：高复杂度（P1）、超过350行的大文件（P2）、超过5层的深目录嵌套（P3）、barrel 文件问题（P3）。
高复杂度：通过 ESLint 复杂度规则或人工审查识别分支繁多的函数；可用策略模式配合提前返回、提取函数并加卫语句、查找表、多态等手法降低复杂度。
大文件：按职责拆分到 types.ts、constants.ts、validation.ts、transform.ts、api.ts、service.ts、utils/ 等；文件行数参考标准为100–200行理想、200–350行可接受、350–500行需审查、500行以上必须拆分。
深嵌套：从 src/ 起最多4层，用描述性复合名称替代过深分类，按功能而非技术分层组织，并用 barrel 文件简化导入。
Barrel 文件：为导出添加验证测试，检查预期函数已导出且内部工具未导出；对冗长的再导出列表按类型、服务、工具等分组并加注释。
其他：重复代码可提取共享函数（如统一的 hook 运行器）；多重重载且行为不同的函数建议拆分为命名清晰的独立函数，仅在真正多态或需兼容第三方 API 等场景保留重载。
使用方式：可用脚本分析组织情况 node scripts/analyze-organization.js /path/to/src；查找大文件 node scripts/find-large-files.js /path/to/src --max-lines 350；检查目录深度 node scripts/check-depth.js /path/to/src --max-depth 5。重构前确认职责边界、共享状态与副作用，规划新结构，更新依赖导入与 barrel 导出，每次提取后运行测试，公开 API 变化时更新文档。
限制：未提供具体测试命令、安装步骤及适用范围；各脚本的运行环境与依赖暂未提供。