Markdown コンパイラアーキテクチャ
中核となるのは、Markdown 仕様を GitHub Actions YAML に変換するコンパイラです。自然言語の指示、コードブロックの制約、メタデータを解析し、Actions のステップとトリガーにマッピングすることで、「意図の記述」から「実行可能な設定」への自動変換を実現します。
gh-aw (GitHub Agentic Workflows) は、「自然言語プログラミング」によるリポジトリ運用の再構築を目指した GitHub 公式の自動化オーケストレーションツールです。GitHub CLI 拡張として提供され、開発者は読みやすい Markdown 形式で意図や制約を記述でき、それが標準的な GitHub Actions YAML にコンパイルされます。実行時にはコンテナ化されたサンドボックスが起動し、AI エージェント（Copilot や Claude などをサポート）がリポジトリのコンテキストを読み取り、Issue/PR イベントを解釈してタスクを実行します。AI 自動化のセキュリティ懸念に対処するため、gh-aw は「デフォルト最小権限」ポリシーを強制し、コードのコミットやコメント投稿などの書き込み操作はすべて safe-outputs などの制御されたチャネルを経由する必要があり、インテリジェンスと監査可能性を両立させています。
| ✕従来の課題 | ✓革新的ソリューション |
|---|---|
| YAML 設定ファイルの構文は煩雑で壊れやすく、複雑なロジックは可読性が低いため、自動化スクリプトのミスが頻発する。 | Markdown コンパイルパラダイム：自然言語の仕様書でワークフローを記述し、コンパイラが Actions YAML を生成する「ドキュメント即コード」を実現。 |
| AI を CI/CD に組み込む際にガードレールが不足しており、エージェントに直接書き込み権限を与えると誤削除や幻覚のリスクがある。 | サンドボックス安全実行：隔離されたコンテナでエージェントを実行し、`safe-outputs` 機構を通じてすべての副作用（書き込み）を厳格に管理。 |
| 従来のスクリプトは非構造化な Issue 記述や PR コンテキストの理解力が弱く、複雑な協業シナリオに対応できない。 | ネイティブコンテキスト認識：GitHub リポジトリ、Issue、PR などのオブジェクトに対する意味的理解を内蔵し、複雑な API 呼び出しを不要に。 |
1gh extension install github/gh-aw1gh aw init --engine copilot # または claude, codex1vim .github/workflows/agent.md && gh aw compile && git push