cmx-sdk 0.2.9 → 0.2.10

package/templates/claude/skills/cmx-migrate/references/html-to-mdx.md

@@ -1,99 +0,0 @@
-# HTML → MDX 変換ルール
-
-子エージェントがコンテンツ変換時に参照するルール。
-
-## 基本変換テーブル
-
-| HTML | MDX |
-|------|-----|
-| `<h1>` | `# `（通常はtitleフィールドに抽出、本文には含めない） |
-| `<h2>` | `## ` |
-| `<h3>` | `### ` |
-| `<h4>` | `#### ` |
-| `<p>` | そのまま（タグ除去、前後に空行） |
-| `<strong>`, `<b>` | `**テキスト**` |
-| `<em>`, `<i>` | `*テキスト*` |
-| `<a href="url">` | `[テキスト](url)` |
-| `<ul><li>` | `- テキスト` |
-| `<ol><li>` | `1. テキスト` |
-| `<blockquote>` | `> テキスト` |
-| `<code>` | `` `テキスト` `` |
-| `<pre><code>` | ` ```lang\nコード\n``` ` |
-| `<img src="url" alt="text">` | `![text](url)` |
-| `<table>` | Markdown テーブル |
-| `<hr>` | `---` |
-| `<br>` | 改行（`\n`） |
-
-## 除去するもの
-
-- `<script>` タグとその中身
-- `<style>` タグとその中身
-- `<iframe>` タグ（広告、埋め込み等）
-- `<nav>` タグ（ナビゲーション）
-- `<header>` タグ（サイト共通ヘッダー）
-- `<footer>` タグ（サイト共通フッター）
-- `<aside>` タグ（サイドバー）
-- `class` 属性、`id` 属性、`style` 属性
-- `data-*` 属性
-- コメント `<!-- ... -->`
-- 広告関連の要素
-
-## URL 変換
-
-- 相対URL → 絶対URL に変換
-  - `/images/photo.jpg` → `https://old-site.com/images/photo.jpg`
-- 内部リンクは移行先のパスに変換可能であれば変換
-  - `/blog/post-1` → `/blog/post-1`（パスが同じなら変更不要）
-- 画像は外部URLのまま維持（後で Admin にアップロード可能）
-
-## メタデータ抽出
-
-コンテンツ本文とは別に以下を抽出:
-
-| フィールド | 抽出元 |
-|-----------|-------|
-| title | `<h1>` or `<title>` |
-| description | `<meta name="description">` |
-| slug | URLパスの末尾部分（`/blog/my-post` → `my-post`） |
-| publishedAt | `<time>` or `<meta property="article:published_time">` |
-| thumbnail | `<meta property="og:image">` or 記事内最初の `<img>` |
-
-## slug 生成ルール
-
-- URLパスの末尾セグメントを使用
-  - `https://old-site.com/blog/2024/01/my-article` → `my-article`
-- 日本語URLの場合はローマ字化または英語化
-- 使用可能文字: 英数字、ハイフン
-- 重複チェック: 既存slugと衝突する場合は `-2`, `-3` を付加
-
-## MDXコンポーネント置換
-
-既存サイトのUIパターンがMDXコンポーネントとして定義されている場合、対応するHTMLをコンポーネントに置換する。
-
-```html
-<!-- 移行元 -->
-<div class="feature-card">
-  <span class="icon">✨</span>
-  <h3>高速</h3>
-  <p>パフォーマンスに優れています</p>
-</div>
-```
-
-```mdx
-<!-- 移行後 -->
-<FeatureCard icon="✨" title="高速">
-パフォーマンスに優れています
-</FeatureCard>
-```
-
-ただし、コンポーネント置換は `src/components/custom/index.ts` に export されているもののみ使用可能。
-
-## 品質チェック
-
-変換後のMDXが以下を満たすか確認:
-- Markdownとして正しい構文か
-- 空行が適切に挿入されているか
-- リスト、テーブルのインデントが正しいか
-- コードブロックの言語指定があるか
-- 画像のalt属性が設定されているか
-- 不要なHTMLタグが残っていないか

