用途:该技能负责“结构”层面的事务,包括文件夹与模块边界、文件放置位置,以及安全移动代码的机制。它不负责代码级重构(如提取函数/类、重命名符号、去重逻辑、重新设计 API),也不负责发现代码问题(重复服务、死代码等应交给代码库审计)。
主要能力:提供设计新项目布局或迁移目标布局的规范;提供既有项目重构的完整工作流:盘点 → 目标 → 映射表 → 审批门 → 分阶段执行;提供安全移动机制,包括 git mv 与历史保留、各生态系统的导入修复、兼容层,以及“静默破坏者”排查(Dockerfile、CI 路径过滤器、CODEOWNERS、点分路径字符串等)。还包含拆分超大文件的规范,以及 JavaScript/TypeScript、Python、Go、Monorepo 等栈的具体布局参考。
使用方式:提出或移动任何内容前先阅读“不可协商项”。设计布局时打开 references/00-structure-principles.md 及对应栈文件(10–13);重构既有项目时按 references/01-restructure-workflow.md 端到端执行,并在执行期间保持 references/02-safe-moves-mechanics.md 打开;回答“这个文件放哪里”时使用决策树。
适用场景:新项目布局设计、既有代码库结构重构、判断是否值得重构、选择按功能还是按层组织、Monorepo 拆分与合并、拆分巨型文件、移动后 CI/Docker/生产环境故障排查。
限制:代码级重构、查找代码问题、NestJS 具体布局分别由其他技能负责;仓库既有健康约定优先于默认规范;框架文件约定(如 Next.js app/、Django apps、pytest 发现机制)是硬约束,需按仓库版本核对文档;无可用构建/测试命令时应先建立验证信号;功能开发中或大量开放 PR 触及该区域时应推迟重构。