用途:管理遗留 Node.js 单体(Express/Pug/Mongoose)向现代 Next.js 架构的端到端现代化迁移,采用绿地重写策略。
工作区结构:推荐使用“现代化枢纽”单仓布局,包含 .agents/(技能包)、docs/(集中审计与验证规格)、legacy-app/(源,只读)和 modern-app/(目标绿地仓库)。
主要流程: 第一阶段 AI 审计(逆向工程):派发子代理产出规格,并识别项目专属测试场景写入 Verification_Plan.md。确定数据库策略(沿用遗留库或种子绿地库,默认直连遗留库);若经 Docker 使用遗留库,需在 legacy-app/docker-compose.yml 增加 ports: ["27017:27017"] 并重启服务;用 resources/verification-strategy.md 初始化 docs/verification/Verification_Plan.md;依次运行 auditing-data-models、auditing-api-contracts、auditing-business-logic、auditing-ui-archeology 并追加相应测试。 第二阶段 绿地基础与 TDD:运行 scaffolding-nextjs-foundation 生成基础应用,运行 scaffolding-test-foundation 配置 Vitest,运行 generating-api-tests 把 API_Contracts.md 转为失败的集成测试。 第三阶段 绿地脚手架(让测试通过):运行 scaffolding-data-layer 将模型翻译为原生 MongoDB/Zod 类型,运行 scaffolding-api-routes 实现路由处理器直至测试通过;按数据库策略决定是否运行 generating-database-seeder。 第四阶段 UI 与页面脚手架:运行 scaffolding-ui-and-pages,把 UI_Component_Inventory.md 翻译为 ShadCN 组件并完成 Next.js 页面;严格检查清单中每个路由都有对应 page.tsx。 第五阶段 验证与对抗审计:运行 auditing-parity 做并排运行时检查,运行 adversarial-verification 探测安全与逻辑缺陷,最终完成 Parity_Adversarial_Report.md。
编排要求:确认 legacy-app 与 modern-app 的相对路径,明确告知子代理源码与文档目录位置,在各阶段产物(docs/ 中)完成后再进入实现阶段。
限制:资料未提供具体安装命令、收费、性能指标或平台兼容性信息,暂未提供。