package/templates/claude/skills/cmx-migrate/references/intermediate-format.md

@@ -1,196 +0,0 @@
-# 中間フォーマット定義
-
-## site-map.json
-
-Step 1（解析）で生成し、Step 2（計画）以降で参照する構造化データ。
-
-```json
-{
-  "sourceUrl": "https://example.com",
-  "analyzedAt": "2026-02-17",
-
-  "navigation": {
-    "primary": [
-      { "label": "ブログ", "href": "/blog" },
-      { "label": "会社概要", "href": "/about" },
-      { "label": "お問い合わせ", "href": "/contact" }
-    ],
-    "footer": [
-      { "label": "プライバシーポリシー", "href": "/privacy" }
-    ]
-  },
-
-  "pageGroups": [
-    {
-      "pattern": "/blog/*",
-      "type": "collection",
-      "suggestedCmxType": "post",
-      "suggestedSlug": "blog",
-      "suggestedName": "ブログ",
-      "listPage": "/blog",
-      "sampleDetailPages": ["/blog/article-1", "/blog/article-2"],
-      "totalCount": 25,
-      "fields": [
-        { "key": "title", "type": "text", "selector": "h1", "required": true },
-        { "key": "date", "type": "date", "selector": "time" },
-        { "key": "category", "type": "relation", "values": ["技術", "デザイン", "ビジネス"] },
-        { "key": "tags", "type": "relation_multi", "values": ["Next.js", "TypeScript", "React"] },
-        { "key": "thumbnail", "type": "image" },
-        { "key": "author", "type": "text" },
-        { "key": "body", "type": "richtext", "selector": "article" }
-      ],
-      "suggestedDataTypes": ["categories", "tags"]
-    },
-    {
-      "pattern": "/news/*",
-      "type": "collection",
-      "suggestedCmxType": "news",
-      "suggestedSlug": "news",
-      "suggestedName": "お知らせ",
-      "listPage": "/news",
-      "sampleDetailPages": ["/news/announcement-1"],
-      "totalCount": 15,
-      "fields": [
-        { "key": "title", "type": "text", "required": true },
-        { "key": "date", "type": "date" },
-        { "key": "category", "type": "relation", "values": ["プレスリリース", "イベント"] },
-        { "key": "body", "type": "richtext" }
-      ],
-      "suggestedDataTypes": ["categories"]
-    },
-    {
-      "pattern": "/about",
-      "type": "static-page",
-      "sections": [
-        { "id": "hero", "description": "ヒーローセクション（キャッチコピー + CTA）" },
-        { "id": "mission", "description": "ミッション・ビジョン" },
-        { "id": "team", "description": "メンバー一覧（カード型、5名）" },
-        { "id": "history", "description": "沿革タイムライン" }
-      ]
-    },
-    {
-      "pattern": "/contact",
-      "type": "form",
-      "fields": [
-        { "key": "name", "type": "text", "label": "お名前", "required": true },
-        { "key": "email", "type": "email", "label": "メールアドレス", "required": true },
-        { "key": "company", "type": "text", "label": "会社名" },
-        { "key": "message", "type": "textarea", "label": "お問い合わせ内容", "required": true }
-      ]
-    },
-    {
-      "pattern": "/faq",
-      "type": "data-type-page",
-      "suggestedSlug": "faq",
-      "description": "アコーディオン型FAQ一覧"
-    }
-  ],
-
-  "dataTypeCandidates": [
-    {
-      "slug": "staff",
-      "name": "スタッフ",
-      "source": "/about セクション #team",
-      "entryCount": 5,
-      "fields": [
-        { "key": "name", "label": "名前", "type": "text", "required": true },
-        { "key": "position", "label": "役職", "type": "text" },
-        { "key": "bio", "label": "自己紹介", "type": "textarea" },
-        { "key": "photo", "label": "写真", "type": "image" }
-      ]
-    },
-    {
-      "slug": "faq",
-      "name": "よくある質問",
-      "source": "/faq ページ",
-      "entryCount": 12,
-      "fields": [
-        { "key": "question", "label": "質問", "type": "text", "required": true },
-        { "key": "answer", "label": "回答", "type": "richtext", "required": true },
-        { "key": "category", "label": "カテゴリ", "type": "select", "options": { "choices": ["一般", "料金", "技術"] } }
-      ]
-    }
-  ],
-
-  "componentCandidates": [
-    {
-      "name": "FeatureCard",
-      "description": "3カラムの特徴紹介カード",
-      "foundAt": ["/", "/about"],
-      "props": [
-        { "name": "icon", "type": "string", "description": "アイコン（絵文字）" },
-        { "name": "title", "type": "string", "description": "タイトル", "required": true },
-        { "name": "children", "type": "string", "description": "説明文", "required": true }
-      ]
-    },
-    {
-      "name": "CTA",
-      "description": "コールトゥアクションバナー",
-      "foundAt": ["/", "/about", "/blog"],
-      "props": [
-        { "name": "title", "type": "string", "required": true },
-        { "name": "description", "type": "string" },
-        { "name": "buttonText", "type": "string", "required": true },
-        { "name": "buttonUrl", "type": "string", "required": true }
-      ]
-    }
-  ],
-
-  "style": {
-    "colors": {
-      "primary": "#2563eb",
-      "secondary": "#64748b",
-      "accent": "#f59e0b",
-      "background": "#ffffff",
-      "text": "#1e293b",
-      "muted": "#f1f5f9"
-    },
-    "fonts": {
-      "heading": "Noto Sans JP, sans-serif",
-      "body": "Noto Sans JP, sans-serif",
-      "code": "JetBrains Mono, monospace"
-    },
-    "fontSizes": {
-      "h1": "2.5rem",
-      "h2": "2rem",
-      "body": "1rem"
-    },
-    "tone": "プロフェッショナル・クリーン",
-    "layoutPattern": "container-centered",
-    "cardStyle": "shadow-sm with rounded corners"
-  }
-}
-```
-
-## migration-plan.json
-
-Step 2（計画）で生成。ユーザーと対話して確定した移行計画。
-
-site-map.json の「提案」をユーザーが承認・修正した「確定版」。
-
-```json
-{
-  "sourceUrl": "https://example.com",
-  "confirmedAt": "2026-02-17",
-  "collections": [...],
-  "dataTypes": [...],
-  "components": [...],
-  "forms": [...],
-  "routes": [...],
-  "style": {...}
-}
-```
-
-`site-map.json` との違い:
-- `pageGroups` → `collections` + `routes` に分解・確定
-- `suggestedCmxType` → `type` に確定
-- `dataTypeCandidates` → `dataTypes` に確定（不要なものは除外済み）
-- `componentCandidates` → `components` に確定（選択されたもののみ）
-
-## build-result.json
-
-Step 3（構築）で生成。SDK コマンドで登録した結果のID一覧。
-
-## content-result.json
-
-Step 4（コンテンツ投入）で生成。各バッチの結果を集約した投入結果。

