メインコンテンツまでスキップ

Kuroco Skills リファレンス

このページでは、Kuroco Skills に含まれる 13 個のスキルについて詳しく説明します。

kuroco-docs - ドキュメント検索​

Kuroco 公式ドキュメントの検索・参照を支援するスキルです。

機能​

  • パッケージに同梱された公式ドキュメントの横断検索
  • 目的別クイックリファレンス（API、認証、フロントエンド、コンテンツ管理など）

使用例​

「Kuroco のエンドポイント設定方法を知りたい」
「ログイン API の仕様を調べたい」
「フィルタークエリの書き方を教えて」

同梱ドキュメントの構成​

公式ドキュメントの各ページは、カテゴリ単位の統合ファイルとして収録されています。1 つの統合ファイルに複数の公式ページが含まれ、各ページの見出し直下に元ページの slug と公式サイト URL が記載されています。

ファイル内容
INDEX.md全ファイルの一覧と収録ページ数
tutorials-*.mdチュートリアル（auth-member / frontend / content / api-custom / ai-mcp / ec / form-mail / integration / admin-customize / misc）
reference-*.mdリファレンス（api / content / smarty-trigger / mcp-ai / file / misc）
management-*.md管理画面ガイド（account / api / campaign / content / ec / integration / member / operation / misc）
faq-*.mdFAQ（content / frontend / api / api-error / admin / email-form / domain / file / login-session / password / smarty / tls / infrastructure / deploy / member / email / assessment / contracts / other）
about.mdKuroco の概要、料金、制限事項、セキュリティ
troubleshooting.mdトラブルシューティング
注記

お知らせ・リリースノートは鮮度が重要なため同梱されていません。これらは公式サイト（https://kuroco.app/ja/docs/ ）を参照してください。

kuroco-app-builder - アプリ・サイトの構築ワークフロー​

Kuroco で Web アプリ・サイトをゼロから構築する手順全体をオーケストレーションするスキルです。個別機能の実装は各専門スキルに委譲し、進め方（フェーズ設計）と橋渡しを担当します。

機能​

  • フロントエンド先行（モックファースト）の構築フロー
  • 機能 → Kuroco 機能のマッピング表（コンテンツ定義、カテゴリ、メンバー、フォーム、お気に入り、コメント、EC など）
  • 認証方式の決定基準（認証なし / Cookie 認証 / 動的アクセストークン / 静的アクセストークン）
  • Admin MCP のスコープ事前確認（whoami）と、着手可否の判断
  • モックデータを Kuroco API のレスポンス形（{ list, pageInfo } / { details }）で作る契約と、実 API への差し替えパターン
  • 進行チェックリストとアンチパターン集

使用例​

「Kuroco でアプリを丸ごと作りたい」
「サイトを新規で構築して」
「ブログサイトを作りたい。まず動く画面を見せて」
「会員サイトをゼロから構築して」

対応するキーワード​

アプリ構築 サイト構築 プロトタイプ モックファースト フロントエンド先行 コンテンツ定義 TopicsGroup エンドポイント作成 KurocoFront デプロイ whoami mcp:tools.all

構築フェーズ​

フェーズ内容
フェーズ 0要件ヒアリング、機能 → Kuroco 機能マッピング、認証方式の決定、Admin MCP のスコープ確認
フェーズ 1モックデータでのフロントエンド構築と画面確定
フェーズ 2コンテンツ定義・カテゴリ・サンプルデータの作成（Admin MCP）
フェーズ 3エンドポイント作成とセキュリティ設定
フェーズ 4実データ接続、認証・フォーム接続、デプロイ
注記

データモデルが確定している場合や画面が定型の場合は、バックエンド先行（フェーズ 2 → 3 → 1 → 4）に切り替えることもできます。

kuroco-api-content - API 連携 & コンテンツ管理​

Kuroco API の設計・実装およびコンテンツ管理（CRUD 操作）に関するベストプラクティスを提供するスキルです。 旧 kuroco-api-integration と kuroco-content-management を統合したスキルです。

