revor-outreach

Revor Outreach（関数トリガー型）

1) 目標

このスキルは、汎用的な検索ワークフローではなく、アウトリーチ実行ツールとして扱ってください。

以下を行います。

• アウトリーチの意図を検出する
• Revor アカウント／API／チャネルの準備状況を確認する
• チャネル別に、そのまま送信できるアウトリーチ文面を作成する
• 条件が満たされた場合、利用可能な Revor MCP ツールまたは API を通じて送信する
• 明確な結果概要（送信済み／失敗／スキップとその理由）を返す

必要な受信者データ（profile_url、address、phone）が不足している場合は、捏造しないでください。ユーザーに提供してもらうか、先に検索するよう依頼してください。

Revor MCP ツールを利用できる場合は、revor_list_connect_accounts、revor_send_outreach、revor_like_linkedin_post、revor_get_job を優先してください。それ以外の場合は、振り分けられた参照ファイルに記載されている API フローを使用してください。MCP と API の再試行を混在させないでください。両者はアカウント権限、制限、クレジット、ジョブ、冪等性の仕様を共有しています。

---

2) 機能別のファイル振り分け

デフォルトですべてのファイルを読まないでください。まずタスクの種類を特定し、関連する参照ファイルを読んでください。

A. アカウント／準備状況／送信可否の確認

以下を読んでください。

• reference/accounts.md

以下のようなタスクで使用します。

• Revor が送信可能な状態か確認する
• API キーの有効性を確認する
• LinkedIn／Email／WhatsApp のアカウントが接続済みで、送信可能か確認する
• 送信を進められない理由を説明する

B. アウトリーチの送信（LinkedIn／Email／WhatsApp）

次の順に読んでください。

1. reference/accounts.md
2. reference/dispatch/dispatch.md

ユーザーが以下を希望する場合に使用します。

• LinkedIn の招待／メッセージを送信する
• コールドメールを送信する
• WhatsApp で紹介メッセージを送信する
• 今すぐ送信する／送信を進める

C. LinkedIn 投稿への「いいね」によるウォームアップ

次の順に読んでください。

1. reference/accounts.md
2. reference/dispatch/linkedin-post-like.md

ユーザーが以下を希望する場合に使用します。

• 関連する LinkedIn 投稿に「いいね」する
• アウトリーチ前にエンゲージメントを高める
• Revor の LinkedIn 投稿への「いいね」フローを使用する

D. アウトリーチ文面の作成のみ

ユーザーが文面を希望しているものの、すぐに送信するよう明確に依頼していない場合：

• 必要最小限のコンテキストを集める
• アウトリーチ文面を作成する
• まだ送信しない

チャネルごとの制約を確認するために reference/dispatch/dispatch.md を参照してもかまいませんが、文面の作成を送信の自動的な許可と見なさないでください。

---

3) 機能、トリガー、必須入力

機能 A — アウトリーチ意図の検出

以下のいずれかが依頼された場合にトリガーします。

• 「LinkedIn の招待／メッセージを送信する」
• 「コールドメールを送信する」
• 「WhatsApp で紹介メッセージを送信する」
• 「Revor を使って連絡する」

必須入力：

• 連絡先の対象が少なくとも 1 件
• 対象チャネル（LinkedIn／Email／WhatsApp）が少なくとも 1 つ

不足している場合は、続行する前に対象とチャネルを尋ねてください。

---

機能 B — 送信前の準備状況確認

以下の場合にトリガーします。

• ユーザーが今すぐ送信する／送信を進めるよう依頼する

実際に送信する前に、以下を読んでください。

• reference/accounts.md

必要な条件：

1. ユーザーが Revor アカウントを持っている（Revor のプラン／ポリシーで必要な場合は、利用可能な有料アクセス権もある）。
2. 有効な API キーを持っている。
3. 送信可能なチャネルアカウント（LinkedIn／Email／WhatsApp）を少なくとも 1 つ接続している。
4. 指定されたチャネルについて、can_send=true の接続済みアカウントがある。その他のステータス項目は、診断の参考情報としてのみ使用してください。

不足している場合は、以下を明確に案内してください。

• 登録／ログイン：https://revor.ai
• API キーのページ：https://revor.ai/zh/my-api-keys
• 送信用アカウントの接続：https://revor.ai/console/connect

重要：reference/accounts.md にあるリマインダーの文体とユーザー向けの案内を維持してください。簡潔な拒否に置き換えないでください。

---

Capability C — アウトリーチ文面の作成（送信不要）

次の場合に実行します：

• ユーザーがアウトリーチ文面や草案を求めている場合。
• ユーザーが即時送信を明確に求めていない場合。

必須入力：

• 対象の役職／会社／目的。
• チャネルと言語の希望（指定がない場合はユーザーの使用言語をデフォルトとします）。

情報が不足している場合は、必要最小限の質問だけをします。それでも不明な点が残る場合は、「不足している項目」のリストを返します。

LinkedIn のメモに関する制約：

• LinkedIn のコネクションメモ／招待メモ／メモを追加するメッセージを作成する場合、ユーザーがコネクションメモとして使える形式でなくてもよいと明示しない限り、最終文面は200文字以内にします。
• 情報を詰め込むより、簡潔で自然な表現を優先します。

