codex-review-request
目的
Codex に対して、設計レビューと Permit 草案の整形を依頼する。 「このまま実装してよいか」ではなく「リスクと STOP 条件を洗い出す」ためのスキル。
CLI vs MCP(2026-01 時点)
| 方式 | スレッド継続 | 推奨 |
|---|---|---|
CLI (codex exec) | ✅ resume で可能 | 推奨 |
MCP (mcp_codex_codex) | ❌ 未実装 (Issue) | 非推奨 |
使用タイミング
- •Task Type = DesignDraft / Observation で文書を作った後
- •Implementation に入る前の Permit 相談
CLI 実行コマンド
新規レビュー
bash
codex exec -s read-only "プロンプト内容"
継続レビュー(session-id を使用)
bash
codex exec resume <session-id> "追加質問" # または codex resume <session-id>
オプション
| オプション | 用途 |
|---|---|
-s read-only | 読み取り専用 sandbox |
-s workspace-write | 書き込み可能 sandbox |
-m gpt-5.2 | モデル指定 |
--json | JSON 出力 |
-o result.md | 結果をファイルに保存 |
Output format (プロンプト内容)
markdown
# Codex Review Request: <topic>
## Reference Pack(必読ファイル)
- docs/design/START_HERE.md
- docs/design/STATUS.md
- 関連 mdBook 章: <path>
- 関連 TASK_INTAKE: <path>
- 直近 TRIAD_HANDOFF: <path>
- Allowlist 候補ファイル:
- <path1>
- <path2>
## Context (STATUS.md 要約 5行)
- 正本: ...
- ドラフト資産: ...
- 未成立図面: ...
- 次の最小 Permit: ...
- 直前の決定: ...
## Task Type
{DesignDraft / Observation / Implementation}
## What changed (or will change)
- ...
## 変更ファイル一覧(diff)
- <path>: <変更概要>
## Non-goals
- ...
## Risks (max 3)
1. ...
2. ...
3. ...
## Questions for Codex (max 5)
1. ...
2. ...
## Requested output from Codex
- [ ] Permit 草案(Implementation の場合)
- [ ] レビューコメント / 見落としリスク
- [ ] STOP 条件の精査
- [ ] Allowlist の妥当性チェック
session-id の管理
保存場所
レビュー完了後、session-id を以下に記録:
- •
task.mdの先頭に追記 - •または
docs/triad/CODEX_SESSIONS.mdに蓄積
形式
markdown
## Codex Sessions | Date | Topic | Session ID | Status | |------|-------|------------|--------| | 2026-01-24 | Space Delete Permit | 019bef05-... | ✅ |
Codex からの返答を受けた後(自動反映ルール)
1. 指摘事項の分類
| 分類 | 判断基準 | アクション |
|---|---|---|
| 同意 | 論理的に正しい | 即座に設計文書に反映 |
| 部分同意 | 方向は正しいが詳細が異なる | 反映しつつ補足を追記 |
| 要相談 | 判断できない | Human に相談してから反映 |
| 不同意 | 前提が異なる | Codex に再質問 or Human に確認 |
2. 反映フロー
code
Codex 返答
↓
指摘を分類(同意 / 部分同意 / 要相談 / 不同意)
↓
├── 同意 / 部分同意 → 設計文書に反映 → Human に報告
└── 要相談 / 不同意 → Human に確認依頼 → 回答後に反映
注意
- •Codex は「許可を出す」立場ではなく「設計を見る」立場
- •最終承認は Human
- •Reference Pack がないと Codex の精度が下がる
- •指摘事項は放置せず、必ず反映か相談のどちらかを行う
- •session-id を保存して継続レビューを可能にする
次に使う Skill
- •task-report(タスク完了時)
- •triad-task-intake(Implementation の場合)
- •human-approval-gate(承認)