機能​

API 連携:

  • エンドポイント設計パターン（URL 構造、主要モデル、オペレーション）
  • 認証方式（なし / 静的アクセストークン / 動的アクセストークン / Cookie）
  • CORS 設定、キャッシュ戦略、流量制限
  • エラーハンドリングパターン（401 / 403 / 429）

コンテンツ管理:

  • コンテンツ構造（Topics / TopicsGroup / TopicsCategory）
  • 拡張項目（カスタムフィールド）の設定・利用方法
  • Topics API のオペレーション（list / details / insert / update / delete / bulk_upsert）
  • フィルタークエリの構文と使い方、ページネーション
  • 多言語対応（langs_open_flg）
  • ファイルアップロード、CSV インポート/エクスポート
  • EC ポイントの操作（ECPoint）

使用例​

「Kuroco の API でログインを実装したい」
「トークン認証の使い方を教えて」
「CORS のエラーが出る。設定方法は？」
「Kuroco でコンテンツ定義を作りたい」
「記事の一覧を API で取得したい」
「フィルターで特定カテゴリの記事だけ取得したい」

対応するキーワード​

Kuroco API エンドポイント設定 認証 CORS Cookie認証 動的アクセストークン 静的アクセストークン JWT 流量制限 credentials include 401エラー 403エラー 429エラー pageInfo ページネーション langs_open_flg コンテンツ定義 Topics カテゴリ WYSIWYG ファイルアップロード CSVインポート ext_col filter order_query bulk_upsert topics_flg 拡張項目 ECPoint

主な認証方式の比較​

認証方式推奨ユースケース特徴
なし開発・テスト用（本番非推奨）ヘッダー不要
静的アクセストークンサーバー間通信、公開 API固定トークンを X-RCMS-API-ACCESS-TOKEN ヘッダーに付与
動的アクセストークンログイン必須サイト（JWT）ログインで取得したトークンを X-RCMS-API-ACCESS-TOKEN ヘッダーに付与
Cookieログイン必須の Web サイトセッションベース。credentials: 'include' が必須

フィルタークエリの基本構文​

演算子例
=, !=filter=category_id = 1
>, >=, <, <=filter=ymd >= "2024-01-01"
contains, ncontainsfilter=subject contains "キーワード"
in, ninfilter=category_id in [1, 2, 3]
注記

文字列の値は二重引用符で囲みます。シングルクォートは引用符ごと値の一部として扱われるため、エラーにならず 0 件になります。

kuroco-frontend-integration - フロントエンド統合 & KurocoFront デプロイ​

Kuroco と Vite / Nuxt.js / Next.js の統合パターンおよび KurocoFront へのデプロイを提供するスキルです。 旧 kuroco-ai-deployment の機能を統合しています。

実践的なチュートリアルは Kuroco サンプルサイトチュートリアル を参照してください。

機能​

フロントエンド統合:

  • Vite + Vue 3 / Nuxt 3 / Nuxt 2 / Next.js（App Router / Pages Router）の統合パターン
  • 環境変数設定、プロジェクト構成例
  • 認証実装（ログイン / ログアウト / ログイン状態確認 / 会員登録）
  • SPA / SSG / SSR 設定
  • KurocoPages との連携
  • サードパーティ Cookie 問題への対応、XSS 対策

KurocoFront デプロイ:

  • kuroco_front.json の設定
  • GitHub リポジトリ連携によるデプロイ
  • Admin MCP からの直接デプロイ（zip アップロード → KurocoFront-deploy → KurocoFront-history で反映確認）
  • プレビューデプロイ（is_preview）/ 本番デプロイ、上書き時の注意点

使用例​

「Nuxt3 で Kuroco のコンテンツを表示したい」
「Next.js で Kuroco の認証を実装したい」
「SSG で静的サイトを生成したい」
「Safari でログインできない（Cookie の問題）」
「Kuroco のサイトを KurocoFront にデプロイしたい」
「プレビュー環境にデプロイして確認したい」

