configure-reusable-workflows

/configure:reusable-workflows

claude-plugins の Claude 搭載再利用可能 GitHub Actions ワークフローをプロジェクトにインストールします。

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

次のような場合にこのスキルを使用します…	次のような場合は別の方法を使用します…
セキュリティ、品質、アクセシビリティ向けの Claude 搭載再利用可能ワークフローを追加する	標準的な CI/CD ワークフローを設定する（/configure:workflows を使用）
claude-plugins のビルド済みワークフロー呼び出し元をインストールする	GitHub Actions ワークフローを一からカスタム作成する
CI を通じて OWASP、シークレットスキャン、コードスメル検出を自動化する	ローカルのセキュリティスキャンツールを設定する（/configure:security を使用）
プルリクエストのパイプラインに WCAG アクセシビリティチェックを追加する	アクセシビリティ監査を手動で一度だけ実行する
複数カテゴリにわたる Claude 搭載 CI チェック一式を導入する	既存のワークフローが準拠しているかだけを確認する

コンテキスト

• ワークフローディレクトリ：!find . -maxdepth 1 -type d -name \'.github/workflows\'
• 既存の呼び出し元：!find . -path '*/.github/workflows/*' -maxdepth 3 -name 'claude-*'
• パッケージファイル：!find . -maxdepth 1 \( -name 'package.json' -o -name 'pyproject.toml' -o -name 'Cargo.toml' -o -name 'go.mod' \) -print -quit
• TypeScript ファイル：!find . -maxdepth 2 \( -name '*.ts' -o -name '*.tsx' \) -print -quit
• コンポーネントファイル：!find . -maxdepth 3 \( -name '*.jsx' -o -name '*.vue' -o -name '*.svelte' \) -print -quit

パラメーター

コマンド引数から解析します：

• --all：すべてのワークフローをインストール
• --security：セキュリティワークフローのみをインストール
• --quality：品質ワークフローのみをインストール
• --a11y：アクセシビリティワークフローのみをインストール
• --list：インストールせずに利用可能なワークフローを一覧表示

利用可能なワークフロー

セキュリティ

ワークフロー	説明	ファイル
secrets	漏えいしたシークレットと認証情報を検出	reusable-security-secrets.yml
owasp	OWASP Top 10 の脆弱性をスキャン	reusable-security-owasp.yml
deps	依存関係の脆弱性を監査	reusable-security-deps.yml

品質

ワークフロー	説明	ファイル
typescript	TypeScript の厳格性を分析	reusable-quality-typescript.yml
code-smell	コードスメルを検出	reusable-quality-code-smell.yml
async	Async/await パターンの問題を検出	reusable-quality-async.yml

アクセシビリティ

ワークフロー	説明	ファイル
wcag	WCAG 2.1 への準拠をチェック	reusable-a11y-wcag.yml
aria	ARIA パターンを検証	reusable-a11y-aria.yml

実行

この再利用可能ワークフローのインストールを実行します：

ステップ 1：現在の状態を検出する

1. .github/workflows/ ディレクトリを確認します（存在しない場合は作成します）
2. 既存の Claude 搭載ワークフロー呼び出し元を一覧表示します
3. 存在するファイルからプロジェクトの種類を判定します

ステップ 2：ワークフローを選択する

フラグが指定されていない場合は、インストールするカテゴリをユーザーに尋ねます：

Available workflow categories:
  [1] Security (secrets, owasp, deps)
  [2] Quality (typescript, code-smell, async)
  [3] Accessibility (wcag, aria)
  [4] All workflows

Which categories? (comma-separated, e.g., 1,2):

--list が指定されている場合は、上記の「利用可能なワークフロー」表を出力して終了します。

ステップ 3：呼び出し元ワークフローを生成する

選択した各ワークフローについて、.github/workflows/ に呼び出し元ファイルを作成します。

ファイル名の規則：claude-<category>-<name>.yml

例：claude-security-secrets.yml

表示名の規則：ワークフローの name: は <Domain>: <Action> [<target>] の形式にします（YAML では : がキーの区切りとして扱われるため、引用符で囲みます）。これらの再利用可能な呼び出し元には、ドメインとして Claude: が適切です。正式な規則と有効なドメインについては .claude/rules/workflow-naming.md を参照してください。例：name: "Claude: Security secrets"。

呼び出し元ワークフローのテンプレートを使用します：

name: "Claude: <Action> <target>"

on:
  pull_request:
    branches: [main]
  workflow_dispatch:

permissions:
  contents: read
  pull-requests: write
  id-token: write

jobs:
  check:
    uses: laurigates/.github/.github/workflows/reusable-<category>-<name>.yml@main
    with:
      # Default inputs - customize as needed
      max-turns: 5
    secrets: inherit

カテゴリごとの完全な呼び出し元ワークフローファイルについては、REFERENCE.md を参照してください。

ステップ 4：シークレットについて通知する

インストール後、必要なシークレット設定を出力します：

Required secret: CLAUDE_CODE_OAUTH_TOKEN

To configure:
1. Go to repository Settings > Secrets and variables > Actions
2. Add secret: CLAUDE_CODE_OAUTH_TOKEN
3. Value: Your Claude Code OAuth token

Get token from: https://console.anthropic.com/

カスタマイズ

インストール後、次の項目をカスタマイズできます。

入力	目的	例
file-patterns	スキャンするファイル	'src/**/*.ts'
max-turns	Claude の分析の深さ	3（簡易）から10（詳細）
fail-on-*	検出結果がある場合にマージをブロック	true / false
wcag-level	アクセシビリティ標準	'A'、'AA'、'AAA'

インストール後

1. シークレットを設定する：リポジトリのシークレットに CLAUDE_CODE_OAUTH_TOKEN を追加します
2. パターンをカスタマイズする：プロジェクトの構成に合わせて file-patterns を編集します
3. トリガーを調整する：関連するファイルタイプに合わせて paths フィルターを変更します
4. 手動でテストする：PR トリガーの前に workflow_dispatch を使ってテストします

エージェント向けの最適化

コンテキスト	コマンド
利用可能なワークフローを一覧表示	/configure:reusable-workflows --list
すべてのワークフローを一度にインストール	/configure:reusable-workflows --all
セキュリティワークフローのみ	/configure:reusable-workflows --security
品質ワークフローのみ	/configure:reusable-workflows --quality
アクセシビリティワークフローのみ	/configure:reusable-workflows --a11y
既存の呼び出し元を確認	find .github/workflows -name 'claude-*' -type f

フラグ

フラグ	説明
--all	すべてのワークフローをインストール
--security	セキュリティワークフローのみをインストール
--quality	品質ワークフローのみをインストール
--a11y	アクセシビリティワークフローのみをインストール
--list	インストールせずに利用可能なワークフローを一覧表示

関連項目

• /configure:workflows - 標準的な CI/CD ワークフロー（コンテナ、release-please）
• /configure:security - セキュリティツールの設定
• ci-workflows スキル - ワークフローのパターン