Orca Botsの活用例:GitHub・Slack・予定でAIエージェントが自律起動する

公開 更新 13 分で読了
Orca Botsの活用例:GitHub・Slack・予定でAIエージェントが自律起動する

Orca BotsをGitHubのCI失敗、Slackのバグ報告、Linearの新規Issueで使う例を紹介します。Claude CodeやCodexへの作業の分け方、スマホでの承認、外部からの入力を扱うときの権限を整理し、最初に使える依頼文も載せています。

Orca Botsは、GitHubのチェック失敗やSlackのメンション、決まった時刻をきっかけにAIエージェントを動かす、Orcaの機能です。Orca本体はmacOS・Windows・Linuxで無料で使え、Botは手元の実行マシンにあるClaude CodeやCodexの契約枠を使います。CIの原因を調べて報告するところから、担当を分けて修正・テスト・プルリクエスト(PR)を用意するところまで任せられます。

Orca Botsとは何か

OrcaのBotには「CIの失敗を調べる」などの役割と、仕事を始める条件を持たせられます。Botはホストと主担当のエージェントを持ち、コード変更が必要な場合はClaude CodeやCodexのワーカーに作業を渡します。Orcaや各エージェントのセットアップは、OrcaでClaude CodeとCodexを動かす手順で確認できます。

Orcaでトリガー、エージェント、権限、ホスト、スケジュールを指定する実画面

Botはこの「オートメーションの作成」画面で、トリガー・担当エージェント・権限・ホスト・スケジュールを決めます。

どんなイベントで起動できるか

Orca Botsは、依頼を受けたとき、接続先で条件に合うイベントが起きたとき、設定時刻になったときに仕事を始められます。たとえば、よくある問い合わせはSlackのメンションで受け、見落としたくないCI失敗はGitHubから拾うと、依頼の出し方を業務ごとに分けられます。

イベント、スケジュール、スマホからBotに仕事を渡す概念図

即時のイベント、定期実行、手動依頼のうち、仕事に合う入口を選びます。

入口 きっかけ・使い方
Slack チャンネルでBotをメンションするか、DMで依頼します。
GitHub Issue・PRでのメンション、チェック失敗、レビュー依頼などを使えます。
Linear Issueで @Orca <handle> と指定するか、Botのラベルを付けます。新規Issueを拾うルールも作れます。
Gmail 新着メールを条件に起動できます。Googleのサインイン情報は実行マシン側に置かれます。
Google カレンダー 会議の開始前に関連Issueや資料の要点を集めます。
Sentry 連携先として公式紹介に掲載。起動イベントの詳細は未確認です。
Vercel 連携先として公式紹介に掲載。起動イベントの詳細は未確認です。
Notion 連携先として公式紹介に掲載。起動イベントの詳細は未確認です。
Webhook 接続元のツールやスクリプトから1リクエストで自動化を起動します。
スケジュール 平日9時など、決めた時刻に動かします。
スマホ iOS・Androidのアプリから、ペアリング済みのホストへ手動で仕事を依頼します。

同じサービスでも、起動のきっかけとBotの書き込み先は別に決めます。たとえばGmailの新着で起動しても、返信を送る前に下書きで止められます。使えるイベントと実行時のアカウントは公式のコネクタ一覧で確認できます。

役割別Botの活用例

Orca Botsの公式デモには、バグ調査、CI監視、PRレビューなど、担当を絞った6つのBotが登場します。仕事の名前だけでなく、Botから受け取る成果物を決めておくと、そのまま修正に進むか、人が判断するかを明確にできます。

Scout、CI Watch、Review buddy、Release notes、Standup、Docs helperの6役

何を受け取ると次の判断が早くなるかを考え、Botの担当を決めます。

