manual-cloud-task

name	manual-cloud-task
description	tracked handoff packet を使って Codex Cloud task を手動起動するための指示を組み立てる。Use when: Codex Cloud で exec 相当の作業を手動で進めたい時（PlanGate ではローカル実行が原則・本 skill は optional）。

Manual Cloud Task (PlanGate / optional)

PlanGate での位置付け: PlanGate は Claude Code / Codex CLI どちらもローカル実行が原則。Codex Cloud を使う場合のみ本 skill を使う（optional）。ローカル exec 再開には local-exec-handoff skill を参照。

Read First

参照解決順（導入先で必ずこの順に探す）

本 skill の参照は上流リポジトリ基準の相対パスで書かれている。導入先ではそのままでは 解決できないものがあるため、次の順で探索する:

1. 導入先リポジトリの相対パス（例: .claude/rules/working-context.md）。 ただし 本 skill が参照する節（例: working-context.md の「ゲート条件」節）が実在することを確認する。同名でも別内容なら PlanGate の正本ではないため 2 へ進む
2. 無ければ plugin root 配下（例: <plugin_root>/rules/working-context.md）。 <plugin_root> は Bash で ls "${CLAUDE_PLUGIN_ROOT}/rules/" を実行して展開・確認した 絶対パス（Read ツールは絶対パスを要求し環境変数を展開しないため、${CLAUDE_PLUGIN_ROOT}/... という文字列をそのまま Read しない）。変数が空・未設定ならキャッシュを glob で推測せず 3 へ進む
3. どちらにも無い場合は 「正本 <path> を参照できなかった」と明示し、推測で内容を補わない

plugin root 配下の探索は docs/** には適用しない（手順 2 は rules/*.md 等の 配布対象にのみ適用する）: plugin が配布するのは agents / commands / skills / rules 等の 定義ディレクトリのみで docs/ を配布対象として認識せず、plugin root 配下に相当する配布物が 存在しないため必ず空振りする。docs/** は手順 1 で解決できなければ手順 2 を飛ばして手順 3 へ進む。

導入経路ごとに配置されるものが違う:

参照	install.sh --claude 経由	plugin（Claude marketplace）経由	Codex 経由
rules/*.md	.claude/rules/ に着地（解決可）	<plugin_root>/rules/ で解決	未配置（解決不可 → 手順 3 へ）
.codex/** / docs/**	コピー対象外（解決不可）	バンドル対象外（解決不可）	未配置（解決不可）
scripts/** / bin/**	コピー対象外	目的の CLI は不在	未配置

install.sh --claude のコピー対象は agents / skills / commands / rules の 4 ディレクトリ のみ。Codex 経由（install_codex()）は install-plangate-skills.sh を呼ぶだけで skills しか 配置されないため、rules 参照は解決順 1・2 とも成立せず必ず手順 3 に落ちる。

読む順序

1. CLAUDE.md
2. AGENTS.md
3. .claude/rules/working-context.md → fallback <plugin_root>/rules/working-context.md （C-3 / handoff 要件）
   • どちらでも解決できない場合は、下記「Rules」節の C-3 未承認時の停止条件 （approvals/c3.json APPROVED 必須）を代替正本とし、Cloud task 指示に 「正本 working-context.md を参照できなかった」旨を記録する
4. .codex/manual-cloud-task.md（配布対象外。上流リポジトリで作業する場合のみ解決する。 導入先では下記「Deliverable」の転記先を導入先の任意パスに読み替える）

Rules

• Cloud task は人間が手動起動する（AI が自動起動しない）
• GitHub コメント経由で exec を起動しない
• C-3 未承認なら停止する（approvals/c3.json APPROVED 必須）
• Cloud task は tracked handoff packet を唯一の作業指示として扱う
• docs/working/ の ticket ファイルはローカル側の作業材料であり、Cloud task から直接読める前提にしない

Deliverable

Cloud task にそのまま貼れる短い実行指示を作成。承認済み内容は .codex/manual-cloud-task.md に転記する。

CLI 呼び出し

下記は 上流リポジトリ（s977043/plangate）を clone し、そのリポジトリルートで 実行する場合にのみ成立する。上の表のとおり scripts/** / bin/** は 3 経路とも 導入先に配布されないため、plugin 経由・Codex 経由の環境では実行できない。

• packet 作成: ./scripts/ai-dev-workflow TASK-XXXX prepare-cloud
• Cloud task 実行後の同期: ./scripts/ai-dev-workflow TASK-XXXX sync-cloud
• どちらも --dry-run を付けると前提条件の充足状況だけを表示して終了する

CLI 不在時のフォールバック（導入先では既定）

CLI が無い環境では packet を手で作る。両コマンドの処理内容は固定なので、CLI 無しでも 同じ成果物に到達できる。ゲートと停止条件は CLI の有無に関わらず不変。

1. prepare-cloud 相当を手で行う — plan.md / todo.md / test-cases.md / status.md が揃っていることを確認したうえで、「Deliverable」の転記先に次の節を作り、 plan / todo / test-cases / status（あれば review-self / review-external）の内容を 転記する: Task（Task ID / branch 名 / C-3 承認状態 / 最終完了の owner = human）/ Approved Scope / Constraints / Approved Plan / Todo / Test Cases / Status Notes / Self Review・External Review（存在する場合のみ）/ Open Questions・Non-Goals / Verification Policy / Approval Request Note / Startup Template
2. C-3 チェックを省略しない — CLI は status.md に ## C-3 Gate: APPROVED の行が あるかを完全一致で検査し、無ければ packet を生成せず停止する。CLI が無いと この自動停止も失われるため、同じ確認を人手で実行してから packet を作る。 未承認なら「Rules」のとおり停止する（CLI の不在は C-3 免除の理由にならない）
3. sync-cloud 相当を手で行う — packet の Task ID が対象 TASK と一致することを 確認したうえで、packet に残った changed files / verification results / concerns / approval request note を status.md へ反映し、packet に証拠があるものだけ todo.md を完了扱いにする。plan.md と実装コードはこの同期では変更しない。 Cloud task の完了は 仮完了（人間承認待ち） である旨を status.md に残す
4. 転記先は導入先のパスに読み替える — .codex/manual-cloud-task.md は配布対象外 （「読む順序」4 の注記どおり）。導入先では任意のパスに読み替え、Cloud task には そのファイルの内容を貼る
5. CLI 実行そのものが必要なら、上流リポジトリ（s977043/plangate）を clone して そこから実行する

ローカル実行に切り替えるとき

Codex Cloud を使わずローカル Codex CLI で exec する場合は本 skill ではなく local-exec-handoff + ai-dev-exec を使う。