{"id":20456,"plugin_id":"plugins_6aa3ea0a8af08191873f0428fa06b399","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:16:14.912Z","digest":"3ac067afa0b34124f09dfd7c8e9789ff2578cbae2ffdb6b3ba349cd64993d50a","against":null,"payload":{"description":"microCMSの公式開発者ドキュメント(document.microcms.io)を取得し、API仕様・制限・認証・クエリ・管理画面の操作手順を出典付きで確認する。最新の仕様確認や公式資料・コード例の参照が必要な場合に使用する。プロジェクトの設計・実装・改善はmicrocms-guide、Next.js固有の実装はmicrocms-nextjsを優先し、必要な仕様確認をこのSkillで補う。","included_files":[{"relative_path":"references/urls.md","size_in_bytes":14070}],"name":"microcms-docs","skill_md_contents":"---\nname: microcms-docs\ndescription: microCMSの公式開発者ドキュメント(document.microcms.io)を取得し、API仕様・制限・認証・クエリ・管理画面の操作手順を出典付きで確認する。最新の仕様確認や公式資料・コード例の参照が必要な場合に使用する。プロジェクトの設計・実装・改善はmicrocms-guide、Next.js固有の実装はmicrocms-nextjsを優先し、必要な仕様確認をこのSkillで補う。\nlicense: MIT\n---\n\n# microCMS ドキュメント参照スキル\n\n## 概要\n\nmicroCMS公式開発者ドキュメント `document.microcms.io` に対し、ユーザーの質問に応じた適切なページを特定し、Web取得ツールで内容を取得して回答する。記憶や推測ではなく、常に最新のドキュメントを根拠とする。\n\n## 他のSkillとの使い分け\n\n公式情報の取得と根拠の確認を担当する。設計・実装・改善を進める依頼では、利用可能なら `microcms-guide` または `microcms-nextjs` を使い、必要な仕様確認だけをこのSkillで補う。別Skillが未導入でも資料参照を続ける。Skill名の記載だけで別Skillが自動的に読み込まれるとは想定しない。\n\n## ワークフロー\n\n### 1. 質問の分類\n\nユーザーの質問が次のどのカテゴリに該当するかを判断する:\n\n| カテゴリ | 想定される質問 |\n|---------|-------------|\n| コンテンツAPI | データ取得/登録、クエリパラメータ、APIキー、エラー対応 |\n| マネジメントAPI | コンテンツの管理操作、メディア操作、メンバー取得 |\n| 画像API | リサイズ、フォーマット変換、ウォーターマーク |\n| 操作マニュアル | 管理画面の使い方、フィールド設定、Webhook設定、権限 |\n| チュートリアル | Next.js/Nuxt/Astro等のフレームワーク統合 |\n| SDK | 各言語SDKの使い方、コード例 |\n\n複数カテゴリにまたがる場合（例: 「Next.jsで下書きプレビューを実装する」）は、関連する全カテゴリのURLを参照する。\n\n### 2. URLの特定\n\n`references/urls.md` を読み、関連URLを特定する。**URLを推測で生成してはならない**。\n\n`urls.md` に該当ページが無い場合は、公式のページ一覧 `https://document.microcms.io/llms.txt` を取得して探す。全ページのタイトルとMarkdown版URLが列挙されているため、`urls.md` の記載が古い場合でもここから正しいURLを特定できる。\n\n`llms.txt` にも該当が無ければ、そのページは存在しない。パスを組み立てて試すのではなく、「ドキュメントに該当ページが見つからない」ことをユーザーに伝える。\n\n### 3. ドキュメントの取得\n\n特定したURLの**末尾に `.md` を付与して取得する**。取得には、利用中のエージェントが持つWeb取得の手段（Web取得ツール、`curl` など）を使う。`.md` 付きでアクセスすると `text/markdown` 形式で本文が返るため、HTMLパース不要でLLMが扱いやすい。\n\n例:\n- HTML版: `https://document.microcms.io/content-api/get-list-contents`\n- **Markdown版（こちらを使う）**: `https://document.microcms.io/content-api/get-list-contents.md`\n\n複数URLが必要な場合は、可能な限り**まとめて取得する**（並列取得に対応した環境では並列で取得する）。\n\n> [!IMPORTANT]\n> 存在しないパスでも 404 ではなく **200 で HTML が返る**ことがある。取得結果が Markdown 本文ではなく HTML だった場合、そのURLは無効と判断する。内容を推測で補ってはならない。\n> その場合は `https://document.microcms.io/llms.txt` を取得し、正しいURLを探し直す（ページがリネームされ `urls.md` の記載が古くなっている可能性がある）。\n> セクションのトップURL（`/tutorial/next/` など）は `.md` に対応していないため、`urls.md` に列挙された実ページのURLを使う。\n\n取得時は、そのページから何を読み取りたいのかを明確にしてから読む:\n- コード例が欲しい場合: コード例（特に該当箇所）を抽出する\n- 仕様確認: パラメータ仕様、デフォルト値、必須/任意を一覧化する\n- 手順確認: 目的の操作を行うための手順を順番に抽出する\n\n### 4. 回答の生成\n\n取得した内容に基づいて回答する。以下を遵守する:\n\n- **出典URL を必ず明示する**（複数あれば全て）\n- **コード例はドキュメントの内容に基づき**、不足部分のみ補完する\n- ドキュメントに記載がない事項は「ドキュメントに明示されていない」と明確に伝える\n- 古い情報（例: 旧APIキー方式）と新しい情報（`X-MICROCMS-API-KEY`）が混在する場合は、新しい方を推奨し旧方式の存在に触れる\n\n## 重要な注意事項\n\n1. **URLは必ず `references/urls.md` から確認**。`/manual/foo` のようなパスを記憶や類推で組み立てない。\n2. **取得時はURL末尾に `.md` を付与する**。Markdown形式で本文が返り、HTML版より精度・効率が向上する。\n3. **ベースURLは `https://document.microcms.io`**。`docs.microcms.io` や `microcms.com/docs` 等の類似URLは存在しない（誤記の可能性）。\n4. **APIエンドポイント**: コンテンツAPIは `https://{service-id}.microcms.io/api/v1/{endpoint}`、マネジメントAPIは `https://{service-id}.microcms-management.io/api/v1/`。\n5. **認証**: 現行は `X-MICROCMS-API-KEY` ヘッダー。旧 `X-API-KEY` は非推奨。\n6. **言語**: ドキュメントは日本語版が主。英語版が必要な場合のみ、パス先頭に `/en` を付ける（例: `/en/content-api/introduction.md`）。\n7. **チュートリアルの対応範囲**: Next.js / Astro / Nuxt 2 / Gatsby / JavaScript / PHP / Ruby / Go の8種類のみ。Remix / Nuxt 3 / iOS / Android のチュートリアルページは存在しないため、質問された場合はその旨を伝え、コンテンツAPIの仕様や各SDKのリポジトリを案内する。\n\n## ユーザーへの確認\n\n以下のような場面ではユーザーに確認し、判断を仰ぐ:\n\n- 質問が曖昧で複数のカテゴリに該当しうる場合（例: 「画像を扱いたい」→ 画像API or 画像フィールド or メディア管理？）\n- 利用フレームワーク/SDKが特定できず、複数のチュートリアルから選ぶ必要がある場合\n- 提示する情報量や形式に選択肢がある場合（コード例のみ／詳細解説込みなど）\n\n## リソース\n\n- `references/urls.md`: 主要URL一覧（カテゴリ別、簡易説明付き）とクエリパラメータ早見表。まずこれを参照する。\n- `https://document.microcms.io/llms.txt`: 公式が提供する全ページ一覧（約13KB）。`urls.md` で見つからないとき、または取得結果がMarkdownでなかったときのフォールバックとして取得する。\n\n> [!CAUTION]\n> `https://document.microcms.io/llms-full.txt` は全ページの本文を結合したファイルで **750KB 以上**ある。取得してはならない。\n> `llms.txt` の取得に失敗した場合は `urls.md` の情報だけで回答を続ける。\n\n## 関連\n\n公式が `microcms-document-mcp-server` を提供している（`/mcp-server/microcms-document-mcp-server`）。利用可能な環境では併用するとさらに効率的。\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}