handle-reply について
handle-replyは、営業返信を分類して返信案を作成し、SwanとHubSpotの記録を更新するワークフロースキルです。アウトバウンドシーケンスを扱うチーム向けで、送信には必ず承認が必要です。
主な機能
- 01返信を6種類の意図に分類
- 02送信者の文体に合わせて返信案を作成
- 03シーケンスとCRMの記録を更新
- 04送信前に承認を必須化
活用シーン
- 01関心を示した見込み客への返信
- 02異議や紹介への対応
- 03配信停止と不在状態の記録
- 04営業返信の一括処理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/handle-replyを入力して読み込まれたか確認します。
詳細
手順
状態の確認。 このスキルを使うには、CRM が接続され、少なくとも 1 人の送信者に指示が設定されており、組織で承認されたメッセージ例がトーンの基準として用意されている必要があります。CRM の接続を確認し、送信者の指示を読み込み、メッセージ例を取得してから下書きを作成してください。送信者の指示がない場合は、すべての返信で一貫したトーンを保てるよう、ユーザーに一度だけトーンを定義してもらってください。汎用的なトーンで代用しないでください。CRM が接続されていない場合でも、下書きの作成にはこのスキルを使えますが、CRM への書き込み手順は省略し、その旨をユーザーに伝えてください。
Step 1 — スレッドとシーケンスのコンテキストを読み込む
シーケンスと最新の返信を取得します。
swan-search-sequencesを連絡先または会社で絞り込み、アクティブなシーケンスを見つけます。swan-get-sequenceでスレッド全体と最初に送信したメッセージを取得します。hubspot-search-objectsで Contacts と Companies を検索し、CRM の状態（ライフサイクルステージ、担当者、取引との関連付け）を確認します。
応答が大きい場合は、swan-execute-code で files/tool-outputs/swan-get-sequence_<callId>.json の JSON 全体を読み込み、スレッドの直近 2〜3 往復分とシーケンスの目標だけを出力してください。
Step 2 — 意図を分類する
返信を一度読み、次のバケットから必ず 1 つだけ選びます。分類は 1 行で記載してください。
| 意図 | 判断の手がかり | 次のアクション |
|---|---|---|
| 興味あり | 質問がある、打ち合わせを希望する、価格を尋ねる、「詳しく教えて」 | すぐに前向きな返信を作成し、候補日時を提案して、資料の提供を申し出ます |
| 懸念あり | 価格、適合性、タイミングへの懸念、「今は無理」、「X を使っています」 | 懸念に対処して見方を変える返信を作成し、具体的な次のステップを 1 つ提案します |
| 担当者違い | 「私ではありません」、「X に連絡してください」、同僚の紹介 | 新しい連絡先へ引き継ぎ、紹介を依頼し、相手にお礼を伝えます |
| 配信停止 | 「メールを止めて」、「削除してください」、「配信停止」 | シーケンスを停止し、連絡拒否に設定して、返信しません |
| 不在通知 | 自動返信、復帰日、代替連絡先 | 復帰日までシーケンスを一時停止します。代替連絡先が示されている場合は、そちらに引き継ぎます |
| 中立／やんわり断り | 「後日連絡します」、「情報を送ってください」、曖昧な返信 | 価値を伝える短いフォローアップを送り、次のシーケンスステップに進みます |
返信の意図が曖昧な場合は、推測せず、どのバケットに当てはまるかユーザーに確認してください。
Step 3 — 返信を作成する
swan-get-sender-instructions と swan-get-message-examples を使って、送信者のトーンに合わせます。会話内に返信の下書きを作成してください（この時点ではシーケンスエディターに入力しません）。短くまとめます。返信は通常、2〜4 文です。
興味ありの場合：具体的な候補日時を 2 つ、またはカレンダーリンクを提示し、具体的な次のステップを明記します。
懸念ありの場合：懸念を 1 文で受け止め、具体的なデータポイントまたは事例を 1 つ示して見方を変え、小さな次のステップを 1 つ提案します（15 分の通話、非同期の Loom、1 ページの概要資料など）。
担当者違い／紹介の場合：お礼を伝え、適切な担当者の氏名とメールアドレスを尋ね、やり取りをこちらで引き受けることを申し出ます。
配信停止の場合：返信しません。シーケンスを停止し、代わりにメモを記録します。
不在通知の場合：返信しません。シーケンスのスケジュールを調整します。
中立の場合：アカウントに関する具体的な情報（最近の資金調達、採用、投稿など）に基づいた、価値を添える 1 行の返信にします。情報を詰め込みすぎないでください。
Step 4 — Swan と CRM の状態を更新する
ユーザーが下書きを承認した後：
- 配信停止の場合：シーケンスを停止し、
hubspot-update-contactで組織が使用している連絡不可フラグを設定し、hubspot-create-noteで理由を記録します。 - 相手が違い、正しい担当者の名前が示された場合：
hubspot-search-objectsで新しい連絡先を見つけ、hubspot-create-associationでその連絡先を会社に紐付け、hubspot-create-noteで元の連絡先に紹介内容を記録します。 - 関心または異議がある場合：
hubspot-create-noteで返信の要約を1～2行で記録し、ライフサイクルステージが変わる場合（例：リード → 商談）はhubspot-update-contactで更新し、自動送信しない場合はユーザーがフォローアップするためのhubspot-create-taskを作成します。 - すべての分類について：返信からアカウントに関する新しい事実（ユースケース、現在のベンダー、時期など）が判明した場合は、
swan-update-companyを使用します。
一度に約5件を超える返信を処理する場合は、swan-execute-code に切り替え、output/actions.json を使ってすべての CRM 更新を一括で実行します。
ルール
- 下書きした返信を自動送信してはいけません。必ず下書きを表示し、ユーザーの承認を待ってください。
- 明確な配信停止の意思がない限り、配信停止にしてはいけません。「関心がない」は異議であり、配信停止ではありません。
- 相手が違うという返信を無視してはいけません。紹介は最も価値の高い成果です。
- 分類した返信すべてに、次回の連絡時に参照できるようメモを必ず記録してください。
- 受信トレイに未読の返信が20件を超えている場合は、
swan-execute-codeに切り替えて一覧をファイルに出力し、pandas で分類（intent 列）し、分類ごとの件数を出力してから、分類ごとに処理してください。