cmx-sdk 0.2.9 → 0.2.10

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` のデザイン方針セクションを更新して同期

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

@@ -1,114 +0,0 @@
-# スタイル変更パターン
-
-## カラー変更
-
-`src/app/globals.css` の `:root` と `.dark` で CSS 変数を定義。shadcn/ui 体系:
-
-```css
-:root {
-  --background: 0 0% 100%;           /* 背景色 */
-  --foreground: 222.2 84% 4.9%;      /* テキスト色 */
-  --card: 0 0% 100%;                 /* カード背景 */
-  --card-foreground: 222.2 84% 4.9%; /* カードテキスト */
-  --primary: 222.2 47.4% 11.2%;      /* プライマリ */
-  --primary-foreground: 210 40% 98%; /* プライマリ上のテキスト */
-  --secondary: 210 40% 96.1%;        /* セカンダリ */
-  --muted: 210 40% 96.1%;            /* 控えめな背景 */
-  --muted-foreground: 215.4 16.3% 46.9%; /* 控えめなテキスト */
-  --accent: 210 40% 96.1%;           /* アクセント */
-  --destructive: 0 84.2% 60.2%;      /* 削除・エラー */
-  --border: 214.3 31.8% 91.4%;       /* ボーダー */
-  --ring: 222.2 84% 4.9%;            /* フォーカスリング */
-  --radius: 0.5rem;                  /* 角丸 */
-}
-```
-
-値は HSL 形式（`hue saturation% lightness%`）。Tailwind で `bg-primary` のように使用される。
-
-## フォント変更
-
-`src/app/layout.tsx` で Google Fonts を読み込み:
-
-```tsx
-import { Inter, Noto_Sans_JP } from "next/font/google"
-
-const inter = Inter({
-  subsets: ["latin"],
-  variable: "--font-sans",
-})
-
-const notoSansJP = Noto_Sans_JP({
-  subsets: ["latin"],
-  weight: ["400", "500", "700"],
-  variable: "--font-noto-sans-jp",
-})
-
-// <body> に className で適用
-<body className={`${inter.variable} ${notoSansJP.variable} font-sans`}>
-```
-
-`globals.css` でフォントファミリーを定義:
-
-```css
-:root {
-  --font-sans: var(--font-inter), var(--font-noto-sans-jp), sans-serif;
-  --font-mono: var(--font-geist-mono), monospace;
-}
-```
-
-## Header カスタマイズ
-
-`src/components/layout/Header.tsx`:
-
-```tsx
-const navItems = [
-  { href: "/blog", label: "ブログ" },
-  { href: "/about", label: "企業情報" },
-  { href: "/contact", label: "お問い合わせ" },
-]
-```
-
-- ナビ項目の追加・削除・順序変更
-- ロゴの変更（テキスト or 画像）
-- スティッキーヘッダーの有無
-- モバイルメニューの挙動
-
-## Footer カスタマイズ
-
-`src/components/layout/Footer.tsx`:
-
-- カラム数とカラム内容の変更
-- SNS リンクの追加
-- コピーライト表記の変更
-
-## MDX 記事スタイル
-
-`@tailwindcss/typography` の `.prose` クラスをカスタマイズ:
-
-```css
-.prose {
-  --tw-prose-body: hsl(var(--foreground));
-  --tw-prose-headings: hsl(var(--foreground));
-  --tw-prose-links: hsl(var(--primary));
-}
-
-.prose h2 {
-  @apply border-b pb-2;
-}
-
-.prose img {
-  @apply rounded-lg;
-}
-```
-
-## レスポンシブ設計
-
-Tailwind のブレークポイント:
-
-| プレフィックス | 最小幅 | 用途 |
-|-------------|-------|------|
-| (なし) | 0px | モバイル |
-| `sm:` | 640px | 小型タブレット |
-| `md:` | 768px | タブレット |
-| `lg:` | 1024px | デスクトップ |
-| `xl:` | 1280px | 大画面 |