対応するキーワード​

Vite Nuxt3 Next.js App Router SPA SSG SSR useAsyncData $fetch composable useAuth KurocoPages credentials include サードパーティCookie XSS KurocoFront kuroco_front.json GitHub連携 KurocoFront-deploy KurocoFront-history artifact_url stage_url is_preview CI/CD

フレームワーク別の推奨​

フレームワーク推奨ユースケース
Vite + Vue 3シンプルな SPA（SEO 不要のアプリ・ツール類）
Nuxt.js 3.xSEO が必要なコンテンツサイト（SSG で静的 HTML 生成、推奨）
Nuxt.js 2.x既存 Vue プロジェクト
Next.js 13+（App Router）新規 React プロジェクト
Next.js（Pages Router）既存 React プロジェクト

デプロイ方法​

方法内容
GitHub 連携管理画面 [KurocoFront] → GitHub リポジトリ連携。push 時に GitHub Actions でビルドし、成果物をデプロイ
Admin MCP からの直接デプロイビルド成果物の zip をアップロードし、KurocoFront-deploy でデプロイ（非同期）。KurocoFront-history で反映を確認
上書きについて

1 つのドメインで公開されるのは現行デプロイ 1 つだけで、新しいデプロイは既存の公開内容を置き換えます。本番反映前に is_preview: true でのプレビューデプロイによる確認を推奨します。

kuroco-server-processing - Smarty プラグイン & バッチ処理​

Kuroco の Smarty テンプレートの完全リファレンスおよびバッチ処理・Webhook・トリガーを使った自動化パターンを提供するスキルです。 旧 kuroco-smarty-plugins と kuroco-webhook-processing を統合したスキルです。

機能​

Smarty プラグインリファレンス:

  • 205 個のプラグインの完全なリファレンス
  • カテゴリ別索引（API / 文字列 / 配列 / フォーム / 認証 / 外部連携 / ファイル / Vue.js）
  • Smarty 基本構文（変数代入、ループ、条件分岐、修飾子）
  • セキュリティ設定（IF_FUNCS / MODIFIER_FUNCS）

バッチ処理 & Webhook:

  • バッチ処理の設定方法と実行頻度
  • 内部 API 呼び出し（api_internal）
  • 外部 API 呼び出し（api）
  • トリガー処理（コンテンツ更新時 / フォーム送信時）、トリガーメールアドレス
  • 外部サービス連携（Slack / Chatwork / SendGrid / メール / GitHub Actions）

使用例​

「Smarty で記事一覧を取得して表示したい」
「sendmail プラグインの使い方を教えて」
「Smarty で JSON をパースする方法は？」
「バッチ処理で毎日 CSV を生成したい」
「コンテンツ更新時に Slack に通知を送りたい」
「GitHub Actions でデプロイをトリガーしたい」

対応するキーワード​

Smartyプラグイン Smarty関数 Smarty修飾子 assign foreach escape date_format api_internal sendmail slack_post_message ai_completion write_file バッチ処理 Webhook 定期実行 cron Slack通知 Chatwork SendGrid GitHub Actions api トリガー トリガーメールアドレス カスタム処理

カテゴリ別リファレンス​

カテゴリ主なプラグイン
API・データ取得api_internal, assign_topics_list, assign_tag_list
文字列処理escape, truncate, date_format, translate
配列操作count, in_array, implode, explode
フォーム・UIfileupload, inquiry_input, pager
認証・権限rcms_auth, login, logout
外部連携sendmail, slack_post_message, ai_completion
ファイル操作write_file, put_file, read_file
Vue.js 連携rcms_vue_component, head_include

バッチ処理の実行頻度​

頻度用途
15 分毎頻繁な同期が必要な場合
30 分毎準リアルタイム処理
1 時間毎定期的な集計・更新
毎日（指定時刻）日次レポート、バックアップ

