本文へ移動
cccskills
無料GitHub で公開

cursor-agent-delegate

事前設計が必要な複数段階のCursor委任作業で、依存関係・担当・検収条件を持つ永続PLANを作成・実行する。

インストール方法を見る

含まれるファイル(10)

  • SKILL.md10.0 KB
  • agents/openai.yaml374 B
  • references/delegation-prompt-template.md5.4 KB
  • references/operations.md2.4 KB
  • references/review-checklist.md5.8 KB
  • references/task-routing.json14.1 KB
  • references/ui-contract.md10.2 KB
  • scripts/cursor_cli_delegate.py13.6 KB
  • scripts/init_plan.sh1.1 KB
  • templates/plan.md14.8 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

cursor-agent-delegate

main Codexが計画、設計判断、worker選定、進捗管理、統合、最終検収を一貫して担う。

適用範囲

複数moduleやstageが絡み、実装前に依存関係、shared contract、統合順を固定する必要がある作業に使う。短期の局所作業にはcursor-agent-sprint-cli、owner/modelやtask graphまで不要な永続チェックリストは、プロジェクトの既存計画形式で扱う。

計画作成だけの依頼では、実行前レビューで計画の整合を確認して終了する。実装・実行まで依頼されている場合は、計画を作っただけで止めず、検収・統合まで進める。

参照先

Cursor能力の前提

Composer 2.5の適用範囲には、long-horizon task、multi-file change、数百tool call、testをoracleにしたfeature deletion/reimplementationを含める。Fast variantは発表上Standardと同じintelligenceとして扱う。Composer 2.5とComposer model pageを根拠とする。

Cursor実装には、固定contract、negative test、scope制限、mainによるdiff検収を必須とする。公称benchmarkの未達成caseと公式記事が報告するtraining時のreward hackingを、この検収要件へ反映する。

所有と委任

実行主体は判断の確定度、実装の独立性、write scope、検証oracle、副作用と可逆性から決める。complexityは工数、prompt量、timeout、検証強度へ反映する。Codex subagentは補助workstreamに限定する。

  1. main Codex所有 未解決のarchitecture/product/security判断、shared contractやstate ownershipの決定、反復調整が必要な結合実装、外部・不可逆state変更、統合、最終検収を扱う。
  2. Cursor実装 contractと判断がfixedまたは決定規則付きでbounded、実装がindependentまたはstaged、write scopeがisolatedまたはserializable、検証oracleがstrongまたは限定可能なpartial、副作用が可逆な実装を扱う。complexityはlow、medium、highを対象とする。
  3. Codex subagentによる補助workstream 独立したコード調査、複数案・仮説の比較、read-only audit、test/log/障害原因分析、独立レビューだけを扱う。sourceを編集させず、mainが結果を要約・採否判断する。小さな調査や、前後の判断と密結合な分析はmainが直接行う。

Cursorが利用できない実装はmainが所有する。Codex subagentの範囲は補助workstreamに維持する。

auth、secret、crypto、crash/retry/lease、外部providerなどのrisk modifierには、mainが固定するinvariant、negative case、禁止副作用、real secretやproduction stateを使わないoracle、局所rollbackを必須controlとして設定する。controlを満たす実装はCursor、満たせない実装はmainが所有する。

未解決判断または結合実装を含むtaskは、次の所有境界へ分割する。

  1. mainがcontract、invariant、acceptance oracle、integration boundaryを固定する。
  2. Cursorが参照実装の適応、feature deletion/reimplementation、adapter、codec、validator、fixtureを分離scopeで実装する。
  3. mainがrisk-specific verification、統合、最終acceptanceを行う。

分割で同じsourceの往復編集が増える、契約固定だけで実装がほぼ終わる、context再構築と検収costが利益を上回る場合は分割しない。

UI / UX契約

UI影響をPlanning policyでrequiredまたはnot_applicableにする。UI変更がなければUI節を削除し、詳細を読まない。

requiredならUI契約を読み、main所有のUI-F → surface実装 → UI-Iをtask graphへ組み込む。UI-Fでcomponent、token、共通surface owner、label、i18n、layoutと検証commandを具体化し、固定blockをworker契約へ転記する。UI-Iは横断の見た目・操作・同時表示・対応環境を検収する。

UI-FとUI-Iは委譲せず、検出済み違反を後追いtaskへ移して完了にしない。Cursorへ渡せるのは、UI-F完了後の判断を増やさない独立surface実装だけである。参照UIのtraceとdesign system契約は区別する。

実行フロー

1. repositoryを調査する

目的、対象外、現状、設計境界、shared contract、UI影響、検証方法を確認する。task graphを左右する未解決事項は、追加調査またはユーザー確認で解消する。ここでUI影響の有無を判定し、Planning policyのUI / UX contractを確定する。

2. planを初期化する

WORKSPACE="$(pwd)"
SKILL_DIR="$WORKSPACE/.codex/skills/dev/cursor-agent-delegate"
"$SKILL_DIR/scripts/init_plan.sh" --workspace "$WORKSPACE" --slug <slug>

3. task graphと契約を設計する

task-routing.jsonを読み、次の順で各taskを解決する。

  1. non-delegable ownership boundary
  2. decision state
  3. implementation independence
  4. write scope isolation
  5. verification oracle
  6. side-effect scopeとreversibility
  7. complexityに応じたprompt量、timeout、検証強度
  8. 必要な場合だけsupport workstream eligibility
  9. execution surface availability

planへpolicy_id、work kind、complexity、decision state、independence、side-effect scope、verification oracle、execution route、理由、owner、model/reasoning、read/write scope、acceptance、worker/main verificationを記録する。subagent taskには、並列化またはcontext隔離の具体的な利益と、mainが受け取る成果物を記録する。

