1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Routines による issue トリアージ自動化:スケジュールトリガーの仕様と制約

1
Posted at

Routines は、スケジュール・API・GitHub などのトリガーに応じて Claude を自律実行させる仕組みです。本稿では、毎朝の issue トリアージ(新規 issue の読み取り・ラベル付け・オーナー割り当て・Slack への要約投稿)をスケジュールトリガーで自動化する構成を、公式ドキュメントの検証済み記述に沿って整理します。すべての技術的記述の出典は末尾の [1] です(2026-10-04 検証)。

提供状況とプラン

Routines は 2026-10-04 時点でリサーチプレビュー段階にあり、動作・制限・API 仕様は変更される可能性があります [1]。利用可能なプランは Pro・Max・Team・Enterprise です [1]。

Routines are in research preview. Behavior, limits, and the API surface may change.

本番の重要フローへ組み込む前に、仕様変更があり得る前提で評価することが前提になります。

スケジュールトリガーの構成例

スケジュールトリガーを使うと、毎平日夜に issue トラッカーをコネクタ経由で読み取り、前回実行以降に開かれた issue にラベルを付け、参照コード領域に基づいてオーナーを割り当て、Slack に要約を投稿する、というバックログメンテナンス routine を構成できます [1]。これにより、チームは整理済みのキューから一日を始められます。

スケジュールの制約(間隔・タイムゾーン・起動遅延)

スケジュールの最小実行間隔は 1 時間(2026-10-04 時点)で、これより短い cron 式は拒否されます [1]。時刻はローカルタイムゾーンで入力すると自動的に変換され、クラウドインフラの所在地に関わらず指定した壁時計時刻に実行されます [1]。

正時ちょうど(例: 9:00)にスケジュールした run は数分遅れて起動することがあります。遅延を抑えるには、正時を少し過ぎた時刻(例: 9:07)を指定します [1]。

プロンプトの要件とコネクタ

routine は自律実行されるため、プロンプトは「何をするか」と「何が成功か」を明示した自己完結型でなければなりません [1]。routine を作成すると、アカウントに現在接続済みのすべての MCP コネクタがデフォルトで含まれます [1]。

レート制限

スケジュール実行(ワンオフ含む)はアカウント合計で 1 時間あたり 100 回が上限で、上限に達した run は制限リセットまで待機します [1]。Run now・API 起動・ワンオフ再実行の 3 操作は routine ごとに合算され、1 時間あたり 30 回が上限で、超過するとリセットまでそのアクションは失敗します [1]。

GitHub トリガーと接続の扱い

GitHub トリガーの Webhook イベントには routine ごと・アカウントごとの 1 時間あたり上限があり、超過分は次のウィンドウがリセットされるまでドロップされます [1]。routine が GitHub に push する際、変更はデフォルトで claude/ プレフィックス付きのブランチに作られます [1]。GitHub 接続が失効・欠落した状態で実行時刻を迎えると、routine は実行をスキップしながら最長 72 時間まで再接続を待機します [1]。72 時間経過後の挙動は 2026-10-04 時点のドキュメントに明記がありません。

実行ステータスの意味

実行一覧のグリーンステータスは、セッションが起動しインフラエラーなく終了したことを示すのみで、プロンプトのタスク成功を意味しません [1]。

A green status in the run list means the session started and exited without an infrastructure error. It does not mean the task in your prompt succeeded.

作成方法とトリガーの組み合わせ

任意のセッションで /schedule を実行すると会話形式でスケジュール routine を作成でき、/schedule daily PR review at 9am のように説明を直接渡すこともできます [1]。1 つの routine には複数のトリガーを組み合わせて付与できます [1]。

References

[1] https://code.claude.com/docs/en/routines

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?