公式デモのBot 任せる仕事と受け取るもの
Scout バグの報告から再現条件を整理し、修正候補を出します。修正を任せる場合は、テスト結果とPRを受け取ります。
CI Watch 失敗したテストを調べ、同条件で成功・失敗が揺れるテストか、再現する失敗かを切り分けます。判定の根拠になるログと未確認事項を受け取ります。
Review buddy PRの差分を読み、影響が大きい変更や足りないテストを指摘します。どこを見直せばよいか分かるよう、ファイル名と行を添えます。
Release notes リリース対象の変更点を読み、利用者向けの告知案を作ります。社内向けの修正名を、利用者に見える変化へ言い換える仕事に向きます。
Standup 日次の進捗をまとめ、指定チャンネルに投稿します。終わったこと、作業中のこと、人の判断を待つことを分けて受け取れます。
Docs helper 仕様変更で古くなった説明を探し、ドキュメントを修正するPRを作ります。コード変更と説明の食い違いをレビューできます。

公式紹介には24種類のテンプレートがあり、Bug investigation、Pull request review、CI failures、Meeting prepが例示されています。定期実行が付くテンプレートでも初期状態ではスケジュールがオフなので、対象のリポジトリやチャンネルと、結果の受け取り先を決めてから使い始めます。

具体ワークフロー例

Slackのバグ報告では修正PR、mainのCI失敗では原因の要約、Linearの新規Issueでは担当や重複候補を受け取る形にすると、作業の終点が見えます。以下は公式デモの例をもとに、チームで試すときの確認点を加えた流れです。

Slackの報告、CIの失敗、新規Issueをそれぞれ成果物につなぐ3本の流れ

起動条件ごとに、Botに任せる範囲と受け取る成果物を決めます。

Slackの不具合報告をテスト付きPRにつなげる

公式デモでは、Safariで決済ボタンが反応しないというSlackの依頼から調査が始まります。ワーカーが別worktreeで修正し、WebKitのテストを通して、例示のPR acme/web#1287 を返します。

  1. 再現条件を渡す。 SlackでScoutをメンションし、対象リポジトリ、該当画面、ブラウザ、期待した結果を伝えます。
  2. 修正に進む条件を決める。 まず再現の有無、原因候補、変更する箇所を受け取ります。修正へ進めた場合は、修正前に失敗し、修正後に通るテストを求めます。
  3. PRの差分と証拠を確認する。 Slackの返信からPRを開き、対象画面の動作とテスト結果を照合します。テストに含める操作の考え方は、Claude Codeで画面のE2Eテストを作る手順も参考になります。

mainのCI失敗を調べて要約する

GitHubの失敗チェックでCI Watchを起動し、最初に落ちたテスト、失敗した実行へのリンク、直前まで通っていた実行との差をまとめさせます。再実行で通った場合も、原因が分かるまでは「不安定なテストの疑い」として根拠を残すと、同じ失敗が続いたときに比較できます。

最初の設定に使える依頼文です。対象のリポジトリとブランチを置き換えて使います。

対象リポジトリのmainでCIが失敗したら、失敗したチェック、最初のエラー、実行へのリンク、直前の成功との差をまとめてください。同じ条件で失敗が再現するかは、確認済みと未確認を分けてください。コードの編集、再実行、GitHubへの書き込みは承認を待ってください。

Linearの新規Issueを振り分ける

公式デモの「Triage new bugs」では、Linearの新規バグを拾い、担当の移動や重複のクローズまで扱います。初回は担当候補、重複候補へのリンク、同じ問題だと判断した根拠を受け取るところまでにすると、誤って別の不具合を閉じる前に確認できます。

たとえば決済の報告が2件来ても、発生端末と再現条件が違えば別のIssueとして調べる余地があります。候補を事前に並べてもらえば、担当者は原文と再現条件を見比べて、移動やクローズを判断できます。

複数エージェントを並列で走らせる

Orca Botsは、Claude CodeやCodexのワーカーに仕事を分け、ワーカーごとに別のGit worktreeで作業させられます。worktreeは同じリポジトリから切り出した作業フォルダです。修正担当がファイルを書き換えている間も、別のワーカーは元の状態を保った作業フォルダで原因を確かめられます。

一つのBotが修正、回帰テスト、他ブラウザ確認を並列に振り分ける概念図

修正、テスト、他ブラウザの確認を分け、最後に証拠を突き合わせます。