kuroco-admin-mcp - Admin MCP 接続 & 管理操作​

Admin MCP（管理 MCP サーバ）への接続設定と、MCP ツールによる管理操作を支援するスキルです。 AI エージェントから Kuroco の管理操作を行う場合の推奨手段です。

機能​

  • モジュールスコープ付きエンドポイント URL の組み立て方（/x/all、/x/all/readonly、/x/topics_group_5 など）
  • 3 つの認証方式（OAuth 2.0 認可コードフロー / 特権静的トークン / 管理セッション）と CIMD の利用
  • OAuth スコープの権限レベル設計（mcp:tools.read / mcp:tools.write / mcp:tools.all / mcp:admin の 4 レベル、リソース単位スコープ）
  • whoami による実効権限の事前確認
  • Claude Code・Claude（Web / Desktop）・ChatGPT・Codex CLI からの接続設定
  • ツールの命名規則（{リソース}-{動詞}）と利用フロー、ファイルアップロード（ステージング → 参照渡し）
  • 「ツールが見えない」「audience 不一致」「エンドポイント作成だけ権限エラー」などのトラブルシューティング

使用例​

「Claude Desktop から Kuroco を操作したい」
「Admin MCP に接続したい」
「MCP のツールが表示されない原因を知りたい」
「読み取り専用で MCP を使いたい」

対応するキーワード​

Admin MCP MCP サーバ MCP 接続 OAuth CIMD Issuer URL mcp:admin mcp:tools.all mcp:tools.write mcp:tools.read whoami スコープ tools/list 特権静的トークン

スコープの権限レベル​

スコープできること
mcp:tools.read全モジュールの読み取りのみ（書き込み不可）
mcp:tools.writetopics / csvtable / tag / comment 等の登録・更新。削除は不可で、rcms_api member group batch は含まれない
mcp:tools.all全モジュール・全操作（下記の例外を除く）
mcp:admin制約なし。スーパーユーザーのみ承認可能

mcp:tools.write は単独では選べず、mcp:tools.read とセットで付与されます。mcp:tools.all でも、権限グループと汎用 Smarty バッチの作成・変更・削除、メンバーへのスーパーユーザーグループ付与、特権付き静的トークンの発行はできません。

注記

API 定義・エンドポイントの作成には mcp:tools.all 以上が必要です。コンテンツ定義の作成は mcp:tools.write で進むため、エンドポイント作成の手前で初めて失敗します。着手前に whoami で permissions.connection.scope を確認してください。

前提条件​

  • 対象サイトの管理メンバーアカウント（OAuth 認可フローで管理画面のログイン・同意を経由するため）
  • 接続元 IP を限定する場合は、[環境設定] → [管理画面] の「Admin MCP のアクセス制限(IP アドレス)」の設定
課金対象

Admin MCP（/direct/rcms_api/admin_mcp/）へのリクエストは、通常の API リクエストと同様にリクエストごとの課金対象です。

kuroco-content-structure-design - コンテンツ構造の設計​

コンテンツ定義（TopicsGroup）を作成する前に、構造の設計判断を行うスキルです。実際の作成は kuroco-content-structure-creation に引き継ぎます。

機能​

  • コンテンツ定義を分割するかどうかの判断（拡張項目数の上限、コンテンツの性質の違い）
  • 検索・一覧表示・外部連携に使わない付随項目を JSON 項目にまとめ、拡張項目数を抑える判断
  • マスタデータの表現方法の選択（CSV テーブル / 別コンテンツ定義 + リレーション）
  • 分類の持ち方の選択（カテゴリ / タグ / リレーション）
  • ext_slug の命名方針
  • 設計成果物テンプレート（フィールド一覧表、マスタ一覧表）

使用例​

「コンテンツ構造を設計したい」
「マスタデータの持ち方を決めたい」
「カテゴリとタグのどちらを使うべきか」
「拡張項目が増えそう。JSON 項目にまとめるべきか」

対応するキーワード​

