• 階層構造
  • コンテンツ
  • 不足情報
  • 要確認

AIを活用してReadMeのドキュメント構成を監査する方法

ReadMeをAIクライアントに接続して、ドキュメントツリー全体をスキャンしましょう。接続後は、エージェントがカテゴリのマップ作成や、特定のページ、リンク切れの特定を自動で行います。

このページについてAIに聞く

すぐに答え

AIでドキュメント構成を監査する方法は?

ReadMe MCPを使用して、AIがカテゴリ一覧やページの階層構造を取得します。取得した構造を要件と比較することで、情報の欠落、リンク切れ、または廃止すべきコンテンツを特定します。現状の把握から修正が必要な箇所の洗い出しまで、一連のプロセスを可視化できます。

検出されるすべての項目

監査結果の分類

AIは検出した内容を以下の項目に整理します。

階層構造

全体構造マップ

AIがすべてのカテゴリとカスタムページを取得し、ドキュメントのツリー構造をテキストまたは視覚的な形式で構築します。

コンテンツ

ページ一覧

カテゴリ内の個々のドキュメントをリスト化し、どの範囲がカバーされているかを正確に把握できます。

不足情報

情報の欠落

ページが存在しないカテゴリや、階層構造が不完全な箇所をAIがフラグ立てします。

要確認

手動レビューが必要

内容が古い、あるいは重複していると思われる特定のページをAIが特定し、人間による確認を促します。

ワークフロー

リクエストを受けた際のAIの動作

AIがReadMeのインスタンス内を巡回し、ドキュメントの全体像を構築します。

  1. ツリーのマップ作成

    エージェントがドキュメント内のすべてのトップレベルおよびネストされたカテゴリを特定します。

    list_categories
  2. カテゴリの調査

    特定のカテゴリ内部を確認し、どのように構成されているかを把握します。

    get_category
  3. カスタムページの検索

    標準的なカテゴリ構造の外にあるカスタムページをAIが探し出します。

    list_custom_pages
  4. ページ内容の監査

    カテゴリ内の具体的なドキュメントを取得し、情報の深さや関連性をチェックします。

    get_category_docs

試してみる

以下のプロンプトをコピーして開始

これらのプロンプトを使って監査を開始できます。

出発点

監査したい対象に合わせて、カテゴリ名やページ名を書き換えて使用してください。

ReadMe Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_65dP2ZEWi1ggQrtmq1IKVpZ6MOAhFxi6q98C5XwC/mcp

Claude Desktop

以下の手順で数秒で接続できます。

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — ReadMe capabilities are ready to use.
設定 · claude_desktop_config.jsonコピー
{
  "mcpServers": {
    "readme-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_65dP2ZEWi1ggQrtmq1IKVpZ6MOAhFxi6q98C5XwC/mcp"
    }
  }
}
チャットにコピー04
  • ReadMeドキュメントのすべてのカテゴリをリストアップし、その階層構造を教えてください。

  • 「API Reference」カテゴリを確認し、不足しているページがないか教えてください。

  • ドキュメント内のすべてのカスタムページを見つけ出し、名前のリストを作成してください。

  • 「Getting Started」カテゴリのドキュメントを確認し、内容が重複しているページを特定してください。

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

ここから始める

ReadMeを一度接続すれば、あとは聞くだけです。

VinkiusにReadMeアカウントを連携させるだけです。認証情報は暗号化されて保護されるため、お使いのAIクライアントからすぐにドキュメントに関する質問を開始できます。

ReadMeをAIに接続する

FAQ

機能の詳細

  • 01

    AIはドキュメントのページを編集できますか?

    いいえ。AIができるのは構造とコンテンツの読み取りのみです。編集を行う場合は、ReadMe上で手動で行う必要があります。

  • 02

    AIが古いコンテンツを削除してくれますか?

    いいえ。AIは削除すべき箇所を特定することはできますが、ページを削除する権限は持っていません。

  • 03

    AIは非公開のドキュメントまで閲覧しますか?

    はい。AIは、使用しているReadMe APIの認証情報がアクセス権を持っているドキュメントのみを閲覧できます。

  • 04

    ページが古いかどうかをAIはどうやって判断しますか?

    AIは読み取ったコンテンツを、プロンプトで指定した指示やパターンと比較して判断します。

  • 05

    特定のサブカテゴリだけを監査することはできますか?

    はい。特定のカテゴリや、特定のカスタムページ群に絞って調査するようAIに指示できます。

  • ReadMeに関するその他の質問 ReadMeコネクターの全機能を見る

『ReadMe』を Claude、Cursor、ChatGPT などに接続