Communityライティング&編集github.com

rogerchappel/connector-route-replay-skill

コネクタルーティングのフィクスチャをローカルで再生し、承認ゲートを説明します。

connector-route-replay-skill とは?

このスキルは、AIエージェントがコネクタルーティングの動作を検証するために使用します。具体的には、ローカルのフィクスチャファイル(JSONまたはYAML)からルート設定を読み込み、リクエスト、候補、期待される結果を再現します。また、ブロックされたツール、承認が必要なインテント、ドライランが必要な副作用を定義したポリシーJSONをオプションで指定できます。このスキルは、実際のコネクタを呼び出さず、認証情報も読み取らず、外部システムを一切変更しないため、安全にルーティング動作を検証できます。主にClaude Code、Cursor、CodexなどのAIエージェント向けに設計されており、ツールの有効化前やドライラン実行前に動作計画を確認する際に有用です。

対応~Claude Code~Codex CLI~Cursor
npx skills add rogerchappel/connector-route-replay-skill

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

コネクタルート再生スキル

使用タイミング

エージェントがツールを有効化したり、承認を求めたり、ドライランのアクションプランを表示したりする前に、ローカルのフィクスチャからコネクタルーティングの動作を検証する必要がある場合にこのスキルを使用します。

必須入力

  • request、candidates、およびオプションの expected フィールドを含む JSON またはシンプルな YAML ルートフィクスチャ。
  • blockedTools、approvalRequiredIntents、dryRunRequiredSideEffects を含むオプションのポリシー JSON。

副作用の境界

デフォルトのコマンドはローカルファイルを読み取り、レポートを標準出力に書き込むのみです。このスキルはライブコネクタの呼び出し、認証情報の読み取り、メッセージの投稿、CRM の更新、外部システムの変更を行ってはなりません。

承認要件

  • 外部への書き込み、破壊的なアクション、認証情報へのアクセス、中/高リスクの書き込みインテントには明示的な承認が必要です。
  • ブロックされたツールはブロック済みとして報告され、実行してはなりません。
  • ドライランのみのルートは、アクションを実行するためではなく、計画を準備するために使用できます。

例

connector-route-replay replay fixtures/read-only-route.json --format markdown
connector-route-replay replay fixtures/write-action-route.yaml --format json
connector-route-replay verify fixtures --policy examples/policy.json

検証ワークフロー

別のリポジトリでこのスキルに依存する前に、以下を実行してください。

npm run check
npm test
npm run smoke
npm run package:smoke

関連スキル