crowi-migration

Crowi 迁移技能提供了一套结构化、由 AI 代理驱动的工作流程，旨在将旧版 Crowi 应用程序重构为现代化的技术堆栈。它专为管理从旧版 Express 与 Swig 模板架构过渡到包含 Next.js 16、Fastify v5 与 ts-rest 等高性能、类型安全堆栈的开发人员与维护者而设计。此技能利用模块化的子代理系统（包含规划、实现、审查与提交代理），确保 Wiki 系统的每个组件都能在不破坏核心功能的情况下进行系统性的转型。

• 将旧版 Express 路由自动转换为带有严格 ts-rest API 契约的 Fastify 控制器。

• 将 Swig HTML 模板系统化地转换为具备 Next.js 16 App Directory 结构的模块化 React 19 组件。

• 通过 .migration-state 文件进行集成任务管理，追踪 PLANNED、IN_PROGRESS、REVIEW、APPROVED 与 COMMITTED 等不同阶段的进度。

• 内置安全验证钩子，在重构过程中阻止危险的操作指令。

• 支持 Turborepo 单体仓库架构，利用 TypeScript 5.x 与共享包确保类型安全性。

• 适用于处理旧代码重构至现代架构的核心贡献者与迁移工程师。

• 输入需求包含对旧版 lib/routes、lib/views 与 lib/models 目录的访问权限。

• 输出内容为重构后的 TypeScript 代码文件、更新后的 api-contract 定义，以及遵循定义迁移模式的 Pull Request。

• 限制：迁移过程假设环境为 Node.js 22.x，并需严格遵守包含 ts-rest 接口在内的定义架构。

• 操作建议：使用 /migrate task-name 指令启动工作流程；在执行前请确认 .migration-state/queue.json 设置正确。

• 非常适合将旧版 MongoDB/Mongoose 模型转换并集成至新的 Fastify/ts-rest 后端，同时维持与现有数据层的兼容性。