ci-cd-pipeline-builder

CI/CD パイプラインビルダー

検出したプロジェクトスタックのシグナルから、本番環境に対応した CI/CD パイプラインを生成します。ロックファイル、マニフェスト、スクリプトを分析し、適切なキャッシュ、マトリックス戦略、セキュリティスキャン、デプロイゲートを備えた最適化済みのパイプラインを作成します。GitHub Actions、GitLab CI、CircleCI、Buildkite に対応し、ブルーグリーン、カナリア、ローリングアップデートなどのデプロイ戦略をサポートします。

キーワード： CI/CD、GitHub Actions、GitLab CI、パイプライン、デプロイ、キャッシュ、マトリックスビルド、ブルーグリーンデプロイ、カナリアデプロイ、セキュリティスキャン、SAST、コンテナビルド、環境ゲート

主な機能

• スタックの検出 — ロックファイルとマニフェストから、言語／ランタイム、パッケージマネージャー、ビルド／テスト／Lint コマンド、フレームワーク、インフラストラクチャ（Docker、K8s、Terraform）を推定します。
• パイプラインの生成 — 適切な依存関係、キャッシュ、マトリックスビルド、成果物の受け渡し、条件付き実行を備えた lint／テスト／ビルド／デプロイの各ステージを生成します。
• デプロイ戦略 — ブルーグリーン、カナリア、ローリングアップデート、再作成、フィーチャーフラグ連携、手動承認ゲートに対応します。
• セキュリティ連携 — SAST（CodeQL、Semgrep、Snyk）、依存関係とコンテナのスキャン（Trivy、Grype）、シークレットスキャン、SBOM の生成に対応します。
• 最適化 — パッケージマネージャーに合わせたキャッシュ、パスフィルタリング、同時実行制御、フェイルファストのマトリックスを設定します。

使用する状況

• 新しいリポジトリの CI/CD を立ち上げる
• CI プラットフォーム間で移行する
• 遅い、または不安定なパイプラインを最適化する
• 既存の CI のみのパイプラインにデプロイステージを追加する
• パイプラインにセキュリティスキャンを導入する
• 複数環境へのデプロイ（ステージング、本番環境）を設定する

まず確認すること

パイプラインを生成する前に、以下の入力内容を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。

• 対象プラットフォーム — GitHub Actions、GitLab CI、CircleCI、Buildkite のいずれか（--platform を介して pipeline_generator.py が出力する YAML の方言を決定します）
• プロジェクトスタック — 言語／ランタイム、パッケージマネージャー、Docker／K8s／Terraform の有無（スタック検出、キャッシュ、生成するステージを決定します）
• デプロイ戦略とゲート — ブルーグリーン、カナリア、ローリング、CI のみのいずれか、および手動承認ゲートの有無（デプロイステージと条件を決定します）

停止ルール：出力に最も影響する 2～3 項目だけを質問してください。ユーザーが「とりあえずドラフトして」と言った場合は、そのまま進め、成果物の冒頭に前提条件を列挙してください。

ツール

ツール	目的	コマンド
pipeline_generator.py	プロジェクトスタックの検出結果からパイプライン YAML を生成します	python scripts/pipeline_generator.py . --platform github --deploy
cache_optimizer.py	パイプライン設定を分析し、キャッシュ改善案を提示します	python scripts/cache_optimizer.py --dir . --severity high
pipeline_linter.py	よくある問題がないかパイプライン YAML を lint します	python scripts/pipeline_linter.py --dir . --severity warning

参考資料

タスクに合った参考資料を読み込み、このファイルは簡潔に保ち、必要に応じて詳細を参照してください。

• references/pipeline-templates.md — スタック検出のヒューリスティック、GitHub Actions の完全なテンプレート（Node.js/pnpm/Next.js、Python/uv/FastAPI）、GitLab CI 相当の設定、キャッシュ戦略の参考表、パイプライン最適化の手法、デプロイ戦略を選ぶための判断フレームワークを記載しています。パイプラインの生成時やデプロイ戦略の選択時に読みます。
• references/quality-and-operations.md — マージ前の検証チェックリスト、よくある落とし穴、ベストプラクティス、トラブルシューティング表、成功基準を記載しています。生成したパイプラインのマージ前や、問題が発生した場合に読みます。

対象範囲と制限事項

このスキルで対応する内容：

• GitHub Actions、GitLab CI、CircleCI、Buildkite 向けの CI/CD パイプラインの生成
• ロックファイル、マニフェスト、Dockerfile、Infrastructure as Code の定義に基づくスタックの検出
• 判断フレームワークに基づくデプロイ戦略（ブルーグリーン、カナリア、ローリング、再作成）の選択
• キャッシュ、マトリックスビルド、パスフィルタリング、同時実行制御などによるパイプラインの最適化

このスキルでは対応しない内容：

• 実行時のインフラストラクチャのプロビジョニングやクラウドリソースの管理（engineering/saas-scaffolder を参照）
• CI に統合されたスキャンを超える、アプリケーションレベルのセキュリティ強化（engineering/skill-security-auditor を参照）
• デプロイ後のモニタリング、アラート、可観測性の設定（engineering/observability-designer を参照）
• デプロイ中のデータベースマイグレーションのオーケストレーション（engineering/migration-architect を参照）

統合ポイント

スキル	統合内容	データフロー
engineering/dependency-auditor	脆弱性スキャンの結果をパイプラインのセキュリティゲートに渡します	監査結果に基づき、パイプラインの失敗または警告アノテーションが発生します
engineering/release-manager	バージョン管理と変更履歴をデプロイステージと連携させます	リリースタグに基づき、条件付きでデプロイジョブが実行されます
engineering/observability-designer	デプロイ後のヘルスチェックとアラートがパイプラインのゲートを補完します	パイプラインがスモークテストをトリガーし、可観測性によってデプロイの健全性を確認します
engineering/env-secrets-manager	パイプラインの環境変数で参照されるシークレットを管理します	シークレットローテーションポリシーがパイプラインのシークレットストア設定に反映されます
engineering/migration-architect	パイプラインのデプロイ前ステップとしてデータベースマイグレーションを実行します	マイグレーションのステータスがアプリケーションのデプロイジョブのゲートになります
engineering/runbook-generator	デプロイ戦略に沿ったロールバック手順書を生成します	パイプラインの失敗時に、該当するロールバック手順書へのリンクが表示されます