SEZEE ヘルプ

GUIDE

AIに共有機能 完全ガイド

修正指示を Claude Code / PROPEL などの AI コーディングツールにそのまま渡して実装させる SEZEE の「AI に共有」機能の使い方・共有 URL/JSON 仕様・トラブルシュート・FAQ を網羅します。

💡 「AIに共有」は PRO / STUDIOプラン限定の機能です（FREE ではボタンが表示されません）。

こんなときに使います

  • SEZEE でまとめた修正指示を、Claude Code や社内 AI エージェントに実装させたい
  • 指示内容を手作業でチャットにコピペする手間を省きたい
  • 手書きの図（Excalidraw）で描いた「ここを揃えて」といった視覚指示も AI に読ませたい
  • 複数バージョン（オリジナル → 修正版 v1, v2…）を並べて履歴として AI に渡したい

事前準備

  • プラン: PRO / STUDIO のいずれか
  • AI ツール: WebFetch / URL 読み取りができる LLM ツール（Claude Code、Anthropic Console、PROPEL、自作エージェント等）
  • 画面の公開設定: 対象画面を「公開」状態にしておく（共有 URL 経由での取得が発生するため）

使い方（4 ステップ）

ステップ 1：「AI に共有」を開く

編集画面の上部ツールバー右側にある「AI に共有」ボタンをクリックすると、「AI に修正データを共有」ダイアログが開きます。

ステップ 2：共有対象を確認・調整する

ダイアログ内には未解決コメントの一覧が表示されます。

  • 選択されたコメントだけが AI 共有 JSON に含まれます（ai_target=true）。
  • コメントごとの ✓ / ✕ で 個別に除外 できます（例: OCR 誤検出、社内用メモコメント等）
  • 「すべて選択 / すべて解除」の一括操作も可能。

ステップ 3：共有用テキストをコピー

「共有用テキスト」欄にはあらかじめプロンプトのテンプレートが入っています。「コピー」ボタンでクリップボードにコピーしてください。

テキストには以下が含まれます：

  • 対象 SEZEE 画面の共有 URL（JSON 取得用パラメータ付き）
  • AI 向けの指示文（Claude Code に「まずこの JSON を取得してください」と促す文言）
  • アクセスキー（画面がキー保護されている場合、&access_key=xxxx として URL に埋め込まれる）

ステップ 4：AI ツールに貼り付ける

Claude Code などの AI ツールに、コピーしたテキストをそのまま貼り付けて実行します。AI は以下の順序で動作します。

  1. 添付された共有 URL を WebFetch で取得
  2. 返却された JSON を解釈して「対象画面 / 修正指示リスト / 添付画像・図」を把握
  3. 対応するコードを検索・特定して修正案を出す（ or 即修正）
  4. 判断が難しいコメントは「要人間確認」として報告

共有 URL / JSON の仕様

アクセス経路

  • 人間用: 共有 URL（?share=<token>）をブラウザで開くと、SEZEE の公開画面レビューが見られます
  • AI 用（JSON）: 同じ URL に ?format=json を付けると、Claude / エージェントが読める JSON 形式で取得できます

schema_version

現行 2026-08-01（コメント図添付 / attachments フィールドを追加した版）

主要フィールド：

フィールド内容
screen.image_urlオリジナル画面の絶対 URL
latest_revision最新版のショートカット (revision_id / version / image_url / open_comments)
timeline[]オリジナル + 修正版を作成時刻順に並べた履歴（各エントリに image_url + そのバージョンのコメント一覧）
revisions[]全修正版のフラット配列（互換用）
comments[]全コメントのフラット配列（互換用）
instructionsAI 向けの取得手順 / 使い方 / ヒント（usage / fetch / timeline_hint / field_hint / attachments_hint / resolution_hint / steps）
filter共有時のフィルタ状態（status: open / all 等）

コメント個別のフィールド

フィールド説明
contentQuill 由来の HTML 本文
content_textHTML を除去した plain text（grep 用の主情報）
position.x_percent / y_percent画像内でのピン位置（0〜100 の百分率）
crop_image_urlピン中心を 60% クロップ + 番号バッジ焼き込みした画像。視覚指示コメント用
attachments[]画像 + 図の添付一覧（type: image or type: diagram、絶対 URL 付き）
is_resolved手動で解決マークされた場合 true
applied_in_revision_versionコメント作成後の最古 revision の version（対応履歴の推定）

添付（画像 + Excalidraw 図）の扱い

