القائمة
docs/PLAN/{YYMMDD}_{slug}/ の schema v3 仕様書を Codex で Gate 単位に実行する。 tasks.json を正とし、Gate 契約 (Goal/Constraints/AC) に基づいて実装・検証・レビューを行う。 Trigger: spec-codex-run, spec-run
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
repositoryを調査し、`docs/PLAN/YYMMDD_{slug}.md` にPhase、Gate、完了状態、実行ルール、チェック項目を持つ自己完結した永続計画を作成または再構成する。Use when the user asks for simple-plan、チェックリスト式の計画、複数停止点を持つ中規模作業、段階的なapp分割やlocal migration、production前Gate、または既存planの構成変更。単発Sprintでは収まらないが、詳細なworker委任計画までは不要な作業向け。既存planをそのまま実行・再開するだけの場合は使わない。
Cloudflare ベースの新規アプリ設計、または既存アプリを Cloudflare 構成へ大きく移行する前に、短い設計メモを作る。Workers、Agents SDK、Durable Objects、D1、KV、R2、Wrangler、Workers 上の Hono などの構成判断を実装前に整理するときに使う。通常の Cloudflare コード修正だけなら、公式 Cloudflare 実装系 skill を使う。
事前設計が必要な中〜大規模作業について、repositoryを調査し、依存関係・設計境界・worker/model・統合順・完了条件を持つsingle-md実行計画を `docs/PLAN/{YYMMDD}_{slug}.md` に作成してから実行する。局所実装はheadless Cursor CLI、複雑な実装・調査・レビューはmodelを明示したCodex subagent、共有境界・統合・最終判断はmain Codexが担う。短期作業は対象外。Trigger: cursor-agent-delegate、Cursorで計画、worker委任計画、依存関係を設計して実装
Cursor CLI headless worker を使い、ユーザーの実装指示を短いローカル実行計画に分解し、安全に分離できる小タスクだけを `cursor agent --print --yolo --trust --model composer-2.5-fast` に並列委任する。`.codex/tmp/YYMMDD_slug/` 配下で状態を管理し、docs/PLAN を作らず main Codex が統合と検収を行う。Trigger: cursor-agent-sprint-cli、Cursor CLI sprint、headless Cursor Agent 並列実装、CLI worker sprint、 Cursor を使って計画を実装
既存キャラクター画像を、承認制でピクセルアートの正準画像へ変換し、3状態パイロット、クロマ前処理、状態間ジオメトリ検証、9状態生成、遷移QA、仮配置、アプリ内確認、ロールバック可能な正式配置まで行う。キャラクターからCodexペットを作る依頼に加え、ジャンプで小さくなる、状態ごとに身長が変わる、足元が跳ねる、クロマ縁が出る、アニメーションを修復したい依頼で使用する。
Git commit automation for Codex. Use when the user asks for simple-add, a lightweight commit, or committing the current work with an optional push. Trigger: simple-add, simple commit, 軽量コミット, 変更をコミット, コミットして, -p で push
| name | dev:spec-codex-run |
| description | docs/PLAN/{YYMMDD}_{slug}/ の schema v3 仕様書を Codex で Gate 単位に実行する。 tasks.json を正とし、Gate 契約 (Goal/Constraints/AC) に基づいて実装・検証・レビューを行う。 Trigger: spec-codex-run, spec-run |
| user-invocable | true |
tasks.json を Single Source of Truth として Gate 単位に実行する。spec.md は背景と generated summary として扱う。既存 v3 PLAN は optional Codex 拡張がなくても実行できる。
対象が会話の文脈から明確な場合はその PLAN を使う。不明な場合は docs/PLAN/*/tasks.json を更新日順で上位 5 件提示してユーザーに確認する。
spec.md と tasks.json を読み、gates[] 全体・preflight[]・preDelegation[]・extensions.codex.delegationPolicy を把握する。
tasks.json に preDelegation[] が存在する場合、Cursor Agent への委任を使うかユーザーに確認する。使わない / preDelegation[] が空の場合は Codex 単独で全て実行する。
docs/PLAN 更新・Gate PASS 判定・最終統合・commit/push は常に main Codex が担う。
ユーザーが明示していない場合は確認する。使う場合は worktree-setup.md を読んでセットアップする。
Gate は実装完了を記録するチェックポイント。IMPL の実行順序は dependencies[] が制御し、Gate 通過はその事後確認として行う。
Gate を passed: true にできるのは、次を全て満たす場合だけ。
dependencies の全 Gate が passed: trueacceptanceCriteria が checked: truereview.result === "PASSED" または SKIPPED 適用条件を満たすpreflight[] に未チェック項目がある場合のみ実行する。manual: false はコマンドを実行、manual: true はユーザーに完了確認する。ac が成立した項目だけ checked: true にして sync する。
Cursor Agent を使う場合のみ実行する。Preflight の実行中に並行して進める。
tasks.json の preDelegation[] を読むprompt（詳細指示書）を確認し、不足があれば delegation-brief-template.md を Read して補完するcursor-agent -p --mode ask --output-format text --workspace <workspace> --model <model> "<prompt>"
relatedGate / relatedTodo に対応する AC を検証する際に回収する。main Codex は結果を待たずに残りの Gate の IMPL を進めるGate は「達成目標と検証条件の境界」であり、実行順序を定めるものではない。dependencies[] が空の Gate・Todo は他の完了を待たずに実行できる。実行順序は dependencies[] だけを制約として実行エージェントが自律的に判断する。
goal / constraints / acceptanceCriteria / todos / dependencies を把握するdependencies[] が空または全依存が解決済みの Gate・Todo から着手するtdd: true の Todo は失敗するテストを先に書く[SIMPLE] Todo は局所変更として処理するpreDelegation[] に切り出された作業は Pre-delegation 済みのためスキップするAC を 1 件ずつ検証する。AC に明示された検証手段（コマンド / テスト / HTTP / ブラウザ / ファイル確認）を優先する。同等代替した場合は review.summary に検証範囲を明記する。
Codex review の使い分け:
| タイミング | コマンド |
|---|---|
| Gate 中の差分確認 | codex review --uncommitted -（stdin に Gate id / Goal / Constraints / AC / 対象ファイル / 除外差分を渡す） |
| 複数 Gate をまとめて確認 | codex review --base <base> |
| コミット単位の確認 | codex review --commit <sha> |
P1 / blocker は FAIL。P2 は内容を精査して PASS / FAIL を判断する。P3 のみ、またはコメントなしなら PASS。codex review が使えない場合は自己レビューし、review.summary に codex review unavailable と明記する。
docs / config / comment のみの Gate、または [SIMPLE] 専用 Gate は review.result = "SKIPPED" でよい。
FAIL の場合のみ同じ Gate 内で修正して再 VERIFY する。3 ラウンドで解消しなければユーザーに報告して判断を仰ぐ。
実行中に追加 Gate が必要になった場合は kind を付けて追加する。
| 状況 | kind |
|---|---|
| 初期設計の漏れ | follow-up |
| review 由来の差分対応 | review-fix |
| 実機確認・最終検証 | verification |
tasks.json のみを更新する。spec.md generated 領域は直接編集しない。
更新対象: acceptanceCriteria[].checked / review / passed / status
更新後は必ず sync する。
bash .codex/skills/dev/spec-codex-run/scripts/sync.sh {YYMMDD}_{slug}
gates.length == 0 -> not-started
passed が 0 件、かつ全 AC が未 checked、かつ review/preflight 進捗もない -> not-started
いずれかの AC が checked、review が記録済み、または 0 < passed < gates.length -> in-progress
passed == gates.length && !reviewChecked -> in-review
passed == gates.length && reviewChecked -> completed
全 Gate の passed === true を確認したら:
status が in-review になっていることを確認するreviewChecked の更新はユーザー確認後に行う