메뉴
既存キャラクター画像を、承認制でピクセルアートの正準画像へ変換し、3状態パイロット、クロマ前処理、状態間ジオメトリ検証、9状態生成、遷移QA、仮配置、アプリ内確認、ロールバック可能な正式配置まで行う。キャラクターからCodexペットを作る依頼に加え、ジャンプで小さくなる、状態ごとに身長が変わる、足元が跳ねる、クロマ縁が出る、アニメーションを修復したい依頼で使用する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
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 を使って計画を実装
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
docs/PLAN/{YYMMDD}_{slug}/ の schema v3 仕様書を Codex で Gate 単位に実行する。 tasks.json を正とし、Gate 契約 (Goal/Constraints/AC) に基づいて実装・検証・レビューを行う。 Trigger: spec-codex-run, spec-run
SOC 직업 분류 기준
| name | character-to-codex-pet |
| description | 既存キャラクター画像を、承認制でピクセルアートの正準画像へ変換し、3状態パイロット、クロマ前処理、状態間ジオメトリ検証、9状態生成、遷移QA、仮配置、アプリ内確認、ロールバック可能な正式配置まで行う。キャラクターからCodexペットを作る依頼に加え、ジャンプで小さくなる、状態ごとに身長が変わる、足元が跳ねる、クロマ縁が出る、アニメーションを修復したい依頼で使用する。 |
既存画像をいきなり全状態へ展開しない。承認済みの正準画像と192x208の正準セルを固定し、idle・running-right・jumpingの3状態パイロットで生成品質を証明してから残りを作る。アプリ内確認が終わるまで中間素材を保持する。
${CODEX_HOME:-$HOME/.codex}/skills/.system/imagegen/SKILL.md を最後まで読み、通常は組み込みimage_genを使う。hatch-petのインストール済みパス、または ${CODEX_HOME:-$HOME/.codex}/vendor_imports/skills/skills/.curated/hatch-pet を探し、対象SKILL.mdを最後まで読む。imagegen、行準備・抽出・合成・基本検証はhatch-pet、このスキルのスクリプトは正準セル、クロマ前処理、状態間ジオメトリ、遷移QA、安全配置を担当する。SKILL_ROOTはこのSKILL.mdを含むディレクトリの絶対パスとして扱い、同梱スクリプトは$SKILL_ROOT/scripts/...で実行する。decoded/を上書きしない。--allow-large-correctionを明示できる。idle→jumping→idleとidle→failed→idleを必ず確認する。prompts/、decoded/、透明化済み行、抽出フレーム、manifestを削除しない。1536x1872だけとする。追加行や別バージョンを推測せず、Codex App側の契約を別途確認できた場合だけ拡張する。既存ペットを修復する場合は元runを直接変更せず、兄弟repair runを作る。正常行はそのまま保持し、不合格行全体だけを再生成する。詳細はproduction-contracts-ja.mdの修復契約に従う。
次のゲートを表示し、常に1つだけを進行中にする。
参照画像、ペット名、ID、説明、維持する顔・体型・配色・服装・模様・小物、削除可能な背景・文字・影、ピクセル密度を確定する。判断できる項目は推定し、短く報告する。
hatch-petのprepare_pet_run.pyをpixelスタイルで実行する。生成されたpet_request.json、imagegen-jobs.json、プロンプト、レイアウトガイドを正とする。
既存画像を編集対象とするstyle-transferとして、prompts-ja.mdの基準画像契約を使う。候補は別ファイルで保存し、192x208相当でも顔と輪郭が読めるか確認する。
承認された画像をreferences/canonical-base.pngへ固定する。次に次のスクリプトでセル寸法の正準画像を作る。
python "$SKILL_ROOT/scripts/prepare_canonical_cell.py" \
--input <run>/references/canonical-base.png \
--output <run>/references/canonical-cell.png \
--report-json <run>/qa/canonical-cell.json
canonical-cell.pngを全行の生成入力へ追加する。
最初にidle、running-right、jumpingだけを生成する。各行へ正準画像、正準セル、元画像、状態別レイアウトガイドを添付する。
生成後、production-contracts-ja.mdのパイロット工程を実行する。
preprocess_chroma_rows.pyで非破壊の透明化・デスピルを行う。hatch-petで3行だけをstable-slots抽出する。normalize_pet_geometry.pyを通常モードで実行する。1件でも不合格なら該当行を再生成する。パイロットが通るまで残りを作らない。
running-rightが左右反転に安全なら専用スクリプトでrunning-leftを派生する。文字、ロゴ、左右固有模様、小物方向、光源の意味が壊れる場合は個別生成する。
続けてwaving、jumping以外の未生成行、failed、waiting、running、reviewを生成する。各行は独立したimagegen呼び出しにする。
サブエージェントへ委任する場合、許可が曖昧なら開始前に確認する。同時生成は最大2行、各担当は1行だけを扱い、親がmanifest、正準画像、合成、修復を管理する。
全行へクロマ前処理を行い、stable-slotsで抽出する。抽出した損失なしPNGフレームを入力としてnormalize_pet_geometry.pyを実行する。完成WebPを再入力に使わない。
正規化後フレームからアトラス、検証JSON、コンタクトシート、状態別GIFを作る。さらにrender_transition_previews.pyで状態遷移GIFを作る。qa-ja.mdを全項目確認し、HighまたはMediumがあれば該当行だけ修復する。
package_pet_safely.py stageでrun内に候補パッケージを作る。この段階では${CODEX_HOME:-$HOME/.codex}/pets/<pet-id>を変更しない。
package_pet_safely.py previewで<pet-id>-candidateとして一時配置し、次を実機確認する。正式IDは変更しない。
確認結果をacceptance.jsonとrun summaryへ記録する。未確認の成果物は「暫定完成」と報告し、完成扱いにしない。
ユーザーがアプリ内で承認した後だけ、次を実行する。
python "$SKILL_ROOT/scripts/package_pet_safely.py" promote \
--candidate-dir <run>/candidate-package \
--confirm-in-app-accepted
既存ペットは${CODEX_HOME:-$HOME/.codex}/pets/.backups/へ退避される。問題があればrollbackを実行する。
正式承認後に限り中間素材を整理する。正準画像、正準セル、最終WebP、検証、ジオメトリレポート、コンタクトシート、状態別GIF、遷移GIF、run summary、候補受付記録は残す。