UI / UX contract: requiredの場合は、UI実装taskを1つでも置く前にUI-FとUI-Iをtask graphへ追加し、Status boardのUI列を全taskへ埋める(foundation | surface | integration | -)。UI実装taskのDepends onにUI-Fを、UI-IのDepends onに全UI実装taskを入れる。

4. 実行前レビューを行う

最初のworkerを起動する前に次を確認し、問題があればplanを修正する。

  • 依存関係の循環、未確定contract、write scopeの重複
  • 検証不能なacceptance、未設定のowner/model
  • execution routeが判断状態、独立性、write scope、oracle、副作用と可逆性から決まり、complexityが実行量と検証強度へ反映されていること
  • 未解決判断、結合write、弱いoracle、外部・不可逆副作用、最終統合がworkerへ流れていないこと
  • Cursor taskが必要条件をすべて満たすこと
  • subagent taskが許可用途に該当し、source writeを持たないこと

UI / UX contract: requiredのplanでは追加で次を確認する。

  • UI-FとUI-Iがtask graphに存在し、依存関係が正しく張られていること
  • UI-Fの成果物(component mapping、token allowlist、共通surface owner、label方針、i18n方針、layout/theme/density、static scan command)が抽象語でなく具体値でplanに書かれていること
  • 全UI実装taskのForbiddenとWorker verificationに、ui-contract.mdの固定blockがliteralで入っていること
  • 共通surfaceを複数taskが独立に実装する構成になっていないこと
  • static scan commandが実際に走ること(1回はmainが手元で実行して確認する)

5. task単位で実行する

dependenciesを満たしたtaskだけを実行する。Cursor promptとsubagent promptはdelegation-prompt-template.mdに従う。Cursor CLIはoperations.mdで実行する。

Codex subagentを起動する場合は、planに記録したmodelとreasoning effortを起動引数へ設定する。subagentにはtask-localなsourceと契約だけを渡し、mainの結論を先に教えない。

6. 検収・統合する

review-checklist.mdでdiff、検証結果、worker reportを照合する。mainだけがplanのstatus、decision log、統合結果を更新できる。subagentの報告は根拠であり、設計判断や完了判定そのものではない。

7. 完了を判定する

required taskの完了または理由付きdeferred、integration batchのacceptance、最終検証がすべてそろったときだけ完了とする。残存課題はriskまたはdeferred taskとして記録する。

UI / UX contract: requiredのplanでは、UI-Iの合格が完了の必要条件になる。UI-Iが不合格の項目を1つでも持つ間は、他taskが全てdoneでもplanを完了としない。UI-Iをblockedのまま残し、完了判定を出さない。検出済みのUI違反を後追い修正taskへ移してplanをdoneにすることを禁止する。

共通禁止事項

  • workerにplan更新、完了判定、version control/remote操作を任せない。
  • write scopeが重なるworkerを並列実行しない。
  • worker reportだけで採否を決めず、既存の未コミット変更を戻さない。
  • Cursor CLI preflightを通常taskにしない。CLI-level errorが起きた場合だけ実行する。
  • Codex subagentにsource writeを与えない。Mode: editのsubagent taskを作らない。実装が必要ならmainかCursorへ回す。
  • UI-F未完了のままUI実装taskを起動しない。
  • UI-FとUI-IをCursorまたはsubagentへ委任しない。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Rebuild a degraded AI image to remove crunchy textures and repeated-edit artifacts while preserving identity, style, and composition. Use for clean remakes, not ordinary retouching or upscaling.

日本語の概要は準備中です。原文の説明を表示しています。

ryryo/dot-claude-dev32026年10月10日 更新

analyze-seminar-video

無料日本語概要

セミナー・講義・ウェビナー・研修・実演動画をローカルで文字起こしし、内容を分析して、必要なスライド画像や動画クリップ付きのHTML/Markdown資料を作る。動画から学習資料・実践ガイドを作りたい場合に使う。映像作品の再現設計やCanvas生成は対象外。

ryryo/dot-claude-dev32026年10月10日 更新

architecture-refactor-loop

無料日本語概要

責務・依存方向・状態や副作用の境界を監査し、既存挙動を保って段階的にリファクタリングする。read-only監査にも対応する。

ryryo/dot-claude-dev32026年10月10日 更新

astra-rules-refactor

無料日本語概要

AGENTS.mdや既存スキルをGPT-6 Astra向けに監査・整理するときに使う。契約と意図的な他モデル委譲を保ち、重複、過剰な手順、曖昧な停止条件を修正する。

ryryo/dot-claude-dev32026年10月10日 更新

character-sheet-imagegen

無料日本語概要

人物の参照写真から、同一性を保った複数アングルのキャラクターシートを生成・修正する。指定された身だしなみや撮影表現も整える。

ryryo/dot-claude-dev32026年10月10日 更新

character-to-codex-pet

無料日本語概要

既存キャラクター画像を、承認制でピクセルアートの正準画像へ変換し、3状態パイロット、クロマ前処理、状態間ジオメトリ検証、9状態生成、遷移QA、仮配置、アプリ内確認、ロールバック可能な正式配置まで行う。キャラクターからCodexペットを作る依頼に加え、ジャンプで小さくなる、状態ごとに身長が変わる、足元が跳ねる、クロマ縁が出る、アニメーションを修復したい依頼で使用する。

ryryo/dot-claude-dev32026年10月10日 更新

ryryo のスキルをすべて見る

このスキルの問題を報告する