메뉴
Codex Plan Mode 専用。docs/PLAN/{YYMMDD}_{slug}/ に schema v3 仕様書を作成する。 Gate 契約 (Goal / Constraints / Acceptance Criteria)、Mermaid 図、Cursor Agent 委任ヒントを含む。 Trigger: spec-codex
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 |
| description | Codex Plan Mode 専用。docs/PLAN/{YYMMDD}_{slug}/ に schema v3 仕様書を作成する。 Gate 契約 (Goal / Constraints / Acceptance Criteria)、Mermaid 図、Cursor Agent 委任ヒントを含む。 Trigger: spec-codex |
| context | fork |
| user-invocable | true |
Codex を有能なエンジニアとして委任できる契約書としての仕様書を作る。
Plan Mode でない場合は次だけを返して停止する。
このスキルは Codex Plan Mode 専用です。Plan Mode に切り替えて spec-codex を再実行してください。
date +%y%m%d で日付を取得するdocs/PLAN/ を確認し、{YYMMDD}_{slug} が既存ディレクトリと衝突していないことを確かめる成果物: 確定した {YYMMDD}_{slug}
完了: slug がユーザー確定済みで衝突がない
init-plan.sh を実行してディレクトリとテンプレートファイルをセットアップする。
bash .codex/skills/dev/spec-codex/scripts/init-plan.sh {YYMMDD}_{slug}
成果物: docs/PLAN/{YYMMDD}_{slug}/ ディレクトリ + references/context.md / tasks.json
完了: スクリプトがエラーなく完了し、ディレクトリと各ファイルが存在する
この PLAN 固有の確認済み事実を記録する。プロジェクト全体のルールや構成は対象外。
references/ にコピーまたは要約するdocs/PLAN/{YYMMDD}_{slug}/references/context.md を編集して確認済み事実を記録する成果物: docs/PLAN/{YYMMDD}_{slug}/references/context.md（内容が埋まった状態）
完了: 後続 Step の根拠として使える状態になっている
docs/PLAN/{YYMMDD}_{slug}/references/discovery.md を Write する成果物: docs/PLAN/{YYMMDD}_{slug}/references/discovery.md
完了: Completeness Check が全て満たされ、計画段階で解消できる不明点が残存リスクに残っていない
discovery.md の Gate Contract Inputs を起点に、設計決定事項・アーキテクチャ詳細を spec.md に書く<!-- generated:begin --> / <!-- generated:end --> markers だけ置く成果物: docs/PLAN/{YYMMDD}_{slug}/spec.md（authored セクション）
完了: discovery.md の Gate Contract Inputs が設計決定事項とアーキテクチャ詳細に反映されている
Gate セクションを Read し、必須フィールドを把握するdiscovery.md の Gate Contract Inputs（Constraints / Acceptance Criteria）を起点に Gate を設計するtasks.json の gates[] を編集して内容を埋める成果物: docs/PLAN/{YYMMDD}_{slug}/tasks.json の gates[]
完了: 全 Gate に goal / constraints / acceptanceCriteria が揃い、依存関係に循環がない
Todo セクションを Read し、軽量フィールドの定義を確認するtasks.json の gates[].todos[] を編集するtasks.json のトップレベル preDelegation[] に切り出す。各項目に writeScope / verification / prompt（詳細指示書）/ relatedGate / relatedTodo を設定する成果物: docs/PLAN/{YYMMDD}_{slug}/tasks.json の gates[].todos[] と preDelegation[]
完了: 各 Todo が軽量フィールドのみを持ち、先行実行できる作業が preDelegation[] に切り出されている
Preflight セクションを Read し、対象カテゴリ（network 必須 / global 書き込み / 対話ログイン）を確認するdiscovery.md の ### Preflight にある項目を起点に、対象カテゴリのみを抽出するtasks.json の preflight[] を編集する。該当なければ preflight: [] とし、spec.md の Preflight セクションを省略する成果物: docs/PLAN/{YYMMDD}_{slug}/tasks.json の preflight[]
完了: network 必須・global 書き込み・対話ログインのみが Preflight に入っており、通常コマンドが混在していない
spec.md の generated 領域を tasks.json と一致させるbash .codex/skills/dev/spec-codex-run/scripts/sync.sh {YYMMDD}_{slug}
docs/PLAN/{YYMMDD}_{slug}/references/plan-review.md に Write する成果物: docs/PLAN/{YYMMDD}_{slug}/references/plan-review.md
完了: tasks.json が parse でき schemaVersion === 3。generated 領域が同期されている。plan-review.md が PLAN REVIEW APPROVED
作成したファイルパス、Gate 数、使用した Mermaid 図の種類、Cursor 委任ヒントの有無、残存リスクの有無を報告する。
docs/PLAN/{YYMMDD}_{slug}/ 以下に spec.md / tasks.json / references/context.md / references/discovery.md / references/plan-review.md が存在するtasks.json の schemaVersion === 3goal / constraints / acceptanceCriteria / todos / review / passed があるspec.md に <!-- generated:begin --> / <!-- generated:end --> があり generated 領域が同期されているplan-review.md が APPROVED各 Step の手順内でリンク先を Read することで参照される。