package/templates/claude/skills/cmx-migrate/references/tool-setup.md

@@ -1,150 +0,0 @@
-# ツールセットアップガイド
-
-## Firecrawl CLI
-
-### インストール
-
-```bash
-npm install -g firecrawl-cli
-```
-
-### APIキー設定
-
-1. https://firecrawl.dev でアカウント作成（無料枠: 500クレジット）
-2. APIキーを取得
-3. `.env.local`（または `.env`）に追加:
-
-```
-FIRECRAWL_API_KEY=fc-your-api-key
-```
-
-4. firecrawl コマンド実行前に環境変数をシェルに読み込む:
-
-```bash
-ENV_FILE=$( [ -f .env.local ] && echo .env.local || echo .env )
-set -a && source "$ENV_FILE" 2>/dev/null && set +a
-```
-
-> **補足**: `firecrawl login --api-key fc-your-api-key` でCLI自体に認証情報を保存する方法もあるが、上記の環境変数読み込みで十分。
-
-### セルフホスト（無料・無制限）
-
-APIクレジットを消費せず使いたい場合:
-
-```bash
-git clone https://github.com/firecrawl/firecrawl.git
-cd firecrawl
-cp .env.example .env
-docker compose up -d
-```
-
-セルフホスト時は `.env.local`（または `.env`）に接続先を指定:
-
-```
-FIRECRAWL_API_URL=http://localhost:3002
-```
-
-### 主要コマンド
-
-```bash
-# サイト内の全URLを発見（コンテンツ取得なし、高速）
-firecrawl map https://example.com --limit 1000 -o urls.json
-
-# サイト全体をクロール（Markdown取得）
-firecrawl crawl https://example.com --limit 200 --max-depth 3 --wait --progress -o crawl-result.json
-
-# 単一ページをスクレイプ（スクショ付き）
-firecrawl scrape https://example.com --format markdown,screenshot -o page.json
-
-# 構造化データ抽出（LLMが解析）
-firecrawl scrape https://example.com/blog --format json --json-prompt "Extract list items with their fields" -o structure.json
-```
-
-### クレジット消費目安
-
-| 操作 | クレジット消費 |
-|------|-------------|
-| map（URL発見） | 1クレジット/リクエスト |
-| scrape（単一ページ） | 1クレジット/ページ |
-| crawl（サイトクロール） | 1クレジット/ページ |
-| extract（構造化抽出） | 5クレジット/リクエスト |
-
-無料枠 500 クレジットで中小サイト（〜200ページ）の移行が1回可能。
-
-## agent-browser
-
-Claude Code に組み込みのスキルとして利用可能。追加インストール不要。
-
-### 主要コマンド
-
-```
-# ページを開く
-open https://example.com
-
-# スクリーンショット撮影
-screenshot output-path.png
-
-# DOMスナップショット（セマンティック構造）
-snapshot
-
-# JavaScript実行
-eval "document.title"
-eval "JSON.stringify(getComputedStyle(document.body))"
-
-# 要素クリック
-click @e5
-
-# テキスト取得
-text @e10
-```
-
-### スタイル情報抽出のパターン
-
-```javascript
-// 主要な CSS 変数/カラーを一括取得
-eval "JSON.stringify({
-  bodyBg: getComputedStyle(document.body).backgroundColor,
-  bodyColor: getComputedStyle(document.body).color,
-  bodyFont: getComputedStyle(document.body).fontFamily,
-  bodyFontSize: getComputedStyle(document.body).fontSize,
-  h1Font: document.querySelector('h1') ? getComputedStyle(document.querySelector('h1')).fontFamily : null,
-  h1Size: document.querySelector('h1') ? getComputedStyle(document.querySelector('h1')).fontSize : null,
-  h1Weight: document.querySelector('h1') ? getComputedStyle(document.querySelector('h1')).fontWeight : null,
-  linkColor: document.querySelector('a') ? getComputedStyle(document.querySelector('a')).color : null,
-  navBg: document.querySelector('nav') ? getComputedStyle(document.querySelector('nav')).backgroundColor : null,
-  footerBg: document.querySelector('footer') ? getComputedStyle(document.querySelector('footer')).backgroundColor : null
-})"
-```
-
-## cmx-sdk CLI
-
-プロジェクト内蔵。`npx cmx-sdk` で実行。
-
-### 移行で使用する主要コマンド
-
-<!-- cmx-sync:start id="skill-cmx-migrate-tool-setup-command-block" -->
-```bash
-# スキーマ登録
-npx cmx-sdk create-collection --json '{...}'
-npx cmx-sdk create-data-type --json '{...}'
-npx cmx-sdk create-data-entry --type-slug staff --json '{...}'
-
-# コード生成
-npx cmx-sdk codegen types
-npx cmx-sdk codegen pages --template layered
-
-# コンテンツ投入
-npx cmx-sdk create-content --collection blog --json '{...}'
-npx cmx-sdk create-content --collection blog --file content.json
-
-# 参照設定
-npx cmx-sdk set-content-references --id {contentId} --json '{...}'
-
-# ステータス変更
-npx cmx-sdk request-review-content --id {contentId}
-npx cmx-sdk publish-content --id {contentId}
-
-# コンポーネント
-npx cmx-sdk components scaffold --name FeatureCard
-```
-<!-- cmx-sync:end -->

