implement-spec-with-codex について
implement-spec の手順でコード実装を Codex に委任するスキルです。仕様に沿って開発する際、計画・統合・検証・レビューはオーケストレーターが担います。
主な機能
- 01codex exec による実装の委任
- 02独立した worktree での並行タスク分割
- 03計画と統合をオーケストレーターが担当
- 04差分レビューと検証ゲートの実行
- 05ブラウザーでのビジュアル変更の検証
活用シーン
- 01仕様をレビュー可能な実装単位に分割
- 02独立した実装タスクの並行実行
- 03本番の描画経路でビジュアル変更を確認
- 04コミット前の統合済み変更の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ dzhng/ skills --skill implement-spec-with-codexインストール後、Claude Code で/implement-spec-with-codexを入力して読み込まれたか確認します。
詳細
Codex で仕様を実装する
implement-spec を正確に実行します。同じループ、同じゲート、同じメンテナンスチェックポイントを使い、コードは Codex が記述します。このスキルを呼び出すこと自体が、codex スキルのもとで codex exec に委任することを許可する明示的な依頼です。
役割分担
- 可能な限り Codex が実装します。 実装パスはすべて、デフォルトで
codex execに任せます。codex スキルに従って明確に切り分け、プロンプトブロック、サンドボックスの選択、exec の稼働状況を指定してプロンプトを作成します。独立したスライスは、implement-spec がサブエージェントに並行して任せる箇所と同じ箇所で、別々のワークツリーを使って並行実行します。 - オーケストレーションとレビューはあなたが担当します。 仕様のループはあなたが主導します。次のスライスを選び、計画とコードをすり合わせ、各プロンプトを最初から最後まで作成し、差分を統合し、ゲートを実行し、統合後のツリーをレビューし、コミットし、引き継ぎ内容を更新し、メンテナンスチェックポイントを実行します。これらは一切委任しません。
細かく切り分けるより自分で行うほうが効率的な場合に限り、そのパスは自分で担当します。たとえば、小さな修正、計画とのすり合わせ、統合時の競合などです。
ルール
- すべての結果に責任を持ちます。差分全体を読み、自分で検証を実行してください。「Codex が完了したと言っている」だけでは、完了とはみなしません。
- ビジュアルの結果には、implement-spec の追加の証明 2 点(本番ルートのピクセル差分と、予備情報なしでの評価)が、ここではさらに厳しく求められます。サンドボックス内の Codex は変更のレンダリングを見ていないため、本番のレンダリング経路をまったく通らないパスでも、完全に「検証済み」に見えてしまいます。
- サンドボックス内の Codex は、実行結果を見ていないコードを提出します。ビジュアルに関する各スライスは自分でブラウザー検証し、修正ラウンドも見込んでください。ゲートに失敗した場合は、失敗の証拠を添えてフォローアップを再開します。自分で修正するのは、再度プロンプトを出すより手間が少ない場合に限ります。
- コミットの管理は引き続きあなたが担当します。コミットする前に毎回、統合後のツリーの変更一覧をレビューします。これは、implement-spec が統合担当のレビュアーに求める手順と同じです。
コメント
Markdown 対応