mcpField
E
expo-cicd-workflows

expo-cicd-workflows

github.com/midudevクラウド・DevOps7.0k57 回インストール1 週間前に更新
リポジトリ

expo-cicd-workflows について

expo-cicd-workflowsは、EAS CI/CDワークフローのYAMLファイルを作成・編集するスキルです。最新のスキーマとドキュメントを取得し、それに基づいてファイルを検証する手順を示します。

主な機能

  1. 01EASワークフローYAMLのガイド
  2. 02最新スキーマとドキュメントの取得
  3. 03ジョブ依存関係と式の確認
  4. 04ワークフローファイルの検証

活用シーン

  1. 01EASワークフローの新規作成
  2. 02YAML内のジョブやトリガーの編集
  3. 03ワークフロージョブ間の参照確認
  4. 04使用前のワークフロー検証

インストール

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

$npx skills add https://github.com/midudev/autoskills --skill expo-cicd-workflows

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

同梱ファイル

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

scripts/
fetch.js
package.json
validate.js

詳細

EAS Workflows スキル

開発者が EAS CI/CD ワークフローの YAML ファイルを作成、編集できるよう支援します。

リファレンスドキュメント

ワークフローファイルを生成または検証する前に、以下のリソースを取得してください。このスキルの scripts/ ディレクトリにある取得スクリプト（Node.js で実装）を使用します。効率化のため、レスポンスは ETag を使ってキャッシュされます。

# Fetch resources
node {baseDir}/scripts/fetch.js <url>

  1. JSON Schema — https://api.expo.dev/v2/workflows/schema

    • このスキーマの取得は必須です
    • 検証のための信頼できる唯一の情報源です
    • すべてのジョブタイプと、必須および任意のパラメーター
    • トリガーのタイプと設定
    • ランナーのタイプ、VM イメージ、およびすべての列挙値

  2. 構文ドキュメント — https://raw.githubusercontent.com/expo/expo/refs/heads/main/docs/pages/eas/workflows/syntax.mdx

    • ワークフロー YAML の構文の概要
    • 例と英語での説明
    • 式の構文とコンテキスト

  3. パッケージ済みジョブ — https://raw.githubusercontent.com/expo/expo/refs/heads/main/docs/pages/eas/workflows/pre-packaged-jobs.mdx

    • サポート対象のパッケージ済みジョブタイプのドキュメント
    • ジョブ固有のパラメーターと出力

新しい機能の追加に伴い、これらのリソースは更新されるため、記憶した値に頼らないでください。

ワークフローファイルの場所

ワークフローは .eas/workflows/*.yml（または .yaml）に配置されます。

トップレベルの構造

ワークフローファイルには、次のトップレベルキーがあります。

  • name — ワークフローの表示名
  • on — ワークフローを開始するトリガー（少なくとも 1 つ必須）
  • jobs — ジョブの定義（必須）
  • defaults — すべてのジョブに適用される共通のデフォルト値
  • concurrency — ワークフロー実行の並列処理を制御します

各セクションの完全な仕様については、スキーマを参照してください。

式

動的な値には ${{ }} 構文を使用します。使用可能なコンテキストはスキーマで定義されています。

  • github.* — GitHub リポジトリとイベントの情報
  • inputs.* — workflow_dispatch 入力からの値
  • needs.* — 依存ジョブの出力とステータス
  • jobs.* — ジョブの出力（別の構文）
  • steps.* — カスタムジョブ内のステップの出力
  • workflow.* — ワークフローのメタデータ

ワークフローの生成

ワークフローを生成または編集する際は、次の手順に従ってください。

  1. スキーマを取得し、最新のジョブタイプ、パラメーター、許可される値を確認します
  2. 各ジョブタイプに必要なフィールドが揃っていることを検証します
  3. needs と after に記載されたジョブ参照がワークフロー内に存在することを確認します
  4. 式が有効なコンテキストと出力を参照していることを確認します
  5. if 条件がスキーマの長さ制限を満たしていることを確認します

検証

ワークフローファイルの生成または編集後、スキーマに対して検証します。

# Install dependencies if missing
[ -d "{baseDir}/scripts/node_modules" ] || npm install --prefix {baseDir}/scripts

node {baseDir}/scripts/validate.js <workflow.yml> [workflow2.yml ...]

検証ツールは最新のスキーマを取得し、YAML の構造をチェックします。ワークフローを完成とする前に、報告されたエラーをすべて修正してください。

質問への回答

ユーザーから使用可能なオプション（ジョブタイプ、トリガー、ランナーのタイプなど）について質問された場合は、古くなっている可能性のある情報に頼らず、スキーマを取得してそこから回答を導き出してください。

コメント

Markdown 対応