package/templates/claude/skills/cmx-schema/SKILL.md

@@ -1,159 +0,0 @@
----
-name: cmx-schema
-description: |
-  CMXのデータタイプ・コレクションのJSON定義を生成し、SDK API 経由で自動登録する。
-  既存サイトのデータ構造をCMXに移行する際のスキーマ変換・定義生成を担う。
-  トリガー: 「スキーマを生成」「データタイプのJSON」「コレクションのJSON」「移行用のスキーマ」
-  「CMXにインポートするJSON」「データ構造を定義」「サイトを移行」「データタイプを作りたい」
-  「コレクションを追加したい」「フィールド定義」「JSON定義」「インポート用JSON」
----
-
-# CMX スキーマ JSON 生成ガイド
-
-既存サイトのデータ構造をCMXに移行するためのJSON定義を生成する。
-生成したJSONは、ユーザーに確認後、SDK API 経由で自動登録する。
-
-## タスク判定
-
-- **フィールドタイプの詳細やオプションを確認** → [references/field-types.md](references/field-types.md)
-- **サイト種別ごとの構成例が必要** → [references/migration-scenarios.md](references/migration-scenarios.md)
-
-## データタイプ JSON
-
-```json
-{
-  "slug": "英数字-ハイフン",
-  "name": "表示名",
-  "description": "説明（任意）",
-  "fields": [
-    {
-      "key": "英数字_アンダースコア",
-      "label": "表示ラベル",
-      "type": "text",
-      "required": true,
-      "description": "ヘルプテキスト（任意）",
-      "options": {}
-    }
-  ]
-}
-```
-
-フィールドの `type` は `text`, `textarea`, `richtext`, `number`, `date`, `datetime`, `boolean`, `select`, `multiselect`, `image`, `file`, `json`, `url`, `email`, `relation` のいずれか。各タイプの `options` 詳細は [references/field-types.md](references/field-types.md) を参照。
-
-## コレクション JSON
-
-```json
-{
-  "type": "post",
-  "slug": "英数字-ハイフン",
-  "name": "表示名",
-  "description": "説明（任意）",
-  "dataTypes": ["categories", "tags"]
-}
-```
-
-`type` の選択:
-
-| type | 用途 | おすすめデータタイプ | フロントマターフィールド |
-|------|------|---------------------|------------------------|
-| `post` | ブログ、コラム（時系列コンテンツ） | カテゴリ、タグ、著者、連載 | title, description, published_at, locale |
-| `page` | 固定ページ（会社概要、サービス紹介） | なし | title, description, locale |
-| `doc` | ドキュメント（ツリー構造、マニュアル） | なし | title, description, order, locale |
-| `news` | ニュース、お知らせ | カテゴリ | title, description, published_at, expires_at, important, locale |
-
-### 付属データタイプ（プリセット）
-
-コレクション作成時に `dataTypes` フィールドでプリセットslugの配列を指定すると、対応するデータタイプが自動作成される。省略時はそのCollectionTypeのデフォルトプリセットが適用される。
-
-利用可能なプリセット:
-
-| slug | 名前 | 選択方式 | デフォルト（post） | デフォルト（news） |
-|------|------|---------|-----------------|-----------------|
-| `categories` | カテゴリ | 単一選択 | ✅ | ✅ |
-| `tags` | タグ | 複数選択 | ✅ | - |
-| `authors` | 著者 | 単一選択 | - | - |
-| `series` | 連載 | 単一選択 | - | - |
-
-プリセット一覧を確認:
-```bash
-npx cmx-sdk list-collection-presets --type post
-```
-
-データタイプ不要（`doc`, `page` 等）の場合は空配列 `"dataTypes": []` を指定。
-
-## 登録手順
-
-### 1. JSON定義の生成
-
-要件に基づいてコレクションまたはデータタイプのJSON定義を生成する。
-
-### 2. 既存データの確認
-
-まず既存のコレクション・データタイプを確認して、重複がないことを確認:
-
-```bash
-npx cmx-sdk list-collections
-npx cmx-sdk list-data-types
-```
-
-### 3. ユーザーへの確認
-
-生成したJSON定義をユーザーに提示し、登録の承認を得る:
-
-```
-以下のスキーマを CMX Admin に登録します:
-
-【コレクション】
-- {name} ({slug}) — type: {type}
-
-【データタイプ】
-- {name} ({slug}) — フィールド数: {n}
-
-重複はありません。
-
-**このまま Admin に登録しますか？**
-（または、JSON を出力して手動で登録することもできます）
-```
-
-### 4. cmx-sdk で登録
-
-承認されたら、`cmx-sdk` コマンドで登録する。
-
-**コレクションの登録（プリセットデータタイプ付き）:**
-```bash
-npx cmx-sdk create-collection --json '{"type":"post","slug":"blog","name":"ブログ","description":"ブログ記事を管理","dataTypes":["categories","tags"]}'
-```
-
-コレクション作成時にプリセットが自動適用され、`blog-categories`、`blog-tags` などのデータタイプが自動作成される。
-
-**コレクションの付属データタイプを後から追加:**
-```bash
-# プリセットから追加
-npx cmx-sdk add-collection-data-type --collection blog --preset authors
-
-# カスタムで追加
-npx cmx-sdk add-collection-data-type --collection blog --json '{"slug":"custom-field","name":"カスタム","referenceType":"single","fields":[{"key":"name","label":"名前","type":"text","required":true}]}'
-```
-
-**グローバルデータタイプの登録:**
-```bash
-# カスタムフィールドで登録（推奨）
-npx cmx-sdk create-data-type --json '{"slug":"products","name":"商品","description":"商品情報","fields":[{"key":"name","label":"名前","type":"text","required":true},{"key":"published","label":"公開","type":"boolean","required":true,"defaultValue":false}]}'
-
-# プリセートを使用する場合（参考例）
-npx cmx-sdk create-data-type --json '{"slug":"staff","name":"スタッフ","presetSlug":"staff"}'
-```
-
-### グローバルプリセット（参考例）
-
-参考として以下のプリセートが用意されていますが、**カスタムフィールドで自由に定義することを推奨**します。
-
-| slug | フィールド例 | 用途例 |
-|------|----------|------|
-| `staff` | name, role, bio, avatar, email, published | スタッフ情報、チームメンバー紹介 |
-| `locations` | name, address, description, latitude, longitude, image, published | 店舗・施設情報、アクセスマップ |
-
-**公開/非公開の制御:**
-- グローバルデータタイプは公開サイトに直接表示されるため、`published` フィールド（boolean）で公開/非公開を制御するのが一般的
-- コレクションに紐付くデータタイプ（categories, tags, authors）はコンテンツの公開ステータスで制御されるため、`published` フィールドは不要
-