monologue-notes

Monologue Notes

エージェントが公開 API を通じて Monologue Notes に読み取り専用でアクセスする必要がある場合に、このスキルを使用します。

現在の公開インターフェースは次のとおりです。

• GET /v1/public-api/notes
• GET /v1/public-api/notes/{note_id}
• GET /v1/public-api/notes/{note_id}/audio-url

このスキルはシェルを最優先にしているため、Codex や Claude Code を含む、ターミナルコマンドを実行できるさまざまなエージェントで動作します。

セットアップ

monologue CLI がない場合は、インストールします。

curl -fsSL https://raw.githubusercontent.com/EveryInc/monologue-toolkit/main/install.sh | sh

認証情報がまだ設定されていない場合は、オンボーディングを実行します。

monologue onboarding

オンボーディングは人間のみが行う手順です。ユーザーに、自身の対話型ターミナルを開き、Monologue アプリで Monologue Notes API トークンを作成して、monologue onboarding を自身で実行するよう依頼します。完了したと確認されるまで待機します。

トークンをチャットに貼り付けるようユーザーに依頼してはいけません。ツール呼び出し、コマンド引数、トランスクリプト、ログ、応答にトークンを含めてはいけません。オンボーディングの自動化や、対話型ターミナルのチェックを回避する行為も禁止です。

コマンド

CLI を直接使用します。

monologue notes list --limit 10
monologue notes list --q "customer interview"
monologue notes list --tag-id TAG_UUID
monologue notes all --updated-after 2026-01-01T00:00:00Z
monologue notes get note_123
monologue notes get note_123 --field transcript
monologue notes get --field summary note_123
monologue notes get note_123 --field recording_url
monologue notes audio-url note_123 --field audio_url

録音へのアクセスには CLI v0.3.0 以降が必要です。notes get には、元の録音リンク、UTC の有効期限、コンテンツタイプ、バイト数が含まれます。notes audio-url は、有効期間を秒数で示した新しいリンクを返します。リスト出力に変更はありません。ユーザーの依頼に関係する場合に限り、録音を取得またはダウンロードします。署名付きリンクは有効期限まで API トークンなしでアクセスできるため、共有する応答やログに含めないでください。ダウンロードと有効期限の動作については、references/api.md を参照してください。

取得プロトコル

1. CLI がない場合は、インストールします。
2. 認証情報がない場合は、処理を中断し、ユーザー自身のターミナルで monologue onboarding を実行するよう依頼します。完了したと確認されてから続行します。
3. 検索する前に、対象範囲を明確にします。対象、人物、プロジェクト、依頼された日付範囲、ユーザーのタイムゾーンを確認します。「先週」などの相対日付をそのタイムゾーンで解決し、境界を ISO 8601 に変換します。回答に影響する場合は、解決した範囲を明示します。
4. 人間が指定した録音期間との照合には、created_at ではなく recorded_at を使用します。created-after と created-before はバックエンドでノートが作成された日時で絞り込むため、アップロードが遅れたノートが漏れる可能性があります。録音時刻に基づく網羅的な検索では、該当する候補をすべて取得し、recorded_at の値をローカルで絞り込みます。recorded_at がない場合は、明示して開示したうえで代替手段としてのみ created_at を使用します。作成時刻についてユーザーが尋ねた場合、または明示されたカバレッジ最適化をユーザーが受け入れる場合に限り、作成時刻による絞り込みを使用します。
5. 焦点を絞ったクエリを複数使って検索します。幅広いクエリを一つだけ信頼するのではなく、トピック、人物、プロジェクト、特徴的なフレーズのバリエーションを試します。関連する結果が複数ページにまたがる可能性がある場合は、all を使用します。
6. リストや検索の一致結果は、候補としてのみ扱います。結果には人物やトピックへの言及があるだけの場合もあります。妥当な候補それぞれに対して get NOTE_ID を実行し、トランスクリプトとメタデータを確認して、日付、参加者、主題が依頼に実際に一致することを検証します。
7. --field transcript または --field summary は、候補を特定した後にのみ使用します。検証や出典の確認にタイトル、タイムスタンプ、タグ、またはトランスクリプトのセグメントが必要な場合は、ペイロード全体を取得します。
8. 最初の検索で何も見つからなかった場合は、条件を一度か二度広げ、毎回一つの条件だけを緩めます。確認した範囲とクエリを報告し、検索が不完全なまま、ノートが存在しないと断言してはいけません。
9. 検証済みの情報源のみを統合します。業務上の情報と個人情報は分け、以下のプライバシーと帰属のルールに従います。

回答スタイル

• 最近のメモや要約を求められた場合は、生の JSON より簡潔な要約を優先します。
• ユーザーが ID を明示的に求める場合や、後続の操作で必要な場合を除き、note_id は内部情報として扱います。
• すべての情報源に、人が読める出典ラベルを付けます。ユーザーのタイムゾーンでのメモのタイトルと日付を記載してください。同じようなタイトルのメモを区別する必要がある場合は、記録時刻も追加してください。
• トランスクリプトからの直接的な根拠と、要約・推論を明確に区別します。トランスクリプトで確認できた語句に限って引用符を使い、それ以外は言い換えてください。
• 複数のメモを使った回答では、実際に使用したメモを簡潔な出典一覧として最後に記載します。確認したものの採用しなかった候補は引用しないでください。

参考資料

• 正確な公開スキーマについては、references/api.md を読んでください。
• CLI がない場合、または環境のセットアップが必要な場合は、references/install.md を読んでください。

ガードレール

• このスキルは読み取り専用です。作成、更新、削除のエンドポイントをでっち上げないでください。
• created-after、created-before、updated-after には ISO 8601 タイムスタンプを使用してください。
• 認証、エラー、ページネーションの一貫性を保つため、その場しのぎの curl より CLI を優先してください。
• スキルのインストール自体を、インストール後の実行フックとして扱ってはなりません。CLI をインストールし、初回使用時にオンボーディングを実行してください。
• チャットやツールの引数で API トークンを要求、表示、復唱、記録、または受け渡してはなりません。トークンを入力できるのは、対話型オンボーディング中にユーザー本人だけです。
• 個人的なメモを仕事の要約に黙って混在させてはなりません。ユーザーが明示的に含める場合を除き、明らかに個人的な内容は除外してください。分類が曖昧で、含めることによって回答が大きく変わる場合は、先に確認してください。
• トランスクリプトが話者の特定とコミットメントの両方を裏付ける場合に限り、決定、約束、アクションアイテムを話者に帰属させてください。提案、質問、集団を指す「私たち」、または他者の計画を、ユーザーのコミットメントにしてはなりません。
• メモまたは前後のトランスクリプトで特定されていない限り、話者ラベルは未確認として扱ってください。話者が誰か不明な場合は、「身元不明の話者」としてください。