公式デモのSafariの例では、Claude Codeが修正し、CodexがWebKitで不具合を再現するテストを用意し、別のClaude CodeワーカーがChromeとFirefoxを確かめます。作業を分ける際は、修正担当とテスト担当が見る開始時点をそろえ、最後に修正ブランチで再現テストを通すと、どの変更で動きが変わったかを追えます。

方針が決まっていない案件なら、ワーカーを起動する前に「変更箇所」「成功と見なすテスト」「修正範囲」を書き出します。実装の前提や確認項目を詰める方法は、Claude CodeのPlan Modeで計画を見直す例で確認できます。

承認とスマホで止める/進める

Botが質問や承認を求めると、iOS・AndroidのOrcaアプリの Needs you 一覧で確認できます。公式デモでは、Safariの修正を一部だけに有効化するか、全員に出すかを選んでワンタップで回答できます。外出先から新しい依頼を送ることもでき、処理はペアリングしたホストで続きます。

Botの調査結果からNeeds youで承認または保留する流れ

Botから判断が求められたら、次に進めるか、確認が済むまで保留するかを決めます。

承認を使うときは「何を確認したら進めるか」も伝えておきます。たとえば「PRを作る前に変更対象、テスト結果、未確認の環境を出す」と決めておくと、スマホで情報が足りないときにも保留できます。

詳しく調べたいときは、デスクトップの作業タブでエディタ、ターミナル、ブラウザ、コンピュータ操作、PRレビューを開けます。テスト結果だけで判断しづらい場合は、該当worktreeの差分と実行結果を照合してから続きの作業を依頼します。 公式モバイルガイド

【重要】権限とセキュリティ

公式のテンプレート紹介は、まず報告して、同意を得てから変更する進め方を示しています。一方、Botの新規会話は個別設定がなければチャットの権限を継承します。Botセキュリティ文書によると、Orcaのチャット既定は Full access で、そのままではコマンド実行やファイル編集の前にエージェントが承認を求めません。

イベントの入力、実行権限、変更前の承認を確認する概念図

受け付ける入力、使える権限、変更前の承認をそれぞれ確認します。

外部の文章を読むBotは権限と起動条件を絞る

GitHub Issue、Slackのメッセージ、メール本文には、Botの処理を別の方向へ誘導する指示が入り込むことがあります。これはプロンプトインジェクションと呼ばれます。Orcaは外部の内容を情報として扱うようBotに指示しますが、公式文書はモデルが指示に誘導される可能性も説明しています。

確認するもの 最初に決める範囲
読む場所 テスト用リポジトリや運用担当のチャンネルなど、必要な範囲だけを接続します。
起動させる人・イベント Who can ask に加えて、イベントルールの対象を確認します。依頼者を制限しても、条件に合うイベントで自動化が始まる場合があります。
実行権限 対応エージェントの Ask for approval を選びます。設定変更前から開いている会話は元の権限を維持するため、新規会話で確かめます。
承認する操作 PR作成、Issueの移動やクローズ、メール送信、デプロイなど、外部に影響する操作を事前に決めます。
Webhook URLを非公開にし、接続元を検証できるよう署名用の秘密情報を設定します。

BotがGitHubやLinearで別の場所へ書き込む場合、ホスト上の利用者のアカウントを使う操作があります。worktreeで分かれるのは作業ファイルやブランチなので、不要なアカウントやコネクタは外し、接続先でも付与する権限を絞ります。Orca側の設定に加え、記事718の権限モードの説明も確認できます。

手元で実行するときのデータの行き先を確認する

Slack・GitHub・Linearからの依頼はOrca Cloudを経由し、実行マシンが外向きに接続して受け取ります。そのため受信ポートを開ける必要はありません。Botの役割や記憶は読み書きできるMarkdownで保持され、Botが学んだ内容を手元で確認できます。

Googleのサインイン情報はマシン上に保持されますが、Botが読んだメールや資料の内容は、処理のためエージェントのモデル提供元へ送られる場合があります。Slackなどへの要約に含まれる可能性もあるため、機密の受信箱や資料をつなぐ場合は、どの内容を読み、どこへ返してよいかを先に決めます。 公式のデータと権限の説明

FAQ

