概要
https://zenn.dev/govtechtokyo/articles/f1197ab6501e45
詳細内容
## GitHub社謹製Spec KitにCodex CLI対応のPRを送った話
https://zenn.dev/govtechtokyo/articles/f1197ab6501e45
GovTech東京のエンジニアが、AIコーディングエージェント向けOSSツールキット「GitHub Spec Kit」にOpenAI Codex CLIのサポートを追加するPull Requestを送り、コミュニティ協働と技術的議論を通じてマージを実現した経験と、そこから得られた仕様駆動開発実践への深い洞察を共有します。
**Content Type**: ⚙️ Tools
**Language**: ja
**Scores**: Signal:5/5 | Depth:4/5 | Unique:4/5 | Practical:5/5 | Anti-Hype:4/5
**Main Journal**: 89/100 | **Annex Potential**: 87/100 | **Overall**: 88/100
**Topics**: [[Spec-Driven Development, AIコーディングエージェント, OSS貢献, GitHub Spec Kit, OpenAI Codex CLI]]
GovTech東京のエンジニアが、GitHubが公開するAIコーディングエージェント向けのOSSツールキット「Spec Kit」に、OpenAI Codex CLIのサポートを追加するPull Request（#14）を送り、無事マージされた経緯と学びを解説します。Spec Kitは、AIを活用した開発における手戻りや品質のばらつきを防ぐため、仕様定義から実装までを体系的に進める「仕様駆動開発（Spec-Driven Development）」を支援するツールです。
著者は、日々の業務で生成AIを活用したエージェンティックコーディングによるPoC開発に注力しており、特にスピードと再現性が求められる場面で仕様駆動開発の有効性を実感していました。PR作成当時（2025年9月初旬）、Spec KitはGitHub Copilot、Claude Code、Gemini CLIのみをサポートしており、ちょうど大幅なアップデートで注目を集めていたCodex CLIの対応が不可欠であると判断し、業務上の価値を見出してPR作成に至りました。
技術的な課題として、Codex CLI固有のプロンプト読み込み方式、独自のメモリ管理システム（AGENTS.md）、明示的な初期化コマンドの必要性がありました。これらの課題に対し、PRではCodex CLI用のテンプレート追加（ShellとPowerShell対応）、プロジェクトごとのコマンドディレクトリ自動生成、パッケージテンプレートが利用できない場合のフォールバック機構、そして`specify init --ai codex`コマンドによる初期化フローの完全自動化などを実装しました。
コミュニティとの議論は、実装の方向性の確認から始まり、フォールバック機構の必要性やディレクトリ構造の最適化、プロジェクト単位での設定に関する設計議論へと発展しました。特に、プロジェクトメンテナーからの「エージェント固有のコードを最小限に抑える」という指摘は、汎用的なフレームワークとしてのSpec Kitの将来的な拡張性を考慮する上で重要な視点となり、共通ヘルパー関数の利用やドキュメントの明確化などの改善につながりました。
このOSS貢献を通じて得られた学びは多岐にわたります。最も重要なのは、実際にツールを使用する開発者からのフィードバックが、より実用的で汎用的な実装につながったという「コミュニティとの協働の価値」です。また、当初機能を詰め込みすぎたPRがレビューを通じて本質的な変更に絞られたことで、「設計の簡潔性」の重要性を実感しました。約2週間のPR期間中に5つものAIツールが追加される活発なプロジェクトでのコンフリクト解消は困難でしたが、それはエコシステムの急速な成長を示すものであり、多様なAIツールの設計思想に触れる貴重な機会でした。この経験は、仕様駆動開発プロセスの深い理解につながり、業務で取り組むエージェンティックコーディングのレベルアップに直結したと著者は語っています。