AgentCore プロジェクトを検出する
ディスカバリは、他のすべてのスキルが信頼するパスです。証拠（すべての主張に対するファイルと行番号）とともに回答し、答えられない場合は「未解決」と報告します。リージョンや所有者を誤ると、後続のすべてのステップが誤ったものになるためです。たとえば、Terraform で生成されたゲートウェイが、AgentCore CLI がすでに所有しているリソースと競合し、デプロイのたびに競合が発生します。
${CLAUDE_SKILL_DIR} は、スキルランタイムによってこのスキル自身のディレクトリに設定されます。以下のすべてのコマンドでそのまま使用してください。兄弟スキルのスクリプトは ${CLAUDE_SKILL_DIR}/../<skill>/scripts/ にあります。
フロー
-
検出.
python3 ${CLAUDE_SKILL_DIR}/scripts/discover.py <project>--jsonで構造化形式、--focus agentcore,app,auth,region,terraform,tracingで範囲を絞ります。リポジトリルートを指定してください。サブディレクトリを指定すると、モジュール呼び出しや Terragrunt スタックが解決されません。 -
報告 は以下の順序で
Foundブロックを表示します: AgentCore（ドアとリソース）、アプリケーション（フレームワーク、MCP サーバー、/mcpルートとその背後にある Lambda）、認証、リージョン（可用性行を含む）、Terraform（制約、ロック、Terragrunt）、トレーシング。次にMissing、その後に findings。 -
オプション. レポートの
Optionsセクションは順序付けされており、各オプションに費用層が 1 つずつ付いています。読み上げてください。新しいオプションを発明しないでください。 -
確認 は
AskUserQuestionで次のスキルをユーザーに確認し、Skillで呼び出します。ディスカバリ自体は何も書き込みません。 -
検証は不要: ディスカバリには確認すべき副作用はありません。ユーザーが事実（リージョンや所有者など）を修正した場合は、修正された入力を使用して再実行し、レポートを上書きしないでください。
検出するもの
| 質問 | 読み取る証拠 | 詳細 |
|---|---|---|
| AgentCore が使用されているか、誰が所有しているか？ | .tf、CDK ソース、agentcore.json、.bedrock_agentcore.yaml、boto3 呼び出し | what-discovery-detects.md |
| どのフレームワークと MCP サーバーか？ | インポート、デコレータ、registerTool、FastMCP | framework-signatures.md |
| どのリージョンで、何が提供されているか？ | provider ブロック、変数デフォルト、Terragrunt、tfvars | lib/agentcore_skills/data/regions.json のリージョンテーブル |
| 現在のトークンの動作は？ | aws_cognito_*、aws_apigatewayv2_authorizer | what-discovery-detects.md |
DSC0xx 帯
| ID | 重要度 | トリガー |
|---|---|---|
DSC001 | エラー | 読み取るものがない: Terraform、コード、コンテナ、マニフェストのいずれも存在しない |
DSC002 | 警告 | AWS リージョンを解決できなかった |
DSC003 | 警告 | スターターキット設定（その CLI はサポート終了） |
DSC004 | 警告 | AgentCore が複数のツール（Terraform、CDK、AgentCore CLI）で宣言されている |
DSC005 | 警告 | コアサービスが解決されたリージョンで提供されていない |
決定ルール
- エイリアスなしの provider がリージョンを決定します。 CloudFront 証明書用にエイリアスされた
us_east_1provider はリストに含まれますが、選択されません。 /mcpで終わるルートは MCP エンドポイントです。 その背後にある Lambda は名前ではなく統合によって見つけられます。- 存在しないことは「見つからない」であり、「存在しない」ではありません。 パターンは TypeScript で否定を証明できません。検索した内容を述べてください。
スクリプト
| コマンド | 動作 | 終了コード |
|---|---|---|
scripts/discover.py <project> [--focus ...] [--json] | インベントリとギャップレポート | 0: ブロックなし、1: エラーあり、2: 不正なターゲット |
完了チェックリスト
-
discover.pyがリポジトリルートに対して実行され、その出力が表示された。 - リージョン、その証拠、および可用性行が示された。
- すべての AgentCore 所有者（Terraform、CDK、AgentCore CLI、ツールキット）が名前で示されたか、または「まだなし」と示された。
- 推奨オプションがその費用層とともに提示され、ユーザーが選択した。