summarize

要約する

標準インターフェイスとして summarize CLI を使用してください。PATH 上にリリース済みバイナリがある場合は、そちらを優先してください。このリポジトリ内では、現在のチェックアウトに対して pnpm -s summarize を使用してください。

開始する

1. コマンドと現在の仕様を確認します。

   summarize --version
   summarize --help
   

2. 要約に LLM が必要な場合は、モデル／プロバイダーの準備状況を確認します。

   summarize status
   summarize status --json
   

3. 以下から最も対象を絞ったワークフローを実行します。URL とパスは引用符で囲んでください。遅いリモート入力やメディア入力には --timeout 2m を追加します。

API キーの値を表示、要求、コピーしないでください。summarize status はシークレットを公開せずに利用可能かどうかを報告します。

要約する

ウェブページまたはリモートドキュメント：

summarize "https://example.com/article"
summarize "https://example.com/report.pdf" --length short

ローカルファイルまたは標準入力：

summarize "./report.pdf"
summarize "./recording.m4a"
printf '%s\n' "Long text to summarize" | summarize -

レンダリングされていない Markdown／テキストには --plain を使用します。タスクで上書きが必要な場合に限り、--language、--length、--prompt、または --prompt-file を使用してください。ユーザーがそのプロバイダーを指定した場合、または直接利用できる API プロバイダーが設定されていない場合は、--cli codex、--cli claude、またはインストール済みの別の CLI プロバイダーを使用してください。

要約せずに抽出する

抽出または文字起こしの後で処理を止めるには、--extract を使用します。

summarize "https://example.com/article" --extract --format md
summarize "./report.pdf" --extract --format md
summarize "https://youtu.be/VIDEO_ID" --extract --format md

--extract は標準入力に対応していません。抽出では設定済みの文字起こし、OCR、Firecrawl、または Markdown サービスを呼び出す場合があります。スキップするのは最後の要約呼び出しだけです。--markdown-mode llm も、抽出したテキストを整形するために LLM を呼び出します。

YouTube、音声、動画

デフォルトの文字起こし選択：

summarize "https://youtu.be/VIDEO_ID"
summarize "https://youtu.be/VIDEO_ID" --extract --format md --timestamps

ウェブ字幕を必須にするには --youtube web を、ダウンロード／文字起こし経路を必須にするには --youtube yt-dlp を使用します。特定のソースが必要でない限り、auto のままにしてください。

ローカルまたはリモートの音声／動画：

summarize "./interview.mp3" --extract
summarize "./interview.mp4" --extract --timestamps
summarize "./interview.mp3" --extract --diarize

--transcriber auto がデフォルトです。明示的な文字起こしプロバイダーを使用するのは、ユーザーから指定された場合、またはプロバイダーを診断する場合に限ってください。話者分離には、設定済みの ElevenLabs または OpenAI へのアクセスが必要な場合があります。話者の識別は別途オプトインする手順です。根拠なしに話者の身元を推測しないでください。

スライドの場合：

summarize "https://youtu.be/VIDEO_ID" --slides
summarize "./talk.mp4" --slides --extract

スライドの抽出には yt-dlp が必要な場合があります。OCR には tesseract が必要です。

自動化用の JSON

別のコマンドやエージェントで結果を解析する場合は、JSON を使用します。

summarize "https://example.com" --json --metrics off > result.json
jq -r '.summary // .extracted.content // empty' result.json

安定したトップレベルのエンベロープには input、env、extracted、prompt、llm、metrics、summary が含まれます。抽出のみの経路やモデルを使用しない経路で入力が処理された場合、summary または llm は null になることがあります。--extract --json モードでは、抽出したテキストを .extracted.content から読み取ります。

JSON は標準出力に出力されます。進行状況、警告、完了時のメトリクスは標準エラー出力に出力されます。解析前に標準エラー出力を標準出力へ結合しないでください。使用状況の詳細が必要な場合に限り、--metrics detailed を使用してください。

設定と依存関係

優先順位：CLI フラグ、プロセス環境、~/.summarize/config.json、組み込みのデフォルト値。1 回だけの実行にはフラグを優先してください。ユーザーから永続的なデフォルト値の指定を依頼された場合に限り、設定を変更してください。

役立つ診断コマンド：

summarize status --verbose
summarize status --probe
summarize "INPUT" --verbose

通常のウェブ要約にはメディアツールは不要です。メディア処理では、ffmpeg、yt-dlp、ローカルの Whisper／ONNX、または設定済みのクラウド文字起こしを使用する場合があります。ウェブサイトのフォールバックでは Firecrawl を使用する場合があります。ツールをインストールしたり設定を変更したりする前に、エラーから不足している機能を正確に確認してください。

入力は、選択したモデル、抽出、OCR、または文字起こしのプロバイダーに送信されることがあります。機密情報を扱う場合は、コマンドを実行する前に、承認済みプロバイダーを確認するか、承認済みのローカル経路を使用してください。

検証する

実行するたびに、次の点を確認します。

• 終了ステータスが 0 であること。
• 要約または抽出したコンテンツが空でないこと。
• JSON の場合は、jq または別の JSON パーサーで標準出力を解析すること。
• ソースに依存する作業では、選択した経路を決めつけず、extracted、llm、標準エラー出力の診断情報を確認すること。
• プロバイダー、設定、またはフラグを変更した後は、最終的なコマンドを正確に再実行すること。

現在のオプションの詳細については、summarize --help を実行し、リポジトリのドキュメントを確認してください。

• クイックスタート
• メインコマンド
• 設定
• YouTube
• メディア
• 抽出

所有権

このファイルは、Summarize 製品の正式なエージェントワークフローです。汎用的なエージェントワークフローは openclaw/agent-skills に、Summarize CLI の動作はここに記載してください。下流のインテグレーションからは、リリース済みのタグまたは固定したコミットを指定してこのファイルにリンクし、パッケージ化やインテグレーション固有の注記のみを残してください。下流で別の包括的なコマンドガイドを管理しないでください。