Orca Botsを試す業務を選ぶには、起動条件、受け取る成果物、人が承認する操作の3つを決めます。たとえば「mainのCI失敗を拾い、原因候補だけを返す」なら、調査の品質を確かめてから作業範囲を広げられます。

導入前に起動条件、成果物、承認点を決めるための図

最初に任せる1件について、きっかけ、成果物、承認点を決めます。

Orca Botsの料金はいくらですか?

Orca本体は無料で、Botが使うモデルは既存のClaude CodeやCodexなどの契約で動かす方式です。Orcaによるモデル利用料の上乗せはなく、実行分は使っている契約の利用枠や条件に従います。 Orca Bots公式

どのサービスをコネクタとして使えますか?

起動に使える接続先にはSlack、GitHub、Linear、Gmail、Google カレンダー、Webhookがあります。作業先としては端末からつなぐGoogle Drive・Docs・Sheetsのほか、公式紹介にNotion、Sentry、Vercel、Datadog、PostHog、Supabase、Stripe、Atlassian、HubSpotが掲載されています。MCPサーバーやスキルを追加でき、Composioを使う場合は自分のキーで接続先を増やせます。 公式のコネクタ一覧

自社の業務に当てはめるなら、何から始めますか?

普段から判断基準が決まっている作業が向いています。開発チームならCI失敗の要約、サポートならバグ報告の再現条件の整理、会議の準備なら開始前に関連Issueと資料を1枚にまとめる仕事から始められます。

Macだけで使えますか?

デスクトップ版はmacOS・Windows・Linuxに対応します。iOS・Androidはペアリングしたホストのセッションを確認し、依頼や承認を送るためのアプリです。 公式ダウンロード

自動実行で最初に気をつけることは何ですか?

最初は起動元と接続先を絞り、読み取りと報告を中心に使います。変更を任せる段階では、Botの権限と、どの人が承認できるかを確かめ、外部に影響する操作は人が承認する形にします。

よくある質問

Q. Orca Botsの料金はいくらですか?
Orca本体は無料で、Botが使うモデルは既存のClaude CodeやCodexなどの契約で動かす方式です。Orcaによるモデル利用料の上乗せはなく、実行分は使っている契約の利用枠や条件に従います。
Q. どのサービスをコネクタとして使えますか?
起動に使える接続先にはSlack、GitHub、Linear、Gmail、Google カレンダー、Webhookがあります。作業先としては端末からつなぐGoogle Drive・Docs・Sheetsのほか、公式紹介にNotion、Sentry、Vercel、Datadog、PostHog、Supabase、Stripe、Atlassian、HubSpotが掲載されています。MCPサーバーやスキルを追加でき、Composioを使う場合は自分のキーで接続先を増やせます。
Q. 自社の業務に当てはめるなら、何から始めますか?
普段から判断基準が決まっている作業が向いています。開発チームならCI失敗の要約、サポートならバグ報告の再現条件の整理、会議の準備なら開始前に関連Issueと資料を1枚にまとめる仕事から始められます。
Q. Macだけで使えますか?
デスクトップ版はmacOS・Windows・Linuxに対応します。iOS・Androidはペアリングしたホストのセッションを確認し、依頼や承認を送るためのアプリです。
Q. 自動実行で最初に気をつけることは何ですか?
最初は起動元と接続先を絞り、読み取りと報告を中心に使います。変更を任せる段階では、Botの権限と、どの人が承認できるかを確かめ、外部に影響する操作は人が承認する形にします。

出典・参考データ

  1. [1] Orca Bots 公式紹介
  2. [2] Bots quickstart
  3. [3] Bot connectors
  4. [4] Bot security
  5. [5] Worktrees
  6. [6] Mobile companion
  7. [7] Scheduled automations
  8. [8] Orca公式ダウンロード
  9. [9] Orca公式リポジトリ

この記事を書いた人

水島 翔吾

株式会社kairos 代表取締役 / AgentSignal 開発者

AI クローラー・AI 流入計測と AIO 診断ツール AgentSignal を開発。実測データを元に AI 検索時代の計測と対策を書いています。

関連記事