mcpField
A
alicloud-skill-creator

alicloud-skill-creator

github.com/cinienceエージェントワークフロー396126 回インストール11 週間前に更新
リポジトリ

alicloud-skill-creator について

alicloud-skill-creatorは、`alicloud-skills`向けのスキル開発ワークフローです。スキルの作成や移行、テスト、検証、任意のベンチマークを案内し、リポジトリの規約を適用します。

主な機能

  1. 01スキル作成と移行の手順
  2. 02Frontmatterと命名規則
  3. 03スモークテストの設定と検証
  4. 04スキル索引の更新案内
  5. 05任意のベンチマーク手順

活用シーン

  1. 01新しいリポジトリスキルの作成
  2. 02外部スキルの適応
  3. 03スキルのトリガー情報とテストの改善
  4. 04大規模なスキル変更の評価

インストール

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

$npx skills add https://github.com/cinience/alicloud-skills --skill alicloud-skill-creator

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

同梱ファイル

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

LICENSE.txt
agents/
analyzer.md
comparator.md
grader.md
openai.yaml
assets/
eval_review.html
eval-viewer/
generate_review.py
viewer.html
references/
schemas.md
sources.md
scripts/
__init__.py
aggregate_benchmark.py
generate_report.py
improve_description.py
package_skill.py
quick_validate.py
run_eval.py
run_loop.py
utils.py

詳細

カテゴリ：ツール

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 のインデックスを更新します。

標準の成果物レイアウト

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

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

ワークフロー

  1. 意図を確認する
  • ドメイン／サブドメインと対象のスキル名を確認します。
  • 新規作成、移行、リファクタリングのどれに該当するかを確認します。
  • 期待される出力と成功基準を確認します。
  1. スキルの変更を実装する
  • 新しいスキルの場合：構成を作成し、SKILL.md と agents/openai.yaml の草案を作成します。
  • 外部リポジトリから移行する場合：まずソースツリー全体をコピーしてから調整します。
  • 調整は最小限にとどめ、変更内容を明示します。
    • このリポジトリに合わない環境固有の手順を置き換えます。
    • リポジトリの検証と出力管理に関するセクションを追加します。
    • 再利用可能な同梱リソース（scripts/、references/、assets/）を保持します。
  1. スモークテストを追加する
  • tests/**/<skill-name>-test/SKILL.md を作成または更新します。
  • 最小限で、再現可能かつ低リスクな内容にします。
  • 明確な合格基準とエビデンスの保存先を記載します。
  1. ローカルで検証する

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

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
  1. ベンチマークの反復（主要なスキルでは任意）

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

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

ベンチマークの成果物は、兄弟関係にあるワークスペースディレクトリに配置し、反復ごとの出力を保持することを推奨します。

完了の定義

  • スキルのパスと命名がリポジトリの規約に従っていること。
  • フロントマターが揃っており、トリガーの説明が明確であること。
  • テストスキルが存在し、客観的な合格基準があること。
  • 検証成果物が output/ に保存されていること。
  • スキル一覧に変更があった場合、README のスキルインデックスが更新されていること。

参考資料

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

コメント

Markdown 対応