stellakim5551/project-stage-gate

project-stage-gate は何をしますか？

跨プロジェクトで再利用可能な Codex スキル：テスト、承認、Git の証拠に基づいてフェーズ完了を判断し、会話を切り替えます。

概要

このスキルは、Codex エージェントがプロジェクトの各フェーズ（ステージ）の完了を自動的に判断するための仕組みを提供します。テストの実行、承認フローの完了、Git のコミット履歴やブランチ状態などの証拠を収集・評価し、事前に定義された条件を満たした場合に次のフェーズへと会話を切り替えます。

動作原理

1. ユーザーは各フェーズの完了条件を設定します（例：「すべてのテストが成功」「承認者が approve した」「特定のブランチにマージされた」）。
2. エージェントは条件に基づいて証拠を収集します。
   • テスト実行結果（テストフレームワークの出力）
   • 承認ステータス（PR やタスク管理ツールの情報）
   • Git の証拠（コミットメッセージ、ブランチ名、マージ状態）
3. すべての条件が満たされた場合、エージェントは「フェーズ完了」と判断し、次のフェーズの開始を提案するか、自動的に会話を切り替えます。

使用方法

1. スキルを Codex プロジェクトに組み込みます。
2. 各フェーズの完了条件を定義します（例：stage_gate_rules.json）。
3. エージェントが自動的に証拠を収集・評価します。
4. 条件が満たされると、エージェントが次のフェーズに移行します。

設定例

以下は stage_gate_rules.json の設定例です。

{
  "stages": [
    {
      "name": "設計フェーズ",
      "completion_conditions": [
        {"type": "git", "evidence": "ブランチ 'design-review' がマージされた"},
        {"type": "approval", "evidence": "設計レビューが承認された"}
      ]
    },
    {
      "name": "実装フェーズ",
      "completion_conditions": [
        {"type": "test", "evidence": "すべての単体テストが成功"},
        {"type": "git", "evidence": "ブランチ 'feature/*' が develop にマージされた"}
      ]
    },
    {
      "name": "テストフェーズ",
      "completion_conditions": [
        {"type": "test", "evidence": "統合テストが成功"},
        {"type": "approval", "evidence": "QA チームが承認"}
      ]
    }
  ]
}

動作環境

• プラットフォーム: Codex
• 依存関係: Git、テストフレームワーク（オプション）、承認管理ツール（オプション）

注意事項

• 証拠の収集には適切な権限が必要な場合があります。
• テスト証拠を利用する場合は、テスト実行結果が標準出力または特定のファイルに出力されるように設定してください。
• Git 証拠はローカルリポジトリの状態に依存します。

ライセンス

MIT