コンテンツ構造 コンテンツ定義の分割 TopicsGroup マスタデータ CSV テーブル csvtable relation カテゴリ タグ JSON 項目 ext_slug 拡張項目数の上限

マスタデータの表現方法​

観点CSV テーブル + csvtable / csvtable_checkbox別コンテンツ定義 + relation
マスタの実体CSV テーブル（コンテンツ定義とは別のリソース）通常のコンテンツ定義
呼び出し側の API レスポンスキーのみ。値は Master::list を別途呼んで結合するid + ラベルがインラインで返る
マスタ側の拡張項目・カテゴリ・公開制御持てない持てる
マスタ自身の属性での絞り込み不可可能（:R() 検索。主言語に対してのみ実行可能）
向くケース都道府県・業種一覧など、静的で単純なキー / 値の対応マスタを管理画面で編集する、属性を持つ、絞り込みに使う
注記

relation 型のレスポンスに含まれるのは、既定では id とラベルのみです。関連先コンテンツの全項目を返すには、エンドポイントの後処理にカスタム処理を追加する必要があります。

kuroco-content-structure-creation - コンテンツ定義の作成​

MCP ツールによるコンテンツ定義（TopicsGroup）の作成を支援するスキルです。

機能​

  • コンテンツ定義の作成手順（MCP ツール経由）
  • フィールドタイプのリファレンス（テキスト、WYSIWYG、選択、チェックボックス、画像、ファイル、関連、日付、JSON、ブロックエディタなど）
  • フィールドグループ、繰り返し項目の定義方法

使用例​

「コンテンツ定義を新しく作りたい」
「拡張項目に選択式のフィールドを追加したい」
「繰り返し項目を持つコンテンツ定義を設計して」

対応するキーワード​

コンテンツ定義 TopicsGroup 拡張項目 ext_col フィールドタイプ フィールドグループ 繰り返し項目

kuroco-auth-design - 認証・会員設計​

会員認証と権限まわりの設計判断を行うスキルです。実装コードは kuroco-frontend-integration、既存設定の点検は kuroco-security-audit が担当します。

機能​

  • API 認証方式の選択（認証なし / Cookie 認証 / 動的アクセストークン / 静的アクセストークン）
  • 会員グループ設計（モジュールごとの権限の組み合わせ、権限昇格経路の回避）
  • 登録フローの選択（即時登録 / 招待 / 仮登録）
  • コンテンツアクセス制限のスコープ（グループ制限 / カスタム検索 / 自分の投稿のみ）と、認証方式と権限をセットで設定する必要性
  • パスワードポリシー・2 要素認証（管理画面向けと会員ログイン向けの切り分け）
  • 代理ログインの要否
  • エンタープライズ SSO（OAuth SP / SAML SP / IDaaS SP）・SCIM プロビジョニングを見据えた設計

使用例​

「会員機能を設計したい」
「会員グループをどう分ければいいか」
「登録フローをどうするか」
「あとから SSO を繋げられるようにしたい」

対応するキーワード​

会員認証 会員グループ 登録フロー 仮登録 招待 閲覧制限 編集制限 パスワードポリシー 2 要素認証 代理ログイン SSO OAuth SP SAML SP IDaaS SP SCIM

ID 連携の種類​

仕組み役割
OAuth SPKuroco がクライアントとなり、外部 IdP で OAuth 認証による SSO ログインを行う
SAML SPKuroco がサービスプロバイダとなり、外部 IdP と SAML 認証で SSO ログインを行う
IDaaS SPCIAM（消費者向け ID 管理）サービスと連携して SSO ログインを行う
SCIM SPログインではなく、外部 IdP からの会員情報の自動同期（作成・更新・無効化）

同時に有効にできる SCIM SP は 1 サイトにつき 1 つです。

注記

本スキルが扱うのはサイトの会員の認証・権限です。AI エージェント自身が Kuroco の管理操作を行うための OAuth スコープ（mcp:admin など）は kuroco-admin-mcp の対象です。

