项目重构迁移
业务逻辑基本正确但结构乱了,把项目搬到干净新目录而不是重写。
功能与用途
当项目技术债积到结构性程度——改一个地方要追三五个依赖方——重构往往是唯一出路,但重写代价太高。它的核心原则是:迁移的单位是目录结构和模块边界,不是重写业务逻辑。流程从判断是否适合重构开始,接着建新项目结构、盘出完整功能清单防止遗漏、设计技术架构并做红蓝推演、配置开发规范,最后分阶段构建。
适用场景
- 高技术债项目的架构整改:业务逻辑正确但模块耦合严重时,在新目录建立清晰边界并将代码分层平移。
- 重构前的资产盘点与防遗漏:从现有文档和代码中梳理全量功能状态与优先级,保障新项目功能无缝承接。
- 多阶段迁移与边界红蓝推演:对新架构开展并发与边界推演,配置规范并按依赖层级分阶段构建交付。
适用人群
- 开发者
- 技术负责人
- 独立开发者
使用步骤
- 先确认四个判断条件是否全部满足(技术债是结构性的、业务逻辑大体正确、能接受迁移期、数据可无损迁移)。
- 建立新项目目录结构,写入重构决策记录(为什么重构、哪些直接搬、数据迁移策略、风险评估)。
- 按产品经理视角盘出完整功能清单,逐项标注实现状态(已验证 / 有缺陷 / 开发中 / 规划中 / 废弃)。
- 设计技术架构并做红蓝推演,结果回写到技术框架文档。
- 配置开发规范后分阶段构建。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-13
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
基于已有项目做重构/新建(搬家不重写)的完整流程 Skill。当用户需要从现有混乱项目迁移到干净新项目时激活,引导完成:新项目文件夹 → PM功能清单 → 技术架构+红蓝推演(回写闭环)→ Cursor规范配置 → 分Phase构建。区别于 role-技术架构师(后者设计新技术方案):本 Skill 是迁移型,先盘点已有资产,再设计去哪里放。触发词:「基于已有项目重构」「重构方案」「新建项目并迁移」「搬家不重写」「从零开始但复用现有代码」「项目架构整改」。
使用前准备
- 现有项目的产品定义与开发计划文档
- 可并行运作的新旧项目环境(约 1-2 周迁移期)
- 核心数据可无损迁移的条件
依赖与权限
- 读取用户主动提供的内容