aliyun-skill-creator

Category: ツール

Alibaba Cloud Skill Creator

alicloud-skills 向けの、リポジトリ固有のスキルエンジニアリングワークフローです。

このスキルを使用する場面

• skills/** の下に新しいスキルを作成する場合。
• 外部のスキルをインポートし、このリポジトリに適合させる場合。
• スキルのトリガー品質（フロントマターの name と description）を更新する場合。
• tests/** の下にスモークテストを追加または修正する場合。
• マージ前に、構造化されたベンチマークの反復を実行する場合。

このスキルを使用しない場面

• ユーザーが既存のプロダクトスキルを実行するだけでよい場合。
• apps/ のアプリケーションコードのみが対象で、スキルの変更がない場合。

リポジトリの制約（必ず適用）

• スキルは skills/<domain>/<subdomain>/<skill-name>/ の下に配置します。
• スキルのフォルダー名にはケバブケースを使用し、alicloud- で始める必要があります。
• すべてのスキルには、name と description を含むフロントマターを記述した SKILL.md が必要です。
• skills/**/SKILL.md の内容は英語のみとします。
• スモークテストは tests/<domain>/<subdomain>/<skill-name>-test/SKILL.md に配置します。
• 生成したエビデンスは output/<skill-or-test-skill>/ のみに保存します。
• スキル一覧に変更があった場合は、scripts/update_skill_index.sh で README のインデックスを更新します。
• スキルを新規作成または更新する作業では、必ず最初に公式ドキュメントを再取得してください。記憶や以前のドラフトだけを基にスキルを編集してはいけません。「Alibaba Cloud ドキュメントの最新情報を取得する」を参照してください。

標準の成果物レイアウト

skills/<domain>/<subdomain>/<skill-name>/
├── SKILL.md
├── agents/openai.yaml
├── references/
│   └── sources.md
└── scripts/ (optional)

tests/<domain>/<subdomain>/<skill-name>-test/
└── SKILL.md

ワークフロー

1. 目的を把握する

• ドメイン／サブドメインと対象のスキル名を確認します。
• 新規作成、移行、リファクタリングのどれに該当するかを確認します。
• 期待される成果物と成功基準を確認します。
• ここで公式ドキュメントを再取得します。更新の場合も例外ではありません。「Alibaba Cloud ドキュメントの最新情報を取得する」を参照してください。変更を加える前に、取得した情報と既存のスキルとの差分を確認します。

2. スキルを変更する

• 新規スキルの場合：構成を作成し、SKILL.md と agents/openai.yaml のドラフトを用意します。
• 外部リポジトリから移行する場合：最初にソースツリー全体をコピーしてから、適合させます。
• 適合の変更は最小限にしつつ、明示します。
  • このリポジトリに合わない環境固有の手順を置き換えます。
  • リポジトリの検証と出力管理に関するセクションを追加します。
  • 再利用可能な同梱リソース（scripts/、references/、assets/）は保持します。
• 常に最新の Alibaba Cloud 公式ドキュメントに基づいてスキルを作成し（下記の「Alibaba Cloud ドキュメントの最新情報を取得する」を参照）、信頼できる情報源の URL をすべて references/sources.md に記録します。

3. スモークテストを追加する

• tests/**/<skill-name>-test/SKILL.md を作成または更新します。
• 最小限で、再現可能かつリスクの低いテストにします。
• 合格基準とエビデンスの保存場所を明記します。

4. ローカルで検証する

スキルのスクリプトのコンパイル検証を実行します。

python3 tests/common/compile_skill_scripts.py \
  --skill-path skills/<domain>/<subdomain>/<skill-name> \
  --output output/<skill-name>-test/compile-check.json

スキル一覧に変更があった場合は、インデックスを更新します。

scripts/update_skill_index.sh

インデックスが存在することを確認します。

rg -n "<skill-name>" README.md README.zh-CN.md README.zh-TW.md

任意の追加チェック：

make test
make build-cli

5. ベンチマークの反復（任意。大規模なスキル向け）

ユーザーからスキルの定量評価を依頼された場合は、同梱のツールを再利用します。

• scripts/run_eval.py
• scripts/aggregate_benchmark.py
• eval-viewer/generate_review.py

