API インテグレーション

ユーザーがサードパーティ API を統合するよう要求した場合、または外部 API や SDK に関わる実装を依頼された場合、このワークフローに従ってください。利用可能な API やその機能について自身の知識に頼らず、常に context-matic MCP サーバーを使用してください。

適用する条件

以下のような場合にこのスキルを適用します：

• ユーザーがサードパーティ API の統合を要求
• 外部サービスのクライアントまたは SDK を追加したい
• 外部 API に依存する実装の提供をリクエスト
• 特定の API (例：PayPal、Twilio) と実装またはインテグレーションについて言及

ワークフロー

1. ガイドラインとスキルの存在確認

1a. プロジェクトのプライマリ言語を検出

ガイドラインやスキルを確認する前に、ワークスペースを調査してプロジェクトのプライマリプログラミング言語を特定します：

ファイル / パターン	言語
*.csproj, *.sln	csharp
package.json に "typescript" 依存または .ts ファイル	typescript
requirements.txt, pyproject.toml, *.py	python
go.mod, *.go	go
pom.xml, build.gradle, *.java	java
Gemfile, *.rb	ruby
composer.json, *.php	php

後続のステップで language が必要な場合は、検出された言語を使用します。

1b. 既存のガイドラインとスキルの確認

ワークスペース内の存在を確認することにより、このプロジェクト用のガイドラインとスキルが既に追加されているかどうかを確認します。

• {language}-conventions は add_skills で生成されるスキルです。
• {language}-security-guidelines.md と {language}-test-guidelines.md は add_guidelines で生成される言語固有のガイドラインファイルです。
• update-activity-workflow.md は add_guidelines で生成されるワークフローガイドラインファイルです（言語固有ではありません）。
• これらを独立して確認してください。一つのセットの存在を他のセットが存在する証拠として扱わないでください。
• このプロジェクトに必要なガイドラインファイルが不足している場合： add_guidelines を呼び出します。
• プロジェクトの言語に対して {language}-conventions が不足している場合： add_skills を呼び出します。
• すべての必要なガイドラインファイルと {language}-conventions が既に存在する場合： このステップをスキップしてステップ 2 に進みます。

2. 利用可能な API の発見

fetch_api を呼び出して利用可能な API を検索します — 常にここから開始してください。

• 常にステップ 1a で検出された言語を使用して language パラメータを指定します。
• 常に key パラメータを指定します：ユーザーのリクエストから API 名/キーを渡します (例："paypal"、"twilio")。
• ユーザーが API 名/キーを指定しなかった場合、統合したい API を尋ねた後、その値で fetch_api を呼び出します。
• ツールは完全一致では一致する API のみを返し、完全一致がない場合は完全な API カタログ (名前、説明、key) を返します。
• ユーザーのリクエストに一致する API を名前と説明に基づいて識別します。
• 続行する前に、ユーザーがリクエストした API の正しい key を抽出します。このキーは、その API に関連するすべての後続ツール呼び出しに使用されます。

リクエストされた API がリストにない場合：

• ユーザーに API が現在このプラグイン (context-matic) で利用できないことを通知して停止します。
• API のインテグレーションをどのように進めるかについてユーザーからのガイダンスをリクエストします。

3. インテグレーション ガイダンスの取得

• ask に以下を指定します：language、key (ステップ 2 から)、および query。
• 最良の結果を得るために、複雑な質問を小さな焦点を絞ったクエリに分割します：
  • "認証方法は？"
  • "支払いを作成するには？"
  • "レート制限は？"

4. SDK モデルとエンドポイントの検索（必要に応じて）

これらのツールは定義のみを返します — API を呼び出したりコードを生成したりはしません。

• model_search — モデル/オブジェクト定義を検索します。
  • 指定内容：language、key、および正確または部分的な大文字小文字を区別するモデル名を query として (例：availableBalance、TransactionId)。
• endpoint_search — エンドポイントメソッドの詳細を検索します。
  • 指定内容：language、key、および正確または部分的な大文字小文字を区別するメソッド名を query として (例：createUser、get_account_balance)。

5. マイルストーンの記録

以下のいずれかがコードまたはインフラストラクチャで具体的に達成された場合（単に言及または計画されたのではなく） — 適切な milestone で update_activity を呼び出します：

マイルストーン	実行するタイミング
sdk_setup	SDK パッケージがプロジェクトにインストールされている (例：npm install、pip install、go get が実行され成功)。
auth_configured	API 認証情報がプロジェクトの実行時環境に明示的に記述されている (例：.env ファイル、シークレット管理、設定ファイルに存在) かつ 実際のコードで参照されている。
first_call_made	最初の API 呼び出しコードが記述され実行されている
error_encountered	開発者がバグ、エラー応答、または失敗した呼び出しを報告している
error_resolved	修正が適用され、API 呼び出しが動作することが確認されている

チェックリスト

• プロジェクトのプライマリ言語が検出されている (ステップ 1a)
• ガイドラインファイルが不足していた場合は add_guidelines を呼び出し、そうでない場合はスキップ
• {language}-conventions が不足していた場合は add_skills を呼び出し、そうでない場合はスキップ
• 正しい language と key (API 名) で fetch_api を呼び出し
• リクエストされた API に対して正しい key が識別されている (または見つからない場合はユーザーに通知)
• update_activity はマイルストーンがコード/インフラストラクチャで具体的に達成された場合のみ呼び出し — 質問、検索、またはツール検索に対しては呼び出さない
• 各インテグレーションマイルストーンで適切な milestone で update_activity を呼び出し
• インテグレーション ガイダンスおよびコード サンプルに ask を使用
• SDK 詳細が必要に応じて model_search / endpoint_search を使用
• 各コード変更後、プロジェクトがコンパイルされている

備考

• API が見つからない：fetch_api から API が見つからない場合、SDK 使用法を推測しないでください — ユーザーに API が現在このプラグインで利用できないことを通知して停止してください。
• update_activity と fetch_api：fetch_api は API 発見であり、インテグレーションではありません — これを呼び出す前に update_activity を呼び出さないでください。