Plan Preview

plan-preview

役割

Plan Mode で正式な <proposed_plan> を提示する直前に、同じ計画内容を一時HTML previewとして出す。

このskillは利用者が手でコマンドを打つためのものではない。agentが計画本文を組み立てた段階で plan-preview CLIを呼び、返却JSONの url を <proposed_plan> 内へ自然に入れる。

Plan Mode 中の計画確認プレビューは、このskillが優先入口になる。通常の最終HTML成果物を作る visual-html-renderer の document-model.json → render → validate → preview フローへ流さない。

Role

Create a temporary visual preview for a Plan Mode proposal. The user should not run the CLI manually. The agent calls plan-preview, receives a session-scoped URL, and places that URL naturally inside the <proposed_plan> text. During Plan Mode, plan preview requests should route here instead of the final-artifact visual-html-renderer document-model flow.

Strict procedure profile

• Strictness: strict-procedure。Plan Mode の正式な実装基準は <proposed_plan> 本文であり、previewは判断補助として扱う。
• Hard gates: 外部サービス送信、shared state変更、永続ファイル出力、skill実行時にhookを動的に追加しない（plugin同梱の静的hook定義は対象外）。
• Forcing function: plan-preview CLI、TTL付き一時ディレクトリ、Plan preview: <url> 行、失敗時の明示。
• Completion receipt: <proposed_plan> 内に preview URL または Plan preview: unavailable (<reason>) を含める。

言語方針 / Language behavior

Follow the language of the latest user request for progress updates, preview labels, and the surrounding plan text. 日本語の計画依頼には日本語で、英語の計画依頼には英語で返す。Plan preview: <url> の固定ラベルは互換性のため英語のまま使ってよい。

発火条件

次のいずれかに当たる場合、このskillを使う。

• ユーザーが plan のグラフィカル表示、図示、preview URL、graphical plan review を求めている。
• ユーザーが Plan Mode 中に「この計画をHTMLでプレビューして」「計画をHTMLで確認したい」のように求めている。
• ユーザーが preview this plan as HTML, show this plan visually, graphical plan preview, add a plan preview URL, preview the proposed plan のように求めている。
• 計画に phase、依存関係、並列worker、検証層、リスク・前提の分岐があり、文字だけでは確認しづらい。
• plugin利用者の体験として、Plan Mode の本文に自然にURLが入っていることが求められている。

Trigger Conditions

Use this skill when the user asks for a graphical plan view, diagrammed plan, preview URL, preview this plan as HTML, show this plan visually, graphical plan preview, add a plan preview URL, or preview the proposed plan. During Plan Mode, use this skill for plan preview requests instead of visual-html-renderer. Also use it when the plan has phases, dependencies, parallel workers, verification layers, or risk branches that are hard to inspect as plain text.

使用しない場面

• 最終成果物としてHTMLを生成する場合。これは visual-html-renderer を使う。
• レビュー可能な設計資料を作り、HTML上のコメントを取り込む場合。これは reviewable-design-doc を使う。
• planとは無関係な説明資料、恒久公開資料、Notion投稿、外部アップロードが必要な図式化。

Do Not Use For

Do not use this skill for final HTML artifacts, reviewable design documents, comment ingestion, unrelated explainers, permanent publications, Notion posts, or diagrams that require external uploads.

入力payload

agentは <proposed_plan> に入れる直前の計画全文を source_text にそのまま入れる。要約・並べ替え・削除・言い換えは禁止。 受理されるトップレベル key は title / source_text / diagrams だけ。source_text は必須。 diagrams は図が理解を助ける章だけに絞り、各図の after_heading は原文見出しのプレーンテキストと完全一致させる。

{
  "title": "Plan Preview",
  "source_text": "<proposed_plan> に出す計画本文 markdown 全文をそのまま",
  "diagrams": [
    {
      "after_heading": "実装手順",
      "title": "処理フロー",
      "mermaid": "flowchart TD\n  plan --> implementation"
    }
  ]
}

外部画像URL、外部asset、機密情報、未確定のsecret値はpayloadに入れない。

Input Payload

Put the full markdown plan text that will appear in <proposed_plan> into source_text exactly as-is. Do not summarize, reorder, delete, or rephrase it for preview generation. The accepted top-level keys are only title, source_text, and diagrams; source_text is required. Use diagrams only for sections where a diagram helps comprehension, and make each after_heading exactly match the plain-text heading in the source plan. Do not include external image URLs, external assets, secrets, or unconfirmed secret values.