ci-cd-pipeline-builder

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

Tier: POWERFUL
Category: エンジニアリング
Domain: DevOps／自動化

概要

このスキルは、推測ではなく、検出したプロジェクトのスタック情報に基づいて、実用的な CI/CD パイプラインを生成します。迅速なベースラインの生成、再現可能なチェック、環境に応じたデプロイ段階に重点を置いています。

主な機能

• リポジトリ内のファイルから言語、ランタイム、ツールを検出
• CI のステージ（lint、test、build、deploy）を提案
• GitHub Actions または GitLab CI のスターターパイプラインを生成
• 検出したスタックに基づき、キャッシュとマトリックス戦略を導入
• 自動化用の機械可読な検出結果を出力
• パイプラインのロジックを、プロジェクトのロックファイルやビルドコマンドに合わせて維持

使用する場面

• 新しいリポジトリの CI を立ち上げる
• 壊れやすいコピー済みのパイプラインファイルを置き換える
• GitHub Actions と GitLab CI の間で移行する
• パイプラインの手順が実際のスタックに合っているか監査する
• カスタムの強化を行う前に、再現可能なベースラインを作成する

主なワークフロー

1. スタックを検出する

python3 scripts/stack_detector.py --repo . --format text
python3 scripts/stack_detector.py --repo . --format json > detected-stack.json

オフライン分析用のペイロードは、標準入力または --input ファイルから入力できます。

2. 検出結果からパイプラインを生成する

python3 scripts/pipeline_generator.py \
  --input detected-stack.json \
  --platform github \
  --output .github/workflows/ci.yml \
  --format text

リポジトリから一連の処理を実行することもできます。

python3 scripts/pipeline_generator.py --repo . --platform gitlab --output .gitlab-ci.yml

3. マージ前に検証する

1. プロジェクトにコマンド（test、lint、build）が存在することを確認します。
2. 可能な場合は、生成したパイプラインをローカルで実行します。
3. 必要なシークレットや環境変数が文書化されていることを確認します。
4. デプロイジョブは、保護されたブランチや環境でのみ実行されるようにします。

4. デプロイステージを安全に追加する

• CI のみ（lint/test/build）から始めます。
• 環境コンテキストを明示して、ステージングへのデプロイを追加します。
• 手動のゲートや承認を設けて、本番環境へのデプロイを追加します。
• ロールアウト／ロールバックのコマンドを明示し、監査可能な状態に保ちます。

スクリプトのインターフェース

• python3 scripts/stack_detector.py --help
  • リポジトリ内のファイルからスタック情報を検出します
  • 標準入力または --input から任意の JSON 入力を読み込みます
• python3 scripts/pipeline_generator.py --help
  • 検出ペイロードから GitHub／GitLab の YAML を生成します
  • 標準出力または --output に書き込みます

参考資料

• references/pipeline-design-notes.md — よくある落とし穴、ベストプラクティス、検出ヒューリスティック、生成戦略、プラットフォーム選定に関する注意点、マージ前の検証チェックリスト、スケーリングの指針
• references/github-actions-templates.md
• references/gitlab-ci-templates.md
• references/deployment-gates.md
• README.md