ベンチマークの成果物は、隣接するワークスペースディレクトリに配置し、反復ごとの出力を保持します。

完了の定義

• スキルのパスと命名がリポジトリの規約に従っている。
• フロントマターが揃っており、トリガーの説明が明確である。
• テストスキルが存在し、客観的な合格基準が定められている。
• 検証の成果物が output/ の下に保存されている。
• スキル一覧に変更があった場合は、README のスキルインデックスが更新されている。
• references/sources.md に、この作業で参照したすべての上流 URL が、注記に最終確認日とともに記載されている。
• SKILL.md に記載するモデル ID、パラメーター名、クォータ、価格には、この作業中に取得した URL が引用されており、未検証の情報が引き継がれていない。

Alibaba Cloud の最新ドキュメントを取得する

厳守事項：作成または更新の各パスは、必ずここから始めてください。 まず上流のドキュメントツリーを再取得し、既存のスキルと差分を確認してから記述します。モデルの記憶や以前のドラフトを信用しないでください。Alibaba Cloud では、モデル ID、パラメーター名、料金が毎週のように変更されます。

権威の優先順位（質問に完全に回答できる最初の情報源で止めてください）：

1. ヘルプセンター（help.aliyun.com/zh/...）— 一次情報源

中国語パス（/zh/）が最初に公開され、最も正確です。英語パス（/en/）は数週間遅れることがよくあります。内容が一致していることを確認してからリンクしてください。

ドキュメントの種類	URL パターン	用途
製品概要	https://help.aliyun.com/zh/<product-slug>/product-overview/	新しいスキルを作成する際の最初の確認
API リファレンス	https://help.aliyun.com/zh/<product-slug>/<api-reference-slug>	リクエスト／レスポンスの信頼できるスキーマ
クイックスタート	https://help.aliyun.com/zh/<product-slug>/getting-started/	最小限のエンドツーエンドの例
料金	https://help.aliyun.com/zh/<product-slug>/billing-overview（Model Studio の場合は model-pricing）	コストに関わる判断
レガシー記事 ID	https://help.aliyun.com/document_detail/<id>.html	古い記事のみ。/zh/ のスラッグが存在する場合は、そちらに置き換えてください

WebFetch で取得します：

WebFetch(url="https://help.aliyun.com/zh/<product-slug>/<api-reference-slug>",
         prompt="Extract endpoint, parameters, response schema, model ids, and limits.")

応答がリダイレクト通知の場合は、リダイレクト先の URL に対して WebFetch を再実行してください。

2. Bailian / Model Studio（/zh/model-studio/...）— エントリーポータル

DashScope ベースのスキル（LLM、画像、動画、音声、埋め込み、再ランク付け、エージェント、アプリケーション）では、標準のエントリーポイントは次のとおりです：

https://help.aliyun.com/zh/model-studio/models

このページから、以下のトピック別サブツリーをたどってください。必ず最初に newly-released-models を確認してください。このページが、現在 GA になっているモデル ID と、ひそかに廃止されたモデル ID の信頼できる情報源です。

トピック	/zh/model-studio/ 配下の URL スラッグ	備考
モデルカタログ（エントリー）	models	現在提供中のモデル一覧と各詳細ページへのリンク
モデルリリースログ	newly-released-models	新規／廃止モデル ID と日付の信頼できる情報源
料金	model-pricing	モデルごとのトークン／画像／秒単位の料金
入門ガイド	getting-started/models	アカウント、キー、リージョンの前提条件
OpenAI 互換モード	openai-compatible	ユーザーが openai SDK の形式を求める場合
クイックスタート（モダリティごと）	<modality>-quick-start（例：emoji-quick-start）	最小限の実行可能な例
テキスト生成（Qwen）	qwen、qwen-coder、qwen-vl-ocr、qwen3-coder-next	ファミリー別のガイド
画像生成／編集	wan-image-generation-and-editing-api-reference、wan-image-generation-api-reference、qwen-image-edit-guide、z-image-api-reference	Wan／Qwen／Z の画像モデル系列
動画生成	use-video-generation、image-to-video-general-api-reference、wan-video-editing-api-reference、text-to-video-prompt	Wan 動画とプロンプトのガイド
アバター／顔／絵文字動画	emoji-detect-api、emoji-api、liveportrait-*、videoretalk-*、animate-anyone-*	アバター／デジタルヒューマンのパイプライン
音声（TTS）	qwen-tts-realtime、qwen-tts-voice-cloning、qwen-tts-voice-design	リアルタイム、クローン、音声デザイン
音声（ASR）	qwen-asr、qwen-asr-filetrans-api、recorded-speech-recognition-qwen	ストリーミングとファイル文字起こし
ファイル処理	get-temporary-file-url	メディア API 用の OSS 一時 URL アップロード
埋め込みと再ランク付け	embedding-api-details、text-embedding-async-api、text-rerank-api	ベクトルと再ランク付けのスタック
アプリケーションとエージェント	agent-application、bailian-application-api	ホスト型 Bailian アプリケーション／エージェントのランタイム
ツール統合	cline、langchain、dify-integration	サードパーティクライアントとの接続

