메뉴
task-list.jsonのタスクを実行。workflowフィールド（tdd/e2e/task）に応じたワークフローで実装。 Trigger: dev:developing, /dev:developing, 実装, 開発, implementing, develop
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:developing |
| description | task-list.jsonのタスクを実行。workflowフィールド（tdd/e2e/task）に応じたワークフローで実装。 Trigger: dev:developing, /dev:developing, 実装, 開発, implementing, develop |
| allowed-tools | ["Read","Write","Edit","Bash","Glob","Grep","Task","AskUserQuestion","TaskCreate","TaskList","TaskGet","TaskUpdate"] |
| hooks | {"PostToolUse":[{"matcher":"Task","hooks":[{"type":"command","command":"$CLAUDE_PROJECT_DIR/.claude/hooks/dev/commit-check.sh"}]}]} |
ワークフロー別の実行方法:
scripts/build-prompt.sh でプロンプトを自動構築する。agent本文 + 追加コンテキスト + LEARNINGS_FOOTER が一括で組み立てられる。
prompt = Bash("bash scripts/build-prompt.sh {agent} $LEARNINGS_PATH \"タスク: {name}\n{description}\"")
Task({ prompt, subagent_type: "general-purpose", model: {指定モデル} })
エージェントが❌（FAILED）を返した場合:
エスカレーション報告形式: 「{タスク名}の{ステップ名}が3回失敗しました。{エラー要約}。どう対応しますか？」
| Step | agent | model | type | 備考 |
|---|---|---|---|---|
| 1 CYCLE | tdd-cycle.md | opus | general-purpose | RED→テストcommit→GREEN→REFACTOR(+OpenCode) |
| 2 REVIEW | tdd-review.md | sonnet | general-purpose | 過剰適合・抜け道(+OpenCode) + テスト資産管理。問題→Step 1へ |
| 3 CHECK | quality-check.md | haiku | general-purpose | lint/format/build |
| 4 SPOT | spot-review.md | sonnet | general-purpose | commit後の即時レビュー(+OpenCode) |
| 4b FIX | spot-fix.md | opus | general-purpose | SPOT FAIL時のみ: 修正→CHECK→再SPOT（最大3回） |
CHECK/SPOT/FIX以外はサブエージェント呼び出しなし。メインが直接実行。
| Step | agent | model | type | 備考 |
|---|---|---|---|---|
| 1 IMPL | - | - | - | メインが直接UI実装 |
| 2 AUTO | - | - | - | メインが agent-browser CLI で直接検証 |
| 2b FIX | - | - | - | AUTO NG時: メインが直接修正（最大3回） |
| 3 CHECK | quality-check.md | haiku | general-purpose | lint/format/build |
| 4 SPOT | spot-review.md | sonnet | general-purpose | commit後の即時レビュー(+OpenCode) |
| 4b FIX | spot-fix.md | opus | general-purpose | SPOT FAIL時のみ: 修正→CHECK→再SPOT（最大3回） |
IMPL→AUTO→FIX ループ実行手順:
# Step 1 IMPL（メイン直接実行）
# メインが直接 Read/Write/Edit でUI実装する
# Step 2 AUTO + FIX ループ（メイン直接実行）
fix_count = 0
loop:
# agent-browser CLI で直接検証
Bash("agent-browser open <対象URL>")
Bash("agent-browser snapshot -i") # 対話要素確認
Bash("agent-browser screenshot <path>") # スクリーンショット取得
# 操作・検証を実行し、結果を評価
Bash("agent-browser close")
if 検証OK → break
fix_count += 1
if fix_count >= 3 → エスカレーション → break
# Step 2b FIX（メイン直接実行）
# 検証で見つかった問題をメインが直接修正
goto loop
# Step 3 CHECK, 4 SPOT/FIX は共通フロー（Task委譲、テーブル通り）
SPOT/FIX以外はサブエージェント呼び出しなし。エージェントが直接実行。
| Step | agent | model | type | 備考 |
|---|---|---|---|---|
| 1 EXEC | - | - | - | エージェントが直接実行（設定ファイル作成、コマンド実行など） |
| 2 VERIFY | - | - | - | 検証（ファイル存在確認、ビルド確認など） |
| 3 SPOT | spot-review.md | sonnet | general-purpose | commit後の即時レビュー(+OpenCode) |
| 3b FIX | spot-fix.md | opus | general-purpose | SPOT FAIL時のみ: 修正→再SPOT（最大3回） |
task-list.json と story-analysis.json を読み込むGlob("docs/FEATURES/**/task-list.json") で検索metadata.status が "completed" のものを除外（未定義は "pending" 扱い）$STORY_DIR として確定。$STORY_DIR/task-list.json を $TASK_LIST とするゲート: $TASK_LIST が確定していなければ次に進まない。
$TASK_LIST を読み込み、全タスクを TaskCreate で登録$STORY_DIR/story-analysis.json を Read し、$STORY_ANALYSIS として保持する
goal: ストーリーの達成目標scope.included / scope.excluded: スコープ境界（実装時のスコープクリープ防止に使用）LEARNINGS.md を作成:
bash scripts/init-learnings.sh <ストーリーディレクトリ>
$LEARNINGS_PATH を作成した LEARNINGS.md の絶対パスに設定ゲート: タスクが登録され、LEARNINGS.md が作成されていなければ次に進まない。
planPath 参照: task-list.json の context.planPath が存在する場合:
$PLAN_CONTEXT として保持する$PLAN_CONTEXT を含める。その際、用途を明示するヘッダーを付けること:
prompt = Bash("bash scripts/build-prompt.sh {agent} $LEARNINGS_PATH \"タスク: {name}\n{description}\" \"## 全体計画（設計判断・スコープ確認に参照）\n$PLAN_CONTEXT\"")
story-analysis.json 参照: $STORY_ANALYSIS が存在する場合:
scope.excluded をスコープクリープ防止のガードレールとして使用。タスク実装中に scope 外の変更を行おうとしていないか確認するgoal をタスクの実装判断（方針に迷った際の判断基準）に使用するscope 情報を追加コンテキストに含めてよいbash ".claude/skills/dev/agent-browser/setup-agent-browser.sh"
SUCCESS:<prefix> → agent-browser CLI 使用可能FAIL:<reason> → AskUserQuestion で <reason> を報告して中断workflow フィールドに応じて上記「ワークフロー別ステップ・委譲先」を適用ゲート: 全タスクが完了しなければ次に進まない。
全タスク完了後、$TASK_LIST の metadata.status を "completed" に更新して Write で保存する。
これにより次回の計画選択時に候補から除外される。