strands-agents/agent-sop

解決する問題

AI エージェントは、一貫した手順に従う構造化された方法がないため、複雑な複数ステップのタスクに苦労することがよくあります。Agent SOP は、ワークフローを制約（MUST、SHOULD、MAY）とパラメータ化された入力を備えた明確なステップに分解する Markdown ベースの指示セットを提供することで、この問題を解決します。これにより、エージェントの動作がさまざまな AI システム間で再現可能で、共有可能で、信頼できるものになります。

仕組み

各 SOP は、概要、パラメータ、ステップ、制約などのセクションを持つ Markdown ファイルです。パラメータにより、同じ SOP を異なる入力で再利用できます。ステップでは、RFC 2119 キーワードを使用して、エージェントが各指示に従う厳密さを制御します。パッケージ（strands-agents-sops）は、これらの SOP を他の形式に変換することもできます：MCP サーバープロンプト（Kiro CLI や Claude Code などのツール用）、Cursor IDE コマンド、Claude および互換エージェント用の Agent Skills（SKILL.md ファイル）。これにより、必要なときに関連するワークフローのみを読み込むことができます（プログレッシブディスクロージャー）。

対象読者

AI エージェント（コーディングエージェントなど）を使用し、コード実装、コードベース分析、計画、評価などの複雑なタスクを一貫した品質で実行させたい開発者とチーム。エージェントベースの開発ワークフローを設定し、プロジェクトやツール間で共有したい人にとって役立ちます。

ハイライト

• 明確な目的、パラメータ化された入力、ステップバイステップの指示、例を備えた Markdown ベースの SOP 形式。
• RFC 2119 制約（MUST、SHOULD、MAY）により、堅苦しいスクリプトなしで正確な制御が可能。
• 既製の SOP が付属：codebase-summary、pdd、code-task-generator、code-assist、eval。
• MCP プロンプトとして提供、Cursor コマンドに変換、または Agent Skills として生成可能。
• 外部 SOP は独自のディレクトリ（.sop.md ファイル）から読み込め、先勝オーバーライド。
• 定義されたディレクトリ構造（.agents/）が PDD ファミリーの SOP の出力を整理し、コミットとコンテキスト固定を容易にします。