スラッグが不明な場合は、まずエントリーページに GET し、サイドバーで現在のパスを確認してください。スラッグは変更されることがあります。

DashScope のランタイムベース URL：

Mainland:   https://dashscope.aliyuncs.com/api/v1/...
Singapore:  https://dashscope-intl.aliyuncs.com/api/v1/...

3. OpenAPI ポータルのメタデータ（api.aliyun.com）— 機械可読な仕様

DashScope 以外の製品（ECS、OSS、RDS、SLS、ESA、…）について、リクエスト／レスポンスのフィールド型や完全な API 一覧を正確に確認する場合に使用します。

# All products (one-time index, EN labels)
https://api.aliyun.com/meta/v1/products.json?language=EN_US

# All APIs for a product/version
https://api.aliyun.com/meta/v1/products/<Product>/versions/<YYYY-MM-DD>/api-docs.json

# Single API definition (full schema)
https://api.aliyun.com/meta/v1/products/<Product>/versions/<YYYY-MM-DD>/apis/<ApiName>/api.json

リポジトリ内のヘルパーがこれらのエンドポイントをすでにラップしています。個別のスクレイパーを作成せず、再利用してください。

python3 scripts/products_from_openapi_meta.py        # refresh product index
python3 scripts/apis_from_openapi_meta.py            # fetch APIs per product (env-driven)

閲覧可能なポータル：https://api.aliyun.com/product/<Product> — 人が内容を確認したり、スクリプトを作成する前に <Product> コードを確認したりするために使用します。

4. 公式 SDK と CLI

ソース	URL パターン	用途
GitHub 組織	https://github.com/aliyun、https://github.com/AliyunContainerService、https://github.com/alibabacloud-sdk	SDK コード、サンプルの参照
PyPI	https://pypi.org/project/dashscope/、https://pypi.org/project/alibabacloud-<product>/	Python のインストールと最新バージョンの確認
npm	https://www.npmjs.com/package/@alicloud/<product>	Node のインストールと最新バージョンの確認
Aliyun CLI	https://github.com/aliyun/aliyun-cli および aliyun <product> help	シェルベースのスキル

5. 参照元の記録

すべてのスキルでは、今回の作業で実際に参照した URL を references/sources.md に必ず記載してください。

# Sources

- [<Human title>](<URL>) — what this covers (last checked YYYY-MM-DD)

最低限、API リファレンス、モデル／バージョンに関する告知（Model Studio の場合は newly-released-models）、料金（関連する場合）、SDK のホームページを含めてください。各項目に日付を記載してください。これにより、次のメンテナーが情報の古さを把握できます。

注意すべき兆候 — 作業を止めて再取得してください

• このセッションで上流 URL を一つも開かずにスキルを編集している。
• 既存のドラフトからモデル ID、パラメーター名、クォータをそのまま流用している。
• /zh/ を確認せずに /en/ ページのみにリンクしている。
• 生の HTML／JSON ダンプを references/ に保存し、SKILL.md に要約していない。
• scripts/products_from_openapi_meta.py／scripts/apis_from_openapi_meta.py ですでに対応している呼び出しに curl ループを書いている。

参照資料

• references/schemas.md
• references/sources.md