vibescool-deploy

name	vibescool-deploy
description	VibesCool Platform にアプリを deploy または resume するときに使う配布スキル。private / public deploy、credit 消費の説明、ログイン確認、設定修復、deploy 後の表示確認、URL共有、QRコード生成が必要なときに使う。

When to use

• VibesCool Platform にアプリを deploy するとき。
• VibesCool Platform にアプリを resume するとき。
• private / public のどちらで出すかを守りつつ、deploy 後の確認まで進めるとき。
• deploy 後に URL 共有や QR コード生成まで求められているとき。

Source of truth

• 正本は今の依頼、現在の作業ディレクトリ、wrangler.jsonc などの deploy 設定、vibescool CLI の返り値。
• この配布スキルは deploy / resume と deploy 後確認だけを担当する。実装そのものは担当しない。

Load references when needed

• wrangler.jsonc を自分で作る、deploy 設定エラーを直す、静的 assets の置き方を調整する、など config 修復が必要な場合だけ references/deploy.md を読む。
• 画面表示の確認が必要な場合は、deploy 後の確認前に references/browser.md を読む。
• URL を QR コードにしたい依頼がある場合は、最終回答前に references/qr.md を読む。

Hard rules

• 今の依頼で deploy や公開の前に明示確認が必要な場合は、その確認だけを行って待つ。
• private / public の指定が依頼や設定から一意に決まらない場合は、deploy 前に確認する。
• URL 共有、QR コード生成、表示確認など、依頼された deliverable がそろう前に最終回答しない。
• deploy 後の表示確認が必要な場合は、URL を実際にブラウザで開く。curl、HEAD リクエストだけへ置き換えない。
• ブラウザで確認できない場合は、その時点で止まり、不足を短く伝える。
• wrangler.jsonc、build 済み entry、静的 assets、compatibility_date などの不備で deploy が失敗した場合は、自分で直せる範囲を修復してから再試行する。
• vibescool deploy または vibescool resume が失敗したときは、まず自分で直せる範囲を 1 回だけ修復して再試行する。再試行しても失敗した場合のみ、今の詰まりを VibesCool へ送る確認を出してよい。
• feedback 送信確認は次の利点を短く含める: この詰まりを送ると、VibesCool 側で platform や説明を優先して直しやすくなり、同じ詰まりを減らしやすくなる。
• feedback 送信確認の推奨文面は次の 1 文とする: この詰まりを VibesCool に送ると、platform や説明を優先して直しやすくなり、同じ詰まりを減らしやすいです。今のエラー要約を送ってもよいですか？
• feedback は明示的に OK が出たときだけ送る。断られても作業は続ける。
• feedback を送るときは vibescool feedback --stdin --output json を使い、category は bug_report または docs_gap を選ぶ。summary は deploy failed: <短い要約>、details には実行 command、失敗要約、直そうとして行った修復、再試行後も失敗したことを入れる。
• feedback には token、secret、不要な絶対パス、全文ログを入れない。
• 新しい App を最初に deploy するときは、人間向けの App 名を決めて vibescool deploy --name <App名> を優先する。名前が曖昧なら deploy 前に確認する。
• 既存 App の名前が handle のままで分かりづらい場合は、必要に応じて vibescool deploy --name <App名> で更新してから続ける。
• 最終回答では URL をバッククォートで囲まない。URL を含むインラインコードやコードブロックも使わない。
• QR コードを提示する場合は、最終回答で Markdown 画像埋め込みを使う。terminal 向け表示が役立つ場合は、画像に加えて terminal QR を併記してよい。

Workflow

1. 今の依頼とローカル設定を読み、deploy / resume が必要か、private / public のどちらを守るべきかを確認する。
2. 必要な references/*.md だけを読む。
3. 明示確認が必要な場合は、その確認だけを行って待つ。
4. 最初の vibescool deploy または vibescool resume の前に、credit 消費ルールを短く説明し、ログイン状態を確認する。
5. 必要なら vibescool docs billing を開き、credit 説明の正本を確認してから案内する。
6. deploy 対象の人間向け App 名を決める。今の依頼やプロジェクト名から自然に決まるならそれを使い、曖昧なら deploy 前に確認する。
7. deploy 前に wrangler.jsonc、entry、assets を確認し、足りなければ自分で補う。config 修復の詳細が必要な場合だけ references/deploy.md を読む。
8. 新規 App は vibescool deploy --name <App名> を含めて実行する。既存 App でも名前更新が必要なら同様に --name を付ける。resume には --name を付けない。
9. deploy / resume が失敗した場合は、自分で直せる範囲を 1 回だけ修復して再試行する。再試行しても失敗した場合のみ、利点を短く添えて feedback 送信確認を出す。OK が出たら vibescool feedback --stdin --output json で送る。
10. --auto-pause-after は必要最小限にする。迷ったら 3d を使う。
11. 表示確認が必要な場合は、deploy 後に URL を実際にブラウザで開き、主要な 1 操作まで確認する。
12. QR コード提示が必要なら、ローカルで生成し、絶対パスの PNG が実在することまで確認する。terminal 向け表示も求められている、または CLI 上で見せる価値が高い場合は --terminal も付けてよい。
13. 依頼された deliverable をそろえて最終回答する。

Completion criteria

• 必要な明示確認が済んでいる。
• credit 説明とログイン確認が済んでいる。
• deploy または resume が成功している。
• 表示確認が必要な場合は、deploy 後の URL をブラウザで実表示確認している。
• URL 共有、QR コード、その他の依頼された deliverable がそろっている。