mcpField
A
alicloud-platform-openapi-product-api-discovery

alicloud-platform-openapi-product-api-discovery

github.com/cinienceクラウド・DevOps396275 回インストール11 週間前に更新
リポジトリ

alicloud-platform-openapi-product-api-discovery について

Alibaba Cloud向けスキルを計画する人のためのワークフロースキルです。製品一覧を集約し、OpenAPIメタデータとAPI資料を取得して、集計結果を作成します。

主な機能

  1. 013つの情報源から製品一覧を取得
  2. 02製品データの統合と正規化
  3. 03OpenAPI製品・APIメタデータの取得
  4. 04カテゴリ別の製品集計
  5. 05既存スキルとの任意比較

活用シーン

  1. 01Alibaba Cloud製品一覧の集約
  2. 02製品ごとのAPI情報の確認
  3. 03スキル計画対象の製品選定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cinience/alicloud-skills --skill alicloud-platform-openapi-product-api-discovery

インストール後、Claude Code で/alicloud-platform-openapi-product-api-discoveryを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
openapi-meta.md
product-sources.md
scripts/
analyze_products_vs_skills.py
apis_from_openapi_meta.py
join_products_with_api_meta.py
merge_product_sources.py
products_from_bssopenapi.py
products_from_openapi_meta.py
products_from_support_service.py
products_from_ticket_system.py
summarize_openapi_meta_products.py

詳細

Alibaba Cloud 製品と API の調査

このワークフローに従って製品を収集し、API メタデータを解決して、スキルの計画に役立つ概要を作成します。

ワークフロー

  1. 3 つのソースから製品リストを取得します
  • チケットシステム（ListProducts）
  • サポートとサービス（ListProductByGroup）
  • BSS OpenAPI（QueryProductList）

このスキルフォルダーにあるバンドル済みスクリプトを実行します。

python scripts/products_from_ticket_system.py
python scripts/products_from_support_service.py
python scripts/products_from_bssopenapi.py

各スクリプトで必要な環境変数を設定してください（リファレンスを参照）。

  1. 製品リストをマージします
python scripts/merge_product_sources.py

これにより、output/product-scan/merged_products.json と .md が作成されます。

  1. OpenAPI メタデータの製品リストを取得します
python scripts/products_from_openapi_meta.py

これにより、output/product-scan/openapi-meta/products.json と products_normalized.json が作成されます。

  1. 製品／バージョンごとに OpenAPI API ドキュメントを取得します
python scripts/apis_from_openapi_meta.py

デフォルトでは大量のデータが取得される可能性があります。ドライランでは、次のフィルターを使用してください。

  • OPENAPI_META_MAX_PRODUCTS=10
  • OPENAPI_META_PRODUCTS=Ecs,Ons
  • OPENAPI_META_VERSIONS=2014-05-26
  1. 製品を API 数と結合します
python scripts/join_products_with_api_meta.py
  1. カテゴリ／グループ別に製品を要約します
python scripts/summarize_openapi_meta_products.py
  1. （任意）製品と既存のスキルを比較します
python scripts/analyze_products_vs_skills.py

出力に関するルール

生成されたファイルはすべて output/ の下に保存してください。一時ファイルを他の場所に置かないでください。

検証

mkdir -p output/alicloud-platform-openapi-product-api-discovery
for f in skills/platform/openapi/alicloud-platform-openapi-product-api-discovery/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-platform-openapi-product-api-discovery/validate.txt

合格条件：コマンドが終了コード 0 で終了し、output/alicloud-platform-openapi-product-api-discovery/validate.txt が生成されること。

出力とエビデンス

  • 成果物、コマンド出力、API レスポンスの概要を output/alicloud-platform-openapi-product-api-discovery/ の下に保存してください。
  • 再現性を確保するため、エビデンスファイルには主要なパラメーター（リージョン／リソース ID／時間範囲）を含めてください。

前提条件

  • 実行前に、最小権限の Alibaba Cloud 認証情報を設定してください。
  • 環境変数の使用を推奨します：ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET、任意で ALICLOUD_REGION_ID。
  • リージョンが不明な場合は、変更を伴う操作を実行する前にユーザーに確認してください。

リファレンス

  • 製品ソース API：references/product-sources.md を参照
  • OpenAPI メタデータのエンドポイント：references/openapi-meta.md を参照

コメント

Markdown 対応