メインコンテンツへスキップ
ローカルツールでプルリクエストを調べ、厳密な JSON のレビュー計画を返し、計画が承認を必要とする場合は人の判断を待って一時停止する TypeScript エージェントを作成します。完成すると、検証済みの CodeReviewPlan を出力し、誰かが承認するまで waiting_for_human で停止するスクリプトが 1 つできます。 ツールは固定のサンプルデータを返すため、このスクリプトは例示用です。実際にはコードホスティングサービスや CI への呼び出しに置き換えてください。パッケージ化した版は packages/sdk/agent-sdk-ts/examples/coding-review-agent.ts にあります。

作成する

1

インストールする

2

エージェントを書く

review-agent.ts
responseFormat によって Gateway はこのスキーマでリクエストし、outputSchema はパースした結果をプロセス内で再度確認します。strict モードのレスポンス修復は、すでに有効な JSON の包みを外すだけです。
3

実行する

動作を確認する

  • イベントログに、両方のツールの tool.started と tool.completed が表示され、ツールのステップの後に checkpoint.saved が表示されます。
  • needsApproval: true の計画では、最初の実行が waiting_for_human で終わり、計画は result.run.pause.payload に入ります。APPROVE=yes を付けると completed まで続行します。
  • 設定 → 利用状況 → ログ では、各モデルターンにツール呼び出しが表示され、リクエストのプラグイン記録で修復が実行されたかどうかがわかります。
  • スキーマに違反する計画は、不正なデータを返す代わりに AgentSchemaValidationError で実行を失敗させます。

実際のリポジトリで安全に使う

レビュー用のツールは読み取り専用にしてください。コメント、プッシュ、マージを行うツールを追加する場合は、そのツールに requireApproval: true を設定して実行前に一時停止させ、continueRun({ run, client, approvals: [toolCallId] }) で承認します。diff の内容は信頼できない入力として扱ってください。コードコメントにモデルを狙った指示が含まれている場合があります。レビューの待機中に再起動しても状態を保てるように、永続化可能なループのように state アクセサーで実行を保存してください。承認と却下については状態と承認で説明しています。
最終更新日 2026年11月5日