kuroco-external-integration-design - 外部システム連携の設計​

Kuroco で構築したアプリを外部システムと連携させる方式の設計判断を行うスキルです。Smarty の実装構文は kuroco-server-processing が担当します。

機能​

  • 3 パターン（直接呼び出し / プロキシ / 取り込み）の使い分け
  • プロキシパターンの実装制約（api プラグインのパラメータ、1 回の呼び出しで送信できるファイルは 1 件、タイムアウトの扱い）
  • 取り込み手段の選択（バッチ処理 / スパイダー / Webhook / トリガーメールアドレス）
  • 秘密情報の管理（secret プラグインとサイト定数の使い分け、mTLS 証明書の参照方法）
  • トークン管理（固定 API キー / クライアントクレデンシャル / リフレッシュトークン / 署名方式）とアクセストークンの持ち回し方針
  • 連携先ごとの落とし穴（Instagram、Twilio、LINE、Slack、Amazon S3 など）

使用例​

「外部 API と連携したい」
「LINE や Slack と繋ぎたい」
「外部データを取り込みたい」
「API キーをどこに置くべきか」

対応するキーワード​

外部連携 直接呼び出し プロキシ 取り込み api プラグイン secret シークレット サイト定数 バッチ処理 スパイダー Webhook トリガーメールアドレス OAuth リフレッシュトークン mTLS

3 つの連携パターン​

パターン構成向くケース
直接呼び出しフロントエンドが外部 API を直接呼ぶ。Kuroco は関与しない外部 API 側が CORS を許可しており、認証情報をフロントに置いてよい場合
プロキシ（Kuroco 経由）カスタムエンドポイントの Smarty テンプレートから api プラグインで外部 API を呼び、結果を返す認証情報を隠したい、認証・CORS・流量制限を Kuroco 側に一本化したい、レスポンスを加工したい場合
取り込み外部データを事前に Topics / CSV テーブルへ取り込み、標準の Topics API で提供する更新頻度が低い、Kuroco の標準機能（検索・キャッシュ・多言語）に外部データも乗せたい場合
秘密情報の置き場所

API キーや Webhook の秘密 URL など、攻撃に使われうる値は secret プラグイン（[環境設定] → [シークレット]に事前登録）で読み出します。サイト定数（$smarty.const.*）は非秘匿の設定値向けであり、秘匿情報の置き場所にはしません。

注記

スパイダーは Web ページやファイルの巡回・取り込みを行う機能で、構造化された外部 API の定期取得には向きません。巡回自体が課金対象の API リクエストを発生させます。構造化データの定期取得はバッチ処理から api プラグインで取得し、api_internal で Topics へ登録する構成にします。

kuroco-api-performance-review - API パフォーマンス & コストレビュー​

Admin MCP の読み取り系ツールで API のパフォーマンスと利用料を調査し、キャッシュ設定を中心とした改善提案をまとめるスキルです。

機能​

  • 費目別のコスト内訳と推移の把握（利用状況）
  • エンドポイント別の集計分析（リクエスト数、キャッシュヒット / ミス、平均実行時間、平均レスポンスサイズ）
  • キャッシュ設定と直近実績の突き合わせ（キャッシュ期間が未設定なのか、設定済みでも当たっていないのかの切り分け）
  • 生ログによる裏取り（クローラー比率、リファラー別のリクエスト数、エラーの常態化）
  • 症状別の調査レシピと、費用対効果順の対策整理

使用例​

「Kuroco の利用料が増えた原因を調べたい」
「キャッシュヒット率が低いエンドポイントを洗い出したい」
「API リクエスト課金の内訳を分析して」
「レスポンスが遅いエンドポイントを特定して」

対応するキーワード​

利用料 コスト 従量課金 API リクエスト キャッシュされた API リクエスト キャッシュヒット率 MISS PASS API 解析 キャッシュ設定 maxage CDN 転送量 実行時間 クローラー

