cloud-native-readiness

クラウドネイティブ対応状況評価スキル

概要

このスキルでは、3 フェーズのワークフローを通じて、リポジトリがクラウドネイティブなマイクロサービスのデプロイにどの程度対応できるかを評価します。

1. 評価 - クラウドネイティブの基準に照らしてプロジェクトを分析し、対応状況レポートを作成します
2. 検出 - Docker 関連の成果物（Dockerfile、docker-compose、コンテナイメージ）の有無を確認します
3. 振り分け - 成果物が存在する場合は結果をそのまま返します。存在しない場合は dockerfile-skill を呼び出してコンテナ化します

ワークフロー

cloud-native-readiness
  │
  ├─ Phase 1: Cloud-Native Assessment
  │    ├─ NOT suitable → Report reasons, suggest remediation, END
  │    └─ Suitable → Continue
  │
  ├─ Phase 2: Existing Artifacts Detection
  │    ├─ Found Dockerfile/docker-compose/image → Report existing setup, END
  │    └─ Not found → Continue
  │
  └─ Phase 3: Route to dockerfile-skill
       └─ Invoke /dockerfile to generate Docker configuration

使用方法

/cloud-native-readiness              # Assess current directory
/cloud-native-readiness <path>       # Assess specific path
/cloud-native-readiness <github-url> # Clone and assess

クイックスタート

呼び出されたら、必ず次の順序で実行してください。

1. modules/assess.md を読み込み、実行します — クラウドネイティブ対応状況の評価
2. modules/detect.md を読み込み、実行します — 既存の Docker 関連成果物の検出
3. modules/route.md を読み込み、実行します — 振り分けの判断

フェーズ 1：クラウドネイティブ対応状況の評価

読み込んで実行します：modules/assess.md

6 つの観点を評価します（各 0〜2 点）。

観点	確認内容
ステートレス性	アプリが状態をローカルに保存していますか（メモリ内のセッション、ローカルファイルへの書き込みなど）？
設定の外部化	設定はハードコードされていますか、それとも環境変数や設定ファイルで管理されていますか？
水平スケーラビリティ	複数のインスタンスを競合なく実行できますか？
起動／シャットダウン	アプリはすばやく起動し、SIGTERM を適切に処理できますか？
可観測性	ヘルスチェック、構造化ログ、メトリクスに対応していますか？
サービス境界	独立したサービスですか、それとも密結合したモノリスですか？

スコア：

• 10-12：優秀 — クラウドネイティブに完全対応しています
• 7-9：良好 — 小規模な調整で対応できます
• 4-6：普通 — コンテナ化の前にある程度のリファクタリングが必要です
• 0-3：不十分 — 大幅な改修が必要です。現時点でのコンテナ化は推奨されません

出力：スコア、調査結果、推奨事項を含む構造化された対応状況レポート。

フェーズ 2：既存成果物の検出

読み込んで実行します：modules/detect.md

確認対象：

• Dockerfile／Dockerfile.*（マルチステージ、マルチサービス）
• docker-compose.yml／docker-compose.yaml／compose.yml
• .dockerignore
• DOCKER.md または Docker 関連ドキュメント
• コンテナレジストリの参照（ghcr.io、docker.io、ECR、GCR、ACR）
• Kubernetes マニフェスト（k8s/、kubernetes/、deploy/、helm/、charts/）
• Docker のビルド手順を含む CI/CD パイプライン（.github/workflows/、.gitlab-ci.yml）

出力：既存の Docker／K8s 関連成果物の一覧と品質評価。

フェーズ 3：振り分けの判断

読み込んで実行します：modules/route.md

判断マトリクス：

対応状況スコア	成果物の有無	アクション
≥ 7	あり、完全	既存の構成を報告します。完了です。
≥ 7	あり、一部	不足点を報告し、改善案を提示します。完了です。
≥ 7	なし	生成のために dockerfile-skill を呼び出します。
4-6	いずれでも	問題と修正手順を報告します。必要に応じて dockerfile-skill を実行します。
0-3	いずれでも	阻害要因を報告します。dockerfile-skill は呼び出さないでください。

対応状況レポートの形式

最終出力では、必ず次の形式を使用してください。

# Cloud-Native Readiness Report

## Summary
- **Project**: {name}
- **Score**: {score}/12 ({rating})
- **Verdict**: {Ready | Ready with caveats | Needs work | Not recommended}

## Assessment Details

### ✅ Strengths
- {what's already cloud-native friendly}

### ⚠️ Concerns
- {issues that need attention}

### ❌ Blockers (if any)
- {critical issues preventing containerization}

## Dimension Scores

| Dimension | Score | Notes |
|-----------|-------|-------|
| Statelessness | {0-2} | {detail} |
| Config Externalization | {0-2} | {detail} |
| Horizontal Scalability | {0-2} | {detail} |
| Startup/Shutdown | {0-2} | {detail} |
| Observability | {0-2} | {detail} |
| Service Boundaries | {0-2} | {detail} |

## Existing Docker Artifacts
- {inventory or "None found"}

## Recommendation
- {next steps}

関連リソース

• 評価基準：knowledge/criteria.md — 詳細な採点基準
• アンチパターン：knowledge/anti-patterns.md — クラウドネイティブでよくあるアンチパターン
• 例：examples/ — 対応状況レポートのサンプル

dockerfile-skill との統合

dockerfile-skill にルーティングする際は、評価コンテキストを渡してください。

1. 準備状況レポートの調査結果を Dockerfile の生成判断に反映します
2. 検出された外部サービスは docker-compose.yml のサービスに直接対応付けます
3. 特定された懸念事項は、Dockerfile のコメントまたは DOCKER.md の注意事項に反映します
4. 評価で判明した設定の外部化状況を、ENV/ARG の設定に反映します

引き継ぎ：dockerfile-skill を呼び出す際は、次の内容を要約して含めてください。

• 検出された言語／フレームワーク／パッケージマネージャー
• 外部サービスへの依存関係
• 設定の外部化状況
• 特別な懸念事項（ステートフルなコンポーネント、起動に時間がかかることなど）