integrate-context-matic

API 統合

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

適用する条件

次の場合に、このスキルを適用してください。

• サードパーティ API の統合を依頼された場合
• 外部サービス用のクライアントや SDK の追加を希望された場合
• 外部 API に依存する実装を依頼された場合
• 特定の API（例：PayPal、Twilio）について、実装または統合に言及された場合

ワークフロー

1. ガイドラインとスキルが存在することを確認する

1a. プロジェクトの主要言語を特定する

ガイドラインやスキルを確認する前に、ワークスペースを調べてプロジェクトの主要なプログラミング言語を特定してください。

ファイル／パターン	言語
*.csproj, *.sln	csharp
"typescript" 依存関係を含む package.json または .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 によって作成されるワークフローガイドラインファイルです（言語固有ではありません）。
• これらは個別に確認してください。一方のセットが存在することを、もう一方のセットも存在する証拠として扱わないでください。
• このプロジェクトで必要なガイドラインファイルが1つでも不足している場合： add_guidelines を呼び出してください。
• プロジェクトの言語に対応する {language}-conventions が不足している場合： add_skills を呼び出してください。
• 必要なガイドラインファイルと {language}-conventions がすべて存在する場合： この手順を省略して、手順2に進んでください。

2. 利用可能な API を見つける

利用可能な API を探すには fetch_api を呼び出してください。必ずここから開始します。

• 必ず language パラメーターに、手順1aで特定した言語を指定してください。
• 必ず key パラメーターを指定してください。ユーザーの依頼にある API 名／キー（例："paypal"、"twilio"）を渡します。
• ユーザーが API 名／キーを指定していない場合は、統合したい API を尋ねてから、その値を指定して fetch_api を呼び出してください。
• ツールは、完全一致した場合は一致する API のみを返します。完全一致しない場合は、API カタログ全体（名前、説明、key）を返します。
• 名前と説明に基づいて、ユーザーの依頼に一致する API を特定してください。
• 先に進む前に、ユーザーが指定した API の正しい key を抽出してください。このキーは、その API に関する以降のすべてのツール呼び出しで使用します。

依頼された API が一覧にない場合：

• その API は現在このプラグイン（context-matic）では利用できないことをユーザーに伝え、そこで終了してください。
• API 統合をどのように進めるか、ユーザーに指示を求めてください。

3. 統合ガイダンスを取得する

• language、手順2で取得した key、および query を指定して ask を呼び出してください。
• 複雑な質問は、より小さく具体的な質問に分けると、最適な結果が得られます。
  • 「認証方法を教えてください」
  • 「支払いの作成方法を教えてください」
  • 「レート制限を教えてください」

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 が見つからない場合：API が fetch_api で見つからない場合は、SDK の使い方を推測しないでください。この API は現在このプラグインでは利用できないことをユーザーに伝え、そこで終了してください。
• update_activity と fetch_api：fetch_api は API の検出であり、統合ではありません。fetch_api を呼び出す前に update_activity を呼び出さないでください。