Kurocoドキュメント検索ガイド

このSkillはKuroco公式ドキュメントの検索・参照を支援します。

ドキュメントの場所と形式

ドキュメントはこのスキルに同梱されています。場所は次のとおり:

この SKILL.md と同じディレクトリにある docs/ を使用します。以下の例では、このスキルのディレクトリを基準にした相対パスとして docs/ と表記します。クライアント固有の環境変数や、リポジトリ内の固定パスには依存しないでください。

同梱ドキュメントは配布時点のスナップショットです。記載が古い可能性がある場合や、同梱ドキュメントに該当項目が見つからない場合は、公式サイト（https://kuroco.app/ja/docs/ ）を確認してください。 スキルパッケージを更新すると同梱ドキュメントも最新になります（更新手順は導入方法によって異なるため、リポジトリの README を参照）。

公式ドキュメントの各ページはカテゴリ単位の統合ファイルとして収録されています。

• 1つの統合ファイルに複数の公式ページが入っており、各ページは # タイトル 見出しで始まる
• ページ見出しの直下に元ページのslugと公式サイトURL（https://kuroco.app/ja/docs/...）がある
• 各ファイルの冒頭に「収録ページ」の目次がある
• サイズの大きい分類は -1.md, -2.md のように分割されている（Globで tutorials-auth-member*.md のように検索）

ファイル構成

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

検索方法

方法1: Grepでキーワード検索（推奨）

全文検索ツール（Grep 相当）で docs/ 全体を横断検索し、ヒットしたファイルの該当行付近をファイル読み取りツール（Read 相当。開始行を指定できるもの）で読んでください。検索ツールが無い環境では grep -rn をシェルで実行しても同じことができます。

# キーワードで検索（ファイル特定）
Grep: pattern="エンドポイント" path="docs/"

# 行番号付きで内容を確認 → その行から Read で該当セクションを読む
Grep: pattern="フィルタークエリ" path="docs/" output_mode="content" -n=true

# 元ページのslugがわかっている場合（各ページ見出し直下に slug が記載されている）
Grep: pattern="how-to-use-batch" path="docs/"

# ファイル名で分類を絞る
Grep: pattern="ログイン" path="docs/" glob="tutorials-*.md"

統合ファイルは大きいため、全文Readせず、Grepの行番号 → Read（offset/limit指定）で必要なセクションのみ読むのが効率的です。ページの区切りは # 見出しです。

方法2: INDEX.mdでファイル一覧を確認

cat docs/INDEX.md

どの統合ファイルに何ページ収録されているかの一覧が確認できます。各統合ファイルの冒頭には収録ページの目次（タイトルとslug）があります。

目的別クイックリファレンス

検索のコツ

1. 日本語キーワード: エンドポイント, ログイン, コンテンツ
2. 英語キーワード: Topics, Member, API, CORS
3. 機能名・slug: batch, webhook, trigger, smarty, filter-query
4. 分類を絞る: tutorials-（実装方法）、reference-（仕様）、management-（管理画面）、faq-（Q&A）
5. 回答に公式URLを添える: 各ページ見出し直下の「公式ページ」URLを引用する

ドキュメント更新

ドキュメントはプラグインのアップデートと一緒に更新されます。

/plugin marketplace update diverta-kuroco-skills

統合ファイルの再生成手順（メンテナ向け）は scripts/consolidate_docs.py のdocstringを参照してください。