Crowi 2.0 Migration Skill

Crowi 2.0 Migration Skill

アーキテクチャ

crowi/
├── apps/
│   ├── crowi-api/          # Fastify + ts-rest (port 3300)
│   └── crowi-web/          # Next.js 16 (port 3301)
├── packages/
│   ├── api-contract/       # ts-rest 契約定義
│   └── shared/             # 共有型
└── lib/                    # 旧実装（参照元）
    ├── routes/             # Express ルート
    ├── views/              # Swig テンプレート
    └── models/             # Mongoose モデル

移行パターン

Express Route → Fastify + ts-rest

// Before: lib/​routes/​page.js
router.get('/​pages', async (req, res) => {
  const pages = await Page.find();
  res.render('page/​list', { pages });
});

// After: packages/​api-contract/​src/​page.ts
export const pageContract = c.router({
  listPages: {
    method: 'GET',
    path: '/​pages',
    responses: { 200: z.object({ pages: z.array(PageSchema) }) },
  },
});

// After: apps/​crowi-api/​src/​routes/​page.ts
listPages: async () => {
  const pages = await Page.find();
  return { status: 200, body: { pages } };
},

Swig Template → Next.js Page

// Before: lib/​views/​page/​list.html
{% for page in pages %}
  <div>{{ page.path }}</​div>
{% endfor %}

// After: apps/​crowi-web/​app/(main)/​pages/​page.tsx
'use client';
export default function PagesPage() {
  const { data } = useQuery(['pages'], () => client.page.listPages());
  return data?.body.pages.map(page => <div key={page._id}>{page.path}</​div>);
}

サブエージェント

ワークフロー

/​migrate {task-name}

planner → implementer → reviewer ─┬→ committer
                          ↑       │
                          └───────┘ (NEEDS_WORK)

タスク管理

• キュー: .claude/​migration-state/​queue.json
• タスク: .claude/​migration-state/​tasks/​{task-id}.json
• ステータス: PLANNED → REVIEW → APPROVED → COMMITTED

技術スタック

• API: Fastify v5, ts-rest, MongoDB/​Mongoose, JWT
• Web: Next.js 16, React 19, Tailwind v4, shadcn/​ui
• 共通: TypeScript 5.x strict, pnpm, Turborepo

Crowi テーマ

--crowi-primary: #43676b;
--crowi-header: #263a3c;
--crowi-sidebar: #f8f9fa;