cmx-sdk 0.2.9 → 0.2.11

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` フィールドは不要
-

package/templates/claude/skills/cmx-schema/references/field-types.md

@@ -1,164 +0,0 @@
-# フィールドタイプリファレンス
-
-## 一覧
-
-| type | 説明 | options |
-|------|------|---------|
-| `text` | 単行テキスト | `maxLength`, `placeholder` |
-| `textarea` | 複数行テキスト | `maxLength`, `placeholder` |
-| `richtext` | リッチテキストエディタ | - |
-| `number` | 数値 | `min`, `max`, `step` |
-| `date` | 日付 | - |
-| `datetime` | 日時 | - |
-| `boolean` | 真偽値 | - |
-| `select` | ドロップダウン選択 | `choices[]`, `multiple` |
-| `multiselect` | 複数選択 | `choices[]` |
-| `image` | 画像 | - |
-| `file` | ファイル | - |
-| `json` | JSONデータ | - |
-| `url` | URL | - |
-| `email` | メールアドレス | - |
-| `relation` | 他データタイプへの参照 | `targetType` |
-
-## options 詳細
-
-```json
-{
-  "maxLength": 100,
-  "placeholder": "入力してください",
-  "min": 0,
-  "max": 999,
-  "step": 1,
-  "choices": [
-    { "value": "option1", "label": "選択肢1" },
-    { "value": "option2", "label": "選択肢2" }
-  ],
-  "multiple": false,
-  "targetType": "staff"
-}
-```
-
-### text / textarea
-
-- `maxLength` (number) — 最大文字数
-- `placeholder` (string) — プレースホルダーテキスト
-
-### number
-
-- `min` (number) — 最小値
-- `max` (number) — 最大値
-- `step` (number) — ステップ値
-
-### select
-
-- `choices` (array) — `{ "value": "key", "label": "表示名" }` の配列
-- `multiple` (boolean) — `true` で複数選択可
-
-### relation
-
-- `targetType` (string) — 参照先データタイプの slug
-
-## defaultValue（デフォルト値）
-
-フィールド定義に `defaultValue` を設定すると、エントリ作成時に値が未入力の場合に自動的に適用されます。
-
-```json
-{
-  "key": "published",
-  "label": "公開",
-  "type": "boolean",
-  "required": true,
-  "defaultValue": false
-}
-```
-
-**動作:**
-- エントリ作成時、フィールドに値が指定されていない場合に `defaultValue` が適用される
-- 明示的に `null` が指定された場合は `null` が保存される（デフォルト値は適用されない）
-- 値の型は `type` と一致する必要がある（例: `boolean` フィールドに `"false"` は不可）
-
-**使用例:**
-- `published: false` — グローバルデータタイプで、デフォルトで非公開
-- `status: "draft"` — ステータスフィールドで、デフォルトで下書き
-- `order: 0` — ソート順フィールドで、デフォルトで0
-
-## データタイプ JSON 例
-
-### スタッフ
-
-```json
-{
-  "slug": "staff",
-  "name": "スタッフ",
-  "description": "チームメンバー情報",
-  "fields": [
-    {
-      "key": "name",
-      "label": "名前",
-      "type": "text",
-      "required": true,
-      "description": "フルネーム",
-      "options": { "maxLength": 100 }
-    },
-    {
-      "key": "position",
-      "label": "役職",
-      "type": "select",
-      "options": {
-        "choices": [
-          { "value": "director", "label": "取締役" },
-          { "value": "manager", "label": "マネージャー" },
-          { "value": "engineer", "label": "エンジニア" }
-        ]
-      }
-    },
-    { "key": "bio", "label": "自己紹介", "type": "textarea", "options": { "maxLength": 500 } },
-    { "key": "photo", "label": "写真", "type": "image" },
-    { "key": "email", "label": "メールアドレス", "type": "email" }
-  ]
-}
-```
-
-### FAQ
-
-```json
-{
-  "slug": "faq",
-  "name": "よくある質問",
-  "fields": [
-    { "key": "question", "label": "質問", "type": "text", "required": true },
-    { "key": "answer", "label": "回答", "type": "richtext", "required": true },
-    {
-      "key": "category",
-      "label": "カテゴリ",
-      "type": "select",
-      "options": {
-        "choices": [
-          { "value": "general", "label": "一般" },
-          { "value": "pricing", "label": "料金" },
-          { "value": "technical", "label": "技術" }
-        ]
-      }
-    },
-    { "key": "is_featured", "label": "注目", "type": "boolean" }
-  ]
-}
-```
-
-### 実績・事例
-
-```json
-{
-  "slug": "case-studies",
-  "name": "実績・事例",
-  "description": "導入事例や制作実績",
-  "fields": [
-    { "key": "title", "label": "タイトル", "type": "text", "required": true },
-    { "key": "client", "label": "クライアント名", "type": "text" },
-    { "key": "description", "label": "概要", "type": "textarea" },
-    { "key": "thumbnail", "label": "サムネイル", "type": "image" },
-    { "key": "url", "label": "サイトURL", "type": "url" },
-    { "key": "published_date", "label": "公開日", "type": "date" }
-  ]
-}
-```

package/templates/claude/skills/cmx-schema/references/migration-scenarios.md

@@ -1,44 +0,0 @@
-# 移行シナリオ別ガイド
-
-サイト種別ごとに、よく使われるデータタイプとコレクションの構成例。
-
-## コーポレートサイト
-
-データタイプ:
-- `staff` — メンバー紹介（name, position, bio, photo）
-- `service` — サービス紹介（title, description, icon, features）
-- `faq` — よくある質問（question, answer, category）
-- `testimonial` — お客様の声（name, company, content, rating）
-
-コレクション:
-- `news` type=news: お知らせ
-- `page` type=page: 会社概要、アクセス等
-
-## LP（ランディングページ）
-
-データタイプ:
-- `feature` — 機能紹介（title, description, icon）
-- `pricing` — 料金プラン（name, price, features, is_popular）
-- `testimonial` — 利用者の声（name, company, content）
-- `cta` — CTAセクション（title, description, button_text, button_url）
-
-## ブログ・メディア
-
-コレクション:
-- `post` type=post: 記事（blog, column, interview等）
-  - フロントマター: title, description, category, tags, published_at
-  - **category と tags はフロントマターに直接記述（データタイプ不要）**
-
-データタイプ:
-- `author` — 著者情報（name, bio, avatar, social_links）
-
-## ECサイト
-
-データタイプ:
-- `product` — 商品（name, price, description, image, category）
-- `category` — カテゴリ（name, slug, parent）
-- `review` — レビュー（rating, content, author）
-
-コレクション:
-- `page` type=page: 特商法表記、プライバシーポリシー等
-- `news` type=news: セール情報、新商品情報

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

@@ -1,54 +0,0 @@
----
-name: cmx-seo
-description: |
-  CMX Starter Kit の SEO・メタデータ実装スキル。generateMetadata、OGP、sitemap.ts、robots.ts、JSON-LD 構造化データのパターン。
-  トリガー: 「SEOを設定」「メタデータを追加」「OGPを設定」「サイトマップを作成」
-  「robots.txtを設定」「構造化データを追加」「JSON-LDを追加」「検索対策」
-  「Twitterカードを設定」「og:imageを設定」「canonical URLを設定」など。
----
-
-# CMX SEO・メタデータ
-
-## 事前確認
-
-`cmx/site-config.md` のサイト名・説明を確認し、メタデータに反映する。
-
-## 環境変数
-
-`NEXT_PUBLIC_SITE_URL` — サイトの本番 URL。sitemap・canonical・OGP の URL 構築に必須。`.env.local` で設定済みか確認。
-
-## 既存ユーティリティ
-
-`src/lib/utils/metadata.ts` に `generateCollectionMetadata` / `generateContentMetadata` ヘルパーが存在。拡張する場合はこのファイルを修正。
-
-## パターン別ガイド
-
-各パターンの詳細コードは [references/seo-patterns.md](references/seo-patterns.md) を参照。
-
-### generateMetadata
-
-- **静的ページ**: `export const metadata: Metadata` で直接定義
-- **動的ページ**: `export async function generateMetadata()` で CMX API からデータ取得
-- **プレビューページ**: `robots: { index: false, follow: false }` を必ず設定
-
-### OGP / Twitter Card
-
-`metadata.ts` の既存ヘルパーを拡張し、`openGraph` と `twitter` フィールドを追加する。デフォルト OG 画像は `/public/og-default.jpg` に配置。
-
-### sitemap.ts
-
-`src/app/sitemap.ts` を作成。CMX API から全コレクションの記事を取得し動的生成。
-
-### robots.ts
-
-`src/app/robots.ts` を作成。`/preview/` と `/api/` を disallow。
-
-### JSON-LD 構造化データ
-
-記事詳細ページに `<script type="application/ld+json">` を埋め込む。スキーマタイプは `BlogPosting`（ブログ）、`NewsArticle`（ニュース）、`WebPage`（その他）。
-
-## 変更後
-
-1. 各ページの `<head>` 出力を確認（ブラウザの DevTools）
-2. OGP デバッガー（Facebook Sharing Debugger 等）で確認
-3. Google Rich Results Test で JSON-LD を検証

package/templates/claude/skills/cmx-seo/references/seo-patterns.md

@@ -1,216 +0,0 @@
-# SEO 実装パターン
-
-## generateMetadata — 静的ページ
-
-```tsx
-// src/app/about/page.tsx
-import type { Metadata } from "next"
-
-const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com"
-
-export const metadata: Metadata = {
-  title: "会社概要 | サイト名",
-  description: "会社概要ページの説明文",
-  alternates: { canonical: `${SITE_URL}/about` },
-  openGraph: {
-    title: "会社概要 | サイト名",
-    description: "会社概要ページの説明文",
-    url: `${SITE_URL}/about`,
-    images: ["/og-default.jpg"],
-  },
-}
-```
-
-## generateMetadata — 動的ページ（記事詳細）
-
-`src/lib/utils/metadata.ts` を拡張:
-
-```tsx
-import type { Metadata } from "next"
-import { fetchPublishedContent } from "@/lib/api/public-client"
-
-const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com"
-
-export async function generateContentMetadata(
-  collectionSlug: string,
-  contentSlug: string
-): Promise<Metadata> {
-  const data = await fetchPublishedContent(collectionSlug, contentSlug)
-  if (!data) {
-    throw new Error(`Failed to fetch content metadata: ${collectionSlug}/${contentSlug}`)
-  }
-
-  const url = `${SITE_URL}/${collectionSlug}/${contentSlug}`
-  const title = `${data.content.title} | ${data.collection.name}`
-  const description = data.content.description || undefined
-  const image = "/og-default.jpg"
-
-  return {
-    title,
-    description,
-    alternates: { canonical: url },
-    openGraph: {
-      title: data.content.title,
-      description,
-      url,
-      type: "article",
-      images: [image],
-    },
-    twitter: {
-      card: "summary_large_image",
-      title: data.content.title,
-      description,
-      images: [image],
-    },
-  }
-}
-```
-
-## sitemap.ts
-
-```tsx
-// src/app/sitemap.ts
-import type { MetadataRoute } from "next"
-import { fetchPublishedContents } from "@/lib/api/public-client"
-import { COLLECTION_SLUGS } from "@/lib/constants/collections"
-
-const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com"
-
-export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
-  const entries: MetadataRoute.Sitemap = [
-    {
-      url: SITE_URL,
-      lastModified: new Date(),
-      changeFrequency: "daily",
-      priority: 1,
-    },
-  ]
-
-  // 静的ページ
-  const staticPages = ["/about", "/contact"]
-  for (const page of staticPages) {
-    entries.push({
-      url: `${SITE_URL}${page}`,
-      changeFrequency: "monthly",
-      priority: 0.5,
-    })
-  }
-
-  // 各コレクションの記事を取得
-  for (const slug of Object.values(COLLECTION_SLUGS)) {
-    // コレクション一覧ページ
-    entries.push({
-      url: `${SITE_URL}/${slug}`,
-      changeFrequency: "daily",
-      priority: 0.8,
-    })
-
-    // 各記事
-    try {
-      const data = await fetchPublishedContents(slug)
-      if (data?.contents) {
-        for (const item of data.contents) {
-          entries.push({
-            url: `${SITE_URL}/${slug}/${item.slug}`,
-            lastModified: item.publishedAt ? new Date(item.publishedAt) : new Date(),
-            changeFrequency: "weekly",
-            priority: 0.7,
-          })
-        }
-      }
-    } catch {
-      // コレクション取得失敗時はスキップ
-    }
-  }
-
-  return entries
-}
-```
-
-## robots.ts
-
-```tsx
-// src/app/robots.ts
-import type { MetadataRoute } from "next"
-
-const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com"
-
-export default function robots(): MetadataRoute.Robots {
-  return {
-    rules: {
-      userAgent: "*",
-      allow: "/",
-      disallow: ["/preview/", "/api/"],
-    },
-    sitemap: `${SITE_URL}/sitemap.xml`,
-  }
-}
-```
-
-## JSON-LD 構造化データ
-
-### ブログ記事
-
-```tsx
-// src/app/blog/[slug]/page.tsx 内
-const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com"
-
-function BlogPostJsonLd({ content, collectionSlug, slug }: {
-  content: { title: string; description?: string; publishedAt?: string; updatedAt?: string; featuredImage?: string }
-  collectionSlug: string
-  slug: string
-}) {
-  const jsonLd = {
-    "@context": "https://schema.org",
-    "@type": "BlogPosting",
-    headline: content.title,
-    description: content.description,
-    datePublished: content.publishedAt,
-    dateModified: content.updatedAt ?? content.publishedAt,
-    image: content.featuredImage,
-    url: `${SITE_URL}/${collectionSlug}/${slug}`,
-    publisher: {
-      "@type": "Organization",
-      name: "サイト名", // site-config.md のサイト名を使用
-    },
-  }
-
-  return (
-    <script
-      type="application/ld+json"
-      dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
-    />
-  )
-}
-```
-
-### 組織情報（ルートレイアウト）
-
-```tsx
-// src/app/layout.tsx に追加
-function OrganizationJsonLd() {
-  const jsonLd = {
-    "@context": "https://schema.org",
-    "@type": "Organization",
-    name: "サイト名",
-    url: process.env.NEXT_PUBLIC_SITE_URL,
-    logo: `${process.env.NEXT_PUBLIC_SITE_URL}/logo.png`,
-  }
-
-  return (
-    <script
-      type="application/ld+json"
-      dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
-    />
-  )
-}
-```
-
-## コレクションタイプ別の JSON-LD スキーマタイプ
-
-| コレクションタイプ | schema.org @type |
-|------------------|------------------|
-| post（ブログ） | BlogPosting |
-| news（ニュース） | NewsArticle |
-| page（ページ） | WebPage |
-| doc（ドキュメント） | TechArticle |

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

@@ -1,48 +0,0 @@
----
-name: cmx-style
-description: |
-  CMX Starter Kit のスタイル・デザイン変更スキル。CSS 変数、フォント、レイアウト、カラーの変更パターンと site-config.md との連動。
-  トリガー: 「スタイルを変更」「デザインを変えたい」「色を変更」「フォントを変更」
-  「レイアウトを変更」「ヘッダーを修正」「フッターを修正」「ダークモード」
-  「余白を調整」「見た目を変えたい」など。
----
-
-# CMX スタイル変更
-
-## 事前確認
-
-変更前に必ず `cmx/site-config.md` のデザイン方針セクションを読み、変更が方針と矛盾しないか確認する。矛盾する場合はコンフィグの更新も提案すること。
-
-## 変更対象と対応ファイル
-
-| 変更内容 | 対象ファイル |
-|---------|------------|
-| カラー（テーマ色、背景色等） | `src/app/globals.css` |
-| フォント | `src/app/layout.tsx` |
-| Header | `src/components/layout/Header.tsx` |
-| Footer | `src/components/layout/Footer.tsx` |
-| MDX 記事のスタイル | `src/app/globals.css`（`.prose` カスタマイズ） |
-| コンポーネントスタイル | 該当 TSX ファイル |
-| 全体的なスペーシング | `src/app/globals.css` |
-
-## パターン別ガイド
-
-詳細は [references/style-patterns.md](references/style-patterns.md) を参照。
-
-### カラー変更
-
-`src/app/globals.css` の CSS 変数を修正。shadcn/ui のテーマ変数体系に従う。
-
-### フォント変更
-
-`src/app/layout.tsx` の `next/font/google` インポートを変更。CSS 変数でフォントファミリーを指定。
-
-### レイアウト変更
-
-Header/Footer は `src/components/layout/` 配下。ナビゲーション項目、ロゴ、カラムレイアウトを修正。
-
-## 変更後
-
-1. 開発サーバーで全ページの表示を確認
-2. レスポンシブ（モバイル/タブレット/デスクトップ）を確認
-3. `cmx/site-config.md` のデザイン方針セクションを更新して同期