autonomous-agent-patterns

🕹️ 自律型エージェントのパターン

Cline と OpenAI Codex に着想を得た、自律型コーディングエージェントの構築パターンです。

詳細ガイド

このスキルを実行する前に、詳細ガイドをお読みください。ガイドには、手順と参考資料がすべて記載されています。安全性、前提条件、検証要件は必須事項として扱ってください。作業範囲を絞る場合は関連するセクションを読み、最初から最後まで作業する場合はガイド全体をお読みください。

このスキルを使用する場合

次のような場合にこのスキルを使用します。

• 自律型AIエージェントを構築する
• ツール／関数呼び出しAPIを設計する
• 権限と承認のシステムを実装する
• エージェント向けのブラウザー自動化を作成する
• 人間参加型のワークフローを設計する

---

制限事項

• 上記の範囲にタスクが明確に該当する場合にのみ、このスキルを使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中止して確認してください。

認可と実装の制限

ここに示すクラスは、インポート、型、アダプター、ヘルパーが欠けた概念上の断片であり、動作するCline／Codex／MCPの実装ではありません。response.to_history_messageは実際のプロバイダー向けに実装するアダプター契約であり、標準SDKメソッドではありません。MCPクライアントには、実際のトランスポート／セッションとライフサイクルが必要です。Server(config)のスケッチは、有効なクライアントハンドシェイクではありません。生成されたサーバーコードは、レビューされるまで動作しません。

ツール名だけに基づくセッション承認は、許可範囲が広すぎます。認可は具体的なアクション、対象、データ、制限に紐づけ、範囲内で既存のユーザー認可を再利用してください。読み取りツールもシークレットを漏えいさせるおそれがあり、npm／python／node／gitは任意のコードを実行できます。これらの名前を許可リストに登録したり、cwd／HOMEを設定したりしても、サンドボックスにはなりません。モデルの制御外でファイルシステム／ネットワーク／プロセスの境界を適用し、範囲外のパスやシンボリックリンクのパスを拒否し、スキーマを検証し、すべてのツール／LLM呼び出しと出力に予算上限を設けてください。承認UIや部分文字列によるコマンドチェックだけでは、セキュリティ境界として機能しません。

ファイル編集では、元の内容との競合チェックと安全なアトミック置換が必要です。チェックポイントには、検証済みのセッションID、プライベートなアトミックファイル、実際のワークスペースのスナップショット／復元戦略が必要です。Gitの状態や参照情報だけでは、未コミットの内容を復元できません。ファイルサイズとコンテキストに上限を設け、認証情報を除外し、外部コンテンツを信頼できないデータとして明示してください。ブラウザーのTreeWalkerが取得するテキストはアクセシビリティツリーではなく、表示テキストであるとも限りません。networkidleや概算座標だけでは、アクションの正しさを確認できません。現在観測されているUIの対象を使い、結果を検証してください。レビュー中にエージェント、ツール、ブラウザー、または生成されたサーバーは実行されていません。