2026-08-01 の仕様アップデートで attachments[] が追加されました。

  • 画像や図の追加方法は ピンで修正指示を出す を参照。
  • コメントには 1 件あたり 最大 10 個 の添付を紐付けできます。
  • type: diagram は SEZEE 上で Excalidraw で描いた図。「テキストで書きづらい視覚的な修正指示」の主情報として AI が読み取ります。
  • attachments_hint が JSON の instructions に含まれ、AI に「これらの画像を必ず WebFetch で取得して視覚指示として解釈するように」促します。

アクセスキー（限定共有 URL）との連携

画面をアクセスキー付きで公開している場合：

  • 共有用テキストの URL には &access_key=xxxxx が自動で付与されます。
  • AI 側でも同じ URL で通ります（share + access_key の 2 点セットで画像アクセスも許可されます）。
  • JSON 内の image_url にもキーが含まれるため、AI が個別に画像を WebFetch する際も再認証不要。

⚠️ 共有用テキストにはキー付き URL がそのまま含まれます。第三者に渡らないよう取り扱いにご注意ください。

トラブルシュート

「AI に共有」ボタンが表示されない

  • FREE プランでは表示されません。PRO / STUDIO にアップグレードしてください。
  • 画面の所有者・Workspace メンバーでない場合も、権限不足で非表示になります。

AI 側で URL 取得に失敗する（403 / HTML が返ってくる）

  • 共有用テキストの最下部に curl -sS "<URL>" 形式の代替コマンドが付いていますので、AI にそちらを試すよう指示してください。
  • Claude Code の場合、instructions.fetch フィールドに「WebFetch を試し、失敗したら curl で取得」と記載されているため、指示に従うだけで通ることが多いです。

AI が画像を読めない

  • 画面が非公開になっていないか確認してください（公開設定は画面右上のトグル）。
  • アクセスキー保護画面の場合、URL に &access_key=xxxxx が正しく含まれているかを確認。
  • Claude Code は WebFetch できるドメインが限られているため、対象環境（tool.sezee.jp）にアクセスできる設定になっていることを確認。

コメントの取りこぼしが多い

  • 「AI 対象」トグルで OFF にしたコメントは JSON から除外されます。共有ダイアログで再選択してください。
  • 「解決」ステータスのコメントは既定で除外されます。全部含めたい場合は URL に &status=all を手動で付けてください（詳細は AI 向け instructions の field_hint を参照）。

JSON の中身が古い

  • 共有 URL は常に取得時点の最新状態を返します。
  • AI がキャッシュしている可能性があります。「もう一度 WebFetch を実行してください」と指示してください。

共有した URL を後から失効させたい

  • 画面を「非公開」に切り替えれば、既存の共有 URL は 403 / 401 になります。
  • アクセスキーを付け直すと、以前配布した URL は無効化されます（新しいキー付き URL を再配布してください）。

FAQ

Q. どの AI ツールで使えますか？ A. WebFetch できる LLM ツールなら基本的にすべて使えます。動作確認済みは Claude Code / Claude.ai / PROPEL / Anthropic Console。

Q. 何回まで AI に共有できますか？ A. 回数制限はありません。JSON 取得は共有 URL 経由で何度でも可能。

Q. AI 側で修正が完了したことを SEZEE に通知するには？ A. 現状は AI 側から SEZEE へ「解決」ステータスを更新する API 経路はありません（読み取り専用）。修正が完了したら、SEZEE 上で該当コメントを手動で「解決」にしてください。

Q. コメントに添付した画像を AI が本当に読めているか確認したい A. Claude Code の場合、返却に「添付画像を確認しました: …」といった要約が含まれます。含まれない場合は「添付を再度 WebFetch してください」と再指示してください。

Q. 添付図（diagram）は他のツール（Figma 等）でも見えますか？ A. attachments[].image_url の PNG を開けば見えます。ただし SEZEE 上で Excalidraw に読み込んで再編集できるのは、SEZEE の管理画面から開いた場合のみです。

Q. Workspace 共有画面の修正指示は誰でも AI に共有できますか？ A. Workspace メンバーであれば全員が「AI に共有」ボタンを使えます。ただしプランは画面所有者のプランで判定されます。

Q. schema_version が変わったら過去のプロンプトが動かなくなりますか？ A. 追加は互換を保つ方向で行っており、既存フィールドの削除は原則しません。安心して同じテンプレートを使い回せます。

サポート

info@buffs.jp までご連絡ください。以下があるとスムーズです：

  • 対象画面 ID / 共有 URL（管理者確認用）
  • AI ツール名・バージョン
  • 返却された JSON / エラーメッセージ

関連ガイド

最終更新: 2026年8月3日

← 機能について の一覧へ戻る