Level 1 実践: リポジトリを読んで変更計画を作る
約5分
対象読者: Codex Level 1 の委任範囲と完了条件を、実際のリポジトリ作業で身につけたい方
前提知識: Level 0 を完了していること
このチュートリアルについて
Section titled “このチュートリアルについて”概念・到達基準を先に確認したい方は、Codex Level 0〜10 の定義 を参照してください。
一般論だけでは、既存のルーティング、デザインシステム、検証コマンドに合う実装か判断できません。Level 1 では編集せず、実在するファイルを根拠に調査します。
このレベルで完成するもの
Section titled “このレベルで完成するもの”関連ファイル一覧と変更計画を完成させます。作業量の多さではなく、Level 1 の委任範囲と確認条件を再現できることが目標です。
Step 1: 依頼の境界を決める
Section titled “Step 1: 依頼の境界を決める”Codex に渡す前に、目的、対象、対象外、完了条件を短く書きます。次の依頼文をプロジェクトに合わせて調整してください。
編集はまだ行わず、このリポジトリのポートフォリオ表示に関係するファイルを調査してください。各ファイルの役割、既存パターン、変更候補、検証コマンドをパス付きで報告してください。確認: Codex が作業を始める前に、対象範囲と不明点を説明できれば次へ進みます。
Step 2: 実践する
Section titled “Step 2: 実践する”- Level 0 の要件メモとリポジトリの指示ファイルを読ませる。
- ページ、コンポーネント、データ、スタイル、テストの入口を特定させる。
- 変更対象、変更しない範囲、実行すべき検証を計画にまとめさせる。
一度に範囲を広げず、各段階の差分や出力を確認してから次へ進みます。
Step 3: 完了条件を確認する
Section titled “Step 3: 完了条件を確認する”計画の各項目に実在するパスがあり、推測と確認済み情報が区別されていれば完了です。
確認結果には、実行した操作、得られた証拠、未確認事項を残します。成功したときだけでなく、途中で止めた理由も記録します。
よくあるトラブル
Section titled “よくあるトラブル”Codex が依頼範囲を越えた
Section titled “Codex が依頼範囲を越えた”作業を止め、差分を確認します。対象ファイルと変更禁止範囲を依頼文へ追加し、承認した範囲だけを再実行します。
完了したか判断できない
Section titled “完了したか判断できない”「実装する」のような曖昧な条件を、ファイル、コマンド、画面、レビュー結果など観測できる条件へ置き換えます。
次のステップ
Section titled “次のステップ”次は Level 2 で、委任範囲を一段広げます。
クイズ