---

Capability D — アウトリーチの送信

次の場合に実行します：

• ユーザーが送信を明示的に依頼している場合。
• 送信前のチェックに合格している場合。
• チャネル固有の宛先フィールドがすべて入力されている場合。

次の順番で読みます：

1. reference/accounts.md
2. reference/dispatch/dispatch.md

チャネルごとの必須フィールド：

• LinkedIn：recipient.profile_url（連絡先の個人 LinkedIn プロフィールページの URL。例：一般公開されている /in/... のプロフィールリンク。検索結果ページや会社ページではありません）
• Email：recipient.address
• WhatsApp：recipient.phone

必須フィールドが不足している場合：

• 送信しないでください。
• 不足しているフィールドを正確に伝えてください。
• ユーザーにその情報の提供を依頼するか、まず検索するよう依頼してください。

---

4) 環境とシークレットのルール

新しいウィンドウやセッションで再設定が不要になるよう、永続的な設定を優先します。

次の順番でシークレットを解決します：

1. ~/.config/RevorSkill/.env（ローカルの永続的なデフォルト）
2. プラットフォームの永続的な設定（例：Claude Desktop MCP サーバーの claude_desktop_config.json 内の env）
3. プロセス／ランタイム環境（セッション単位のフォールバック）
4. <current-skill-dir>/.env（最後のフォールバック）

プラットフォームの例：

• Claude Desktop + MCP：MCP サーバーの env マップ（claude_desktop_config.json）に REVOR_API_KEY を設定します。
• Claude Code/CLI：REVOR_API_KEY を永続的なシェル／環境変数設定ツールに保存します（永続化が必要な場合は、一時的なエクスポートを避けてください）。

ベース URL：

https://revor.ai

必須キー：

REVOR_BASE_URL="https://revor.ai"
REVOR_API_KEY=""

ルール：

• シークレット値をプロンプト、MEMORY.md、チャットの記録、コミットするリポジトリファイルに保存しないでください。
• .env を使用していてファイルが存在しない場合は、~/.config/RevorSkill/.env を作成してください。
• キーが不足している場合は、既存の値を上書きせずにキー名を追加してください。
• ユーザーがチャットでキーを提供し、設定を依頼した場合は、永続的な設定（デフォルトは ~/.config/RevorSkill/.env）に直接設定してください。
• 検証チェックを推奨しますが、簡易的かつ処理を妨げないものにしてください。
• 出力に API キー全体を表示しないでください。**** でマスクしてください。

---

5) 必須の実行フロー

実際のアウトリーチを実行する場合、以下のフローは必須です。

Flow 1 — タスクの種類を特定する

まず、タスクが次のどれに該当するかを判断します：

1. 準備状況の確認。
2. 文面の作成のみ。
3. 送信。
4. LinkedIn の投稿形式のウォームアップ。

そのうえで、関連する参照ファイルだけを読みます。

Flow 2 — 送信前に準備状況を確認する

実際の送信依頼では、必ず準備状況を確認します。 次を読みます：

• reference/accounts.md

この手順を省略しないでください。

Flow 3 — チャネル固有の宛先フィールドを検証する

送信前に、次を確認します：

• LinkedIn -> profile_url
• Email -> address
• WhatsApp -> phone

必須フィールドが不足している場合は、処理を中止して入力を求めます。

Flow 4 — ユーザーが即時送信を明確に希望している場合を除き、先に文面を作成する

デフォルトの動作：

• 先に文面を作成します。
• 明確な確認を得てから送信します。

ユーザーが今すぐ送信するよう明示的に依頼した場合に限り、すぐに送信します。

フロー 5 — ジョブの結果を必ず確認する

202 Accepted のディスパッチや投稿のような作成レスポンスは、ジョブが作成されたことを意味するだけで、アクションが完了したことを意味するものではありません。

次の方法で、必ず最終結果を確認してください。

• MCP：revor_get_job
• API：GET /api/v2/jobs/{id}

ジョブの照会が HTTP 200 を返しても、item.status = "failed" の場合は、実行失敗として扱ってください。 settling は終端状態ではないため、確認を続けてください。ユーザーからキャンセルを求められた場合は、revor_cancel_job または POST /api/v2/jobs/{id}/cancel を使用してください。キャンセルが保証されるのは、ジョブがキューに入っているか、スケジュール済みの場合のみです。

---

6) ディスパッチポリシー

• デフォルトでは、まず下書きを作成し、ユーザーの明確な確認を得てから送信します。
• ユーザーが即時のディスパッチを明示的に求めた場合に限り、ただちに送信します。
• 非公開の連絡先情報を推測しないでください。
• 大量送信よりも、少数で質の高い連絡先リストを優先してください。

---

7) コンプライアンス上の境界

次の行為への支援は拒否してください。

• ハラスメント
• フィッシング
• なりすまし
• 詐欺
• 未確認の大量スパム送信
• 虚偽の身元情報や連絡先情報の作成

アウトリーチは、プロフェッショナルかつ誠実で、監査可能なものにしてください。