2026年10月1日·Minds Team

Minds for GitHub Actions: Research Review アクションガイド

Minds Research Review は GitHub Marketplace で公開されている GitHub Action です。シークレットに保存した API キーでワークフローを Minds MCP サーバーに接続します。デフォルトの操作はレビュー用の Study プランを保存するもので、リサーチは開始しません。

Minds は、商用の合成リサーチのためのエンドツーエンドプラットフォームです。Minds Research Review アクションは Minds を GitHub ワークフローに組み込みます。リポジトリ内の提案コピーに対してレビュー可能な Study プランを準備したり、既存の Audience に 1 つの質問をしたり、Study の進捗とサマリーをジョブサマリーにまとめたりできます。

提供状況と要件

このアクションは GitHub Marketplace の Minds Research Review として公開されています。このガイドはリリース v1.0.0 を対象とし、minds-ai-co/minds-research-action@v1 として参照します。ソースコードと入力仕様の全体は minds-research-action リポジトリで公開されています。

Actions が有効な GitHub リポジトリと、API アクセス権のある Minds アカウントが必要です。アクションは https://getminds.ai/mcp のホスト型 Minds MCP サーバーを呼び出します。既存の API 権限と利用上限が適用されます。ランタイム依存関係はなく、GitHub トークンの権限も要求しません。

セットアップ

Minds で Settings → API Keys を開き、このリポジトリ用のキーを作成します。
GitHub で、そのキーをリポジトリまたは組織レベルの Actions シークレット MINDS_API_KEY として保存します。
アクションを使うワークフローを追加します。次の例では、リポジトリ変数 MINDS_PANEL_ID に保存した Study ID を使い、提案中のホームページコピーのプランを準備します。

name: Research review

on:
  workflow_dispatch:

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: minds-ai-co/minds-research-action@v1
        with:
          api-key: ${{ secrets.MINDS_API_KEY }}
          operation: plan-study
          panel-id: ${{ vars.MINDS_PANEL_ID }}
          request: >-
            Prepare a concept test covering clarity, relevance, objections,
            credibility, and concrete improvements.
          stimulus-file: docs/proposed-homepage-copy.md
          stimulus-label: Proposed homepage copy
          study-locale: en

ワークフローを実行し、保存されたドラフトを Minds で確認して、準備ができたらそこでリサーチを開始します。

操作

アクションの入力には MCP の名称が使われています。Group は保存済みの Audience、Panel は Study を指します。

操作	必須入力	効果
`list-groups`	なし	アカウントの保存済み Audience を一覧表示します。`search-query` で名前を絞り込めます。
`plan-study`（デフォルト）	`panel-id` または `panel-name`、`request`	リサーチを開始せずに、レビュー可能な Study ドラフトを保存します。
`ask-group`	`group-id` または `group-name`、`question`	1 つの Audience を対象に、非公開の非同期 Study を開始します。
`get-panel-status`	`panel-id` または `panel-name`	Study の構成と進捗を返します。
`get-panel-summary`	`panel-id` または `panel-name`	サマリーを読み取るか、`refresh-summary: true` で更新します。

バージョン 1 は構造化された Study プランを実行しません。保存したプランの確定は、引き続き Minds 上での明示的な判断です。ask-group はリサーチを開始し、接続したアカウントの利用枠を消費するため、それが意図されている場合にのみ実行してください。質問は回答者に表示されるので、ワークフローやモデルへの指示は含めないでください。

plan-study では、リサーチの目的を request に、回答者に見せる素材を stimulus または stimulus-file のどちらか一方に入れます。両方は指定できません。stimulus ファイルはチェックアウトしたワークスペース内にある必要があり、上限は 20 KB です。study-locale には en、es、fr、de、zh、tr、ar、ja、ko を指定できます。

実行のたびに、読みやすい結果が GitHub のジョブサマリーに書き込まれます。出力は result-json（結果全体。500 KB を超える場合は省略）、panel-id、draft-plan-id、revision、workspace-url です。後続のステップで利用でき、たとえばプルリクエストに Minds のリンクを投稿できます。ask-group の結果は非同期で届くため、後の実行で get-panel-status または get-panel-summary を使って読み取ってください。

セキュリティ

API キーは GitHub Actions のシークレットから api-key 入力経由でのみ渡してください。アクションはキーをマスクし、ログ、出力、サマリー、ファイルに残しません。
リポジトリのシークレットが公開される状態で、信頼できないフォークのコンテンツを評価するために pull_request_target でこのアクションを使用しないでください。
本番のワークフローは、リリースタグまたは完全なコミット SHA に固定してください。

トラブルシューティング

401 または認証エラー: シークレットに有効な Minds API キーが入っているか確認してください。API 認証を参照してください。
Study または Audience が見つからない: 正確な ID を使うか、list-groups を実行して、キーに紐づくアカウントの保存済み Audience 名を確認してください。
result-json がない: 結果が 500 KB を超えています。ジョブサマリーまたは Minds で確認してください。
プラン制限またはレート制限の応答: アカウントの API アクセスと利用枠を確認し、API エラーと制限を参照してください。