Concurrency Control Skill

GitHub Actions ワークフローの並行実行制御パターンと、レースコンディション防止戦略を提供します。

ディレクトリ構造

.claude/skills/concurrency-control/
├── SKILL.md                           # このファイル（概要とコマンドリファレンス）
├── resources/
│   ├── concurrency-syntax.md          # group と cancel-in-progress 詳細構文
│   └── race-conditions.md             # レースコンディション防止パターン
├── templates/
│   └── concurrency-workflow.yaml      # 並行実行制御のワークフロー例
└── scripts/
    └── check-concurrency.mjs          # 並行実行設定の検証スクリプト

コマンドリファレンス

リソース参照

# 並行実行制御の構文詳細
cat .claude/skills/concurrency-control/resources/concurrency-syntax.md

# レースコンディション防止パターン
cat .claude/skills/concurrency-control/resources/race-conditions.md

テンプレート参照

# 並行実行制御ワークフロー例
cat .claude/skills/concurrency-control/templates/concurrency-workflow.yaml

スクリプト実行

# 並行実行設定の検証
node .claude/skills/concurrency-control/scripts/check-concurrency.mjs <workflow-file.yml>

並行実行制御の基本パターン

1. デプロイメントキュー（順次実行）

concurrency:
  group: production-deploy
  cancel-in-progress: false # キューに入れて順次実行

用途: デプロイ、データベースマイグレーション、リリース

2. 最新のみ実行（古いジョブキャンセル）

concurrency:
  group: pr-${{ github.ref }}
  cancel-in-progress: true # 進行中のジョブをキャンセル

用途: PR ビルド、テスト、プレビューデプロイ

3. 環境ごとの制御

concurrency:
  group: ${{ github.workflow }}-${{ github.event.deployment.environment }}
  cancel-in-progress: ${{ github.event.deployment.environment != 'production' }}

用途: 環境別デプロイメント戦略

4. ブランチごとの制御

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}

用途: メインブランチ保護、フィーチャーブランチ最適化

レースコンディション防止のベストプラクティス

状態競合の防止

1. 排他制御: cancel-in-progress: false でキューベース実行
2. タイムスタンプ検証: デプロイ前に最新性確認
3. ロック機構: GitHub Deployment API の利用

リソース競合の防止

1. 環境ごとのグループ化: 環境名を group に含める
2. セマフォパターン: 同時実行数制限（GitHub Apps API）
3. リトライ戦略: 競合時の自動リトライ

デプロイメント順序保証

1. シーケンシャルキュー: cancel-in-progress: false
2. 依存関係チェック: 前回デプロイの完了確認
3. バージョン検証: デプロイ対象バージョンの検証

トラブルシューティング

よくある問題

デバッグコマンド

# ワークフロー実行の確認
gh run list --workflow=deploy.yml --limit=10

# 並行実行設定の検証
node .claude/skills/concurrency-control/scripts/check-concurrency.mjs .github/workflows/deploy.yml

# 実行中のジョブ確認
gh run list --status in_progress

実装チェックリスト

• デプロイワークフローに concurrency 設定を追加
• 環境ごとに適切な group を定義
• production は cancel-in-progress: false を設定
• 非 production は cancel-in-progress: true を検討
• レースコンディションテストを実施
• ドキュメントに並行実行ポリシーを記載

関連スキル

このスキルは以下のスキルと連携します:

• .claude/skills/github-actions-syntax/SKILL.md: .claude/skills/github-actions-syntax/SKILL.md
  • 基本構文と式の評価
• .claude/skills/deployment-environments-gha/SKILL.md: .claude/skills/deployment-environments-gha/SKILL.md
  • 環境ベースのデプロイメント制御
• .claude/skills/workflow-security/SKILL.md: .claude/skills/workflow-security/SKILL.md
  • セキュアな並行実行制御

詳細情報

• 構文詳細: resources/concurrency-syntax.md
• レースコンディション: resources/race-conditions.md
• ワークフロー例: templates/concurrency-workflow.yaml

最終更新: 2025-11-27 メンテナ: .claude/agents/gha-workflow-architect.md