AgentSkillsCN

codex-review-request

>

SKILL.md
--- frontmatter
name: codex-review-request
description: >
  Codex へのレビュー依頼を固定フォーマットで出力。
  Permit 草案の整形と設計穴の指摘を目的とする(実装許可ではない)。
  **CLI (`codex exec`) を使用してスレッド継続可能。**
inputs:
  - Task Intake
  - STATUS.md
  - 関連 mdBook 章
  - triad-handoff(あれば)
outputs:
  - Codex へ投げるレビュー依頼文
  - 指摘事項の反映(同意時)
  - session-id(継続用)
rules:
  - 「実装してよいですか?」ではなく「レビューして Permit を整形して」が目的
  - **CLI (`codex exec`) を使用(MCP より信頼性高い)**
  - session-id を保存してスレッド継続可能にする
  - Codex の出力を受けて Human 承認 → Permit 確定
  - Reference Pack(必読ファイル)を必ず含める
  - **指摘事項は同意できれば即反映、同意できなければ Human に相談**

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モデル指定
--jsonJSON 出力
-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(承認)