mcpField
A
aliyun-aicontent-generate

aliyun-aicontent-generate

github.com/cinienceクリエイティブ・メディア39659 回インストール11 週間前に更新
リポジトリ

aliyun-aicontent-generate について

Alibaba Cloud OpenAPI を通じて AIContent リソースを管理するスキルです。API メタデータを先に調べ、呼び出し後に結果を検証します。

主な機能

  1. 01API 一覧とパラメーターの確認
  2. 02リソースの照会と一覧表示
  3. 03リソースの作成・変更
  4. 04状態確認と結果の検証
  5. 05出力と操作記録の保存

活用シーン

  1. 01AIContent リソース一覧の確認
  2. 02リソース設定の変更
  3. 03リソース状態の調査

インストール

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

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-aicontent-generate

インストール後、Claude Code で/aliyun-aicontent-generateを入力して読み込まれたか確認します。

同梱ファイル

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

agents/
openai.yaml
references/
sources.md
scripts/
list_openapi_meta_apis.py

詳細

Category: サービス

AIContent

公式 SDK または OpenAPI Explorer を使用して Alibaba Cloud OpenAPI（RPC）を利用し、AIContent のリソースを管理します。

ワークフロー

  1. リージョン、リソース識別子、希望する操作を確認します。
  2. API の一覧と必須パラメーターを確認します（参考資料を参照）。
  3. SDK または OpenAPI Explorer で API を呼び出します。
  4. describe/list API で結果を確認します。

AccessKey の優先順位（必ず従ってください）

  1. 環境変数：ALIBABACLOUD_ACCESS_KEY_ID / ALIBABACLOUD_ACCESS_KEY_SECRET / ALIBABACLOUD_REGION_ID リージョンポリシー：ALIBABACLOUD_REGION_ID は省略可能なデフォルト値です。設定されていない場合は、タスクに最も適したリージョンを選択してください。不明な場合はユーザーに確認してください。
  2. 共有設定ファイル：~/.alibabacloud/credentials

API の検出

  • プロダクトコード：AiContent
  • デフォルトの API バージョン：20240611
  • OpenAPI メタデータエンドポイントを使用して、API の一覧表示とスキーマの取得を行います（参考資料を参照）。

高頻度の操作パターン

  1. インベントリ／一覧：現在のリソースを取得するには、List* / Describe* API を優先します。
  2. 変更／設定：変更には、Create* / Update* / Modify* / Set* API を優先します。
  3. ステータス／トラブルシューティング：診断には、Get* / Query* / Describe*Status API を優先します。

最小限の実行可能なクイックスタート

ビジネス API を呼び出す前に、メタデータに基づいて検出してください。

python scripts/list_openapi_meta_apis.py

オプションのオーバーライド：

python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>

スクリプトは、API インベントリアーティファクトをスキルの出力ディレクトリに書き込みます。

出力ポリシー

応答や生成されたアーティファクトを保存する必要がある場合は、次の場所に書き込んでください： output/aliyun-aicontent-generate/

検証

mkdir -p output/aliyun-aicontent-generate
for f in skills/ai/content/aliyun-aicontent-generate/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-aicontent-generate/validate.txt

合格基準：コマンドが 0 で終了し、output/aliyun-aicontent-generate/validate.txt が生成されること。

出力と証跡

  • アーティファクト、コマンド出力、API 応答の要約を output/aliyun-aicontent-generate/ に保存します。
  • 再現性を確保するため、証跡ファイルに主要なパラメーター（リージョン／リソース ID／時間範囲）を含めます。

前提条件

  • 実行前に、最小権限の Alibaba Cloud 認証情報を設定してください。
  • 環境変数を優先します：ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET、省略可能な ALIBABACLOUD_REGION_ID。
  • リージョンが不明な場合は、変更操作を実行する前にユーザーに確認してください。

参考資料

  • ソース：references/sources.md

コメント

Markdown 対応