前提条件​

  • Admin MCP への接続（調査のみであれば読み取り専用の権限レベルで足ります）
  • 費用の分析には利用状況を参照できる権限

kuroco-security-audit - セキュリティ設定チェック​

Admin MCP の読み取り系ツールのみでセキュリティ設定を収集し、チェックリストに照らしてリスクを診断・報告する読み取り専用のスキルです。設定の変更は行いません。

機能​

  • API のセキュリティ方式・CORS・IP アドレス制限の点検
  • ログイン / パスワードポリシー、2 要素認証（ワンタイムパスワード）の設定確認
  • 権限グループとスーパーユーザーの棚卸し
  • 静的アクセストークン・シークレットの棚卸し
  • 監査ログの有効性確認と、MCP で取得できない項目の手動確認リスト化

使用例​

「セキュリティ設定に問題がないか確認したい」
「CORS と IP 制限の設定を点検して」
「権限グループとスーパーユーザーを棚卸ししたい」
「静的アクセストークンの棚卸しをして」

対応するキーワード​

セキュリティチェック セキュリティ監査 セキュリティ診断 CORS IP 制限 アクセス制限 権限 スーパーユーザー 2 要素認証 ワンタイムパスワード パスワードポリシー 静的アクセストークン 監査ログ

脆弱性スキャンとの違い

本スキルは管理画面で設定できる項目の設定値レビューを行うもので、脆弱性スキャンやペネトレーションテストは対象外です。

kuroco-spec-writer - 仕様書生成​

Admin MCP の読み取り系ツールのみでサイトの実設定を収集し、Markdown + Mermaid の仕様書（現況仕様書）を生成する読み取り専用のスキルです。設定の変更は行いません。

機能​

  • コンテンツ定義の項目表と ER 図、API エンドポイント一覧、認証・会員グループ、承認フロー、カスタム処理・バッチ、フォームの生成
  • そのサイトで実際に使われているモジュールの判定（CSV テーブル、サイト定数、メールテンプレートなど）と章の追加
  • 1 定義 = 1 ページの分割出力と、ファイル名・図のノード名に使うページキーの採番
  • 生成に使用した読み取りツール名の出典記載
  • 付属スクリプトによる PDF + zip への変換
  • 生成した仕様書をユーザーが編集し、その差分をサイトへ反映する往復運用（書き込み自体は kuroco-admin-mcp に委譲）

使用例​

「サイトの仕様書を作って」
「コンテンツ定義を一覧化して ER 図も作って」
「引き継ぎ資料を PDF でほしい」
「編集した仕様書の内容をサイトに反映して」

対応するキーワード​

仕様書 設計書 現況仕様書 as-built ドキュメント化 ER 図 Mermaid PDF 引き継ぎ資料 納品ドキュメント

出力構造​

spec/
├── README.md              # 目次・サイト概要・全体構成図
├── contents/              # コンテンツ定義（一覧表 + ER 図、1 定義 = 1 ページ）
├── functions/             # カスタム処理・バッチ（1 処理 = 1 ページ）
├── api.md                 # API エンドポイント一覧
├── auth.md                # 認証・会員グループ
├── workflow.md            # 承認フロー（使用している場合のみ）
├── forms.md               # フォーム（使用している場合のみ）
└── {module}.md            # 上記以外で使われているモジュールの一覧

前提条件​

  • Admin MCP への接続。書き込み系ツールが一覧に出ないため、/readonly を付けたスコープ URL を推奨します
  • 仕様書は横断的にモジュールを参照するため、スコープは all が適切な場合が多いです
セキュリティ監査との違い

本スキルは実設定を仕様書として書き起こすスキルです。セキュリティ観点のリスク判定は kuroco-security-audit が担当します。

関連ドキュメント​

サポート

お探しのページは見つかりましたか？解決しない場合は、問い合わせフォームからお問い合わせいただくか、Slackコミュニティにご参加ください。

フォームから問い合わせをする
Slackコミュニティに参加する