pp-github-intel

Github Intel — Printing Press CLI

前提条件：CLI をインストールする

このスキルは github-intel-pp-cli バイナリを使用します。このスキルのコマンドを実行する前に、必ず CLI がインストールされていることを確認してください。見つからない場合は、先にインストールしてください。

1. Printing Press インストーラーを使用してインストールします。バイナリの保存先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin がデフォルトです。

   npx -y @mvanhorn/printing-press-library install github-intel --cli-only
   

2. 確認します：github-intel-pp-cli --version
3. 報告されたインストールディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go を直接インストールする方法に切り替えてください（Go 1.26.6 以降が必要です）。これは $GOPATH/bin（デフォルトは $HOME/go/bin）にインストールされるため、代わりにそのディレクトリを $PATH に追加してください。

go install github.com/mvanhorn/printing-press-library/library/developer-tools/github-intel/cmd/github-intel-pp-cli@latest

インストール後に --version が「command not found」と報告する場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認が成功するまで、スキルのコマンドを実行しないでください。

エージェントによる調査向けの、公開 GitHub リポジトリ、リリース、検索、セキュリティアドバイザリのシグナルです。

この CLI を使用しない場合

作成、更新、削除、公開、コメント、賛成票、招待、注文、メッセージ送信、予約、購入、またはリモートの状態変更が必要なリクエストには、この CLI を使用しないでください。この Printing Press CLI が公開するのは、確認、エクスポート、同期、分析用の読み取り専用コマンドです。

コマンドリファレンス

advisories — アドバイザリを管理します

• github-intel-pp-cli advisories — グローバルセキュリティアドバイザリを一覧表示します

github-current-intelligence-search — GitHub の最新インテリジェンス検索を管理します

• github-intel-pp-cli github-current-intelligence-search — リポジトリを検索します

repos — リポジトリを管理します

• github-intel-pp-cli repos <owner> <repo> — リポジトリのメタデータを取得します

適切なコマンドを見つける

実行したい内容は分かっているものの、どのコマンドを使えばよいか分からない場合は、CLI に直接問い合わせてください。

github-intel-pp-cli which "<capability in your own words>"

which は、自然言語で記述した機能の問い合わせを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は少なくとも 1 件一致したことを示し、終了コード 2 は確度の高い一致がなかったことを示します。その場合は --help に切り替えるか、より範囲を絞った問い合わせを使用してください。

認証の設定

認証は不要です。

github-intel-pp-cli doctor を実行して、セットアップを確認してください。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ対応 — stdout に JSON、stderr にエラーを出力します

• フィルター対応 — --select でフィールドの一部を保持します。ドット区切りのパスはネストされた構造をたどり、配列は各要素をたどります。応答が冗長な API でコンテキストを小さく保つうえで重要です。

  github-intel-pp-cli advisories --agent --select id,name,status
  

• プレビュー対応 — --dry-run で、リクエストを送信せずに表示します

• オフライン対応 — 同期／検索コマンドは、利用可能な場合、ローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトを表示せず、すべての入力をフラグで指定します

• 読み取り専用 — 作成、更新、削除、公開、コメント、賛成票、招待、注文、送信、その他の変更を伴うリクエストには、この CLI を使用しないでください

応答エンベロープ

ローカルストアまたは API から読み取るコマンドは、出力を出所情報のエンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人が読める形式の N results (live) という概要は、stdout がターミナルであり、かつ機械可読形式のフラグ（--json、--csv、--compact、--quiet、--plain、--select）が設定されていない場合に限り、stderr に出力されます。パイプ経由の利用やエージェントによる利用、および出力形式を明示した実行では、stdout に純粋な JSON が出力されます。

エージェントからのフィードバック

この CLI について気になる点に気付いた場合は（エージェントが気付いた場合も含めて）、記録してください。

github-intel-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
github-intel-pp-cli feedback --stdin < notes.txt
github-intel-pp-cli feedback list --json --limit 10

記録はローカルの ~/.local/share/github-intel-pp-cli/feedback.jsonl に保存されます。GITHUB_INTEL_FEEDBACK_ENDPOINT が設定されており、かつ --send が指定されているか、GITHUB_INTEL_FEEDBACK_AUTO_SEND=true が設定されている場合を除き、POST されることはありません。デフォルトの動作はローカル保存のみです。

バグ報告ではなく、意外に感じたことを書いてください。短く、具体的に、1 行で。それが積み重なっていきます。

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。出力は標準出力に加えて（または標準出力の代わりに）、指定したシンクに送られるため、エージェントはコマンドの結果を手動でパイプ処理せずに振り分けられます。サポートされているシンクは3種類です。

シンク	動作
stdout	デフォルト。標準出力のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイル＋リネーム）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、サポートされているスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを標準エラー出力に記録します。

名前付きプロファイル

プロファイルは、保存して再利用できるフラグ値のセットです。スケジュールされたエージェントが同じ設定で毎回同じコマンドを呼び出す場合に使用します。これは HeyGen の「Beacon」パターンです。

github-intel-pp-cli profile save briefing --json
github-intel-pp-cli --profile briefing advisories
github-intel-pp-cli profile list --json
github-intel-pp-cli profile show briefing
github-intel-pp-cli profile delete briefing --yes

明示的に指定したフラグは、常にプロファイル値より優先されます。プロファイル値はデフォルト値より優先されます。agent-context は、すべての利用可能なプロファイルを available_profiles の下に一覧表示するため、情報を調べるエージェントは実行時にプロファイルを検出できます。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が不正）
3	リソースが見つかりません
5	API エラー（上流の問題）
7	レート制限（待機して再試行）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → github-intel-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の前提条件を参照します
3. それ以外 → 直接使用（--agent を付けて CLI コマンドとして実行します）

MCP サーバーのインストール

1. MCP サーバーをインストールします。

   go install github.com/mvanhorn/printing-press-library/library/developer-tools/github-intel/cmd/github-intel-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add github-intel-pp-mcp -- github-intel-pp-mcp
   

3. 確認します。claude mcp list

直接使用

1. インストール済みか確認します。which github-intel-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーの問い合わせに最適なコマンドを、上記の独自機能とコマンドリファレンスから選びます。
3. --agent フラグを付けて実行します。

   github-intel-pp-cli <command> [subcommand] [args] --agent
   

4. 曖昧な場合は、サブコマンドのヘルプを確認します。github-intel-pp-cli <command> --help