canva-implement-feedback

フィードバックを反映して完成へ

スライド一式をレビューに出すと、関係者から各スライドに散らばったコメントが寄せられます。このスキルはすべてのスレッドを読み、レビュアーが実際に求めていることを要約し、明確な変更はそのまま適用して、曖昧な点は人による判断が必要なものとして報告します。

Canva Editing API — できることとできないこと

フィードバックを振り分ける前に、これらの制約を必ず把握してください。API では不可能な変更について、ユーザーと無駄なやり取りをするのを避けられます。

API でできること（perform-editing-operations を使用）

• テキストコンテンツ：テキスト要素全体の置換（replace_text）、文字列の検索と置換（find_and_replace_text）
• テキストの書式設定：フォントサイズ、フォントの太さ（太字）、フォントスタイル（斜体）、文字色、テキストの配置、行の高さ、テキストの装飾（下線）、取り消し線、リンク、リストの書式設定
• メディア：画像／動画の置換（update_fill）、画像／動画の挿入（insert_fill）、要素の削除（delete_element）
• レイアウト：要素の位置変更（position_element）、サイズ変更（resize_element）
• メタデータ：デザインタイトルの更新（update_title）

API でできないこと

• フォントファミリー／書体の変更 — サイズ、太さ、スタイルのみ対応しています
• テキスト要素の追加 — 新しいテキストボックスは追加できず、メディア（画像／動画）のみ挿入できます
• 背景色やグラデーションの変更
• ページ／スライドの追加、削除、並べ替え
• アニメーションやトランジションの変更
• 要素の不透明度の変更（新しく挿入した塗りつぶしを除く）
• 要素のグループ化／グループ解除
• 図形の変更（色、枠線など）— 図形内のテキストのみ編集できます

振り分けのルール

コメントが「できないこと」の一覧にある変更を求めている場合は、手動での対応が必要に分類してください。制約について詳しく述べず、要約に簡潔に記載して次へ進みます。これはよくあることで、デザインレビューの多くには API で対応できる変更と手動で対応する変更が混在しています。手動での変更内容は、最後の手動変更チェックリスト（ステップ 7）に記載してください。

ワークフロー

ステップ 1：デザインを特定する

• ユーザーが短縮リンク（canva.link）を提示した場合は、Canva:resolve-shortlink を呼び出してデザイン URL を取得します
• ユーザーが通常の Canva URL を提示した場合は、URL からデザイン ID を抽出します
• ユーザーがデザイン IDを直接提示した場合（通常は D で始まります。例：DABcd1234ef）は、design_id として使用します。生の ID に対して Canva:search-designs を使用しないでください
• それ以外の場合は、デザイン ID またはリンクを尋ねます

ステップ 2：すべてのフィードバックを読む

• Canva:list-comments をデザイン ID とともに呼び出し、すべてのコメントスレッドを取得します
• 返信があるスレッドごとに Canva:list-replies を呼び出し、会話全体を取得します
• Canva:get-design-content を呼び出し、すべてのページにある現在のテキストを読み取ります

ステップ 3：フィードバックを振り分ける

各コメントスレッドを次のいずれかのカテゴリーに分類します。

• 対応可能 — API がサポートしており、妥当な解釈ができる変更です。最善の判断をしてください。たとえば「タイトルをもっと印象的にして」というコメントなら、曖昧として報告するのではなく、印象的な表現に書き換えます。「間隔を調整して」というコメントなら、デザインの内容を確認し、妥当な調整を行います。レビュアーの意図を本当に判断できない場合（たとえば、2 人のレビュアーが直接矛盾する意見を述べている場合や、デザイン内に見つからない要素に言及している場合）に限り、ユーザーに確認します。
• 手動での対応が必要 — レビュアーが API では対応できない変更（フォントファミリーの変更、新しいテキスト要素の追加、背景の変更、ページの並べ替えなど）を求めています。要約には簡潔に記載し、詳細は手動変更チェックリスト（ステップ 7）に記載します。
• 対応済み — すでに対応済み、明確に完了と記されている、または肯定的な評価（例：「LGTM」「良さそうです」）です

ユーザーには、カテゴリー別に整理した要約を提示します。変更予定の内容、確認が必要な内容、手動での対応が必要な内容、対応を見送る内容をまとめます。

ステップ 4：ユーザーの承認を得る — 1 回のみ

• 変更計画を提示し、ユーザーの承認を待ちます
• ユーザーが調整を希望した場合は、計画を更新してもう一度だけ確認します

ワークフロー全体で確認を行うのはここだけです。ユーザーが承認したら、作業を進めてください。

ステップ 5：変更を適用してコミットする

ユーザーに再度尋ねてはいけません。 すでに承認済みです。次のすべてをただちに順番に実行します。

• Canva:start-editing-transaction を呼び出して編集セッションを開始します
• Canva:perform-editing-operations を呼び出して、承認された変更を適用します（可能な場合は、すべての操作を 1 回の呼び出しにまとめます）
• Canva:commit-editing-transaction を呼び出して保存します。「コミットしてよいですか？」や「保存する準備はできていますか？」と尋ねてはいけません
• 編集の応答からサムネイルをユーザーに表示し、完了を知らせます

ステップ 7：残りの手動変更を提示する

コミット後（または API で対応できる変更がなかった場合）は、Canva エディターで手動で行う必要がある作業を、すべて明確なチェックリストとして提示します。

## Changes to make manually in Canva

1. **Slide 3 — Change heading font to Montserrat**
   Reviewer: @Sarah | Why: API cannot change font family
   → Open slide 3, select the heading, change font to Montserrat

2. **Slide 7 — Add a new text box for the disclaimer**
   Reviewer: @James | Why: API cannot add new text elements
   → Add a text box below the chart with: "Source: Q3 2025 internal data"

3. ...

ユーザーがすばやく作業できるよう、各項目にスライド番号、変更内容、依頼者、手順を含めます。

ステップ 8：コメントスレッドを解決する

• コミット後、対応が必要な各スレッドで Canva:reply-to-comment を呼び出し、変更内容を伝えます
• 「手動対応が必要」なスレッドには、代替として行った対応と、引き続き手動で対応する必要がある内容を記載して返信します
• これによりフィードバックのやり取りを完了し、レビュー担当者がコメントへの対応を確認できるようにします

ルール

• 慎重になりすぎず、役立つ対応をしてください。フィードバックは柔軟に解釈し、「曖昧」として諦めるのではなく、最善の変更を試みてください。ユーザーは承認の段階でいつでも変更を拒否できます
• ユーザーに確認を求めるのは、意図を本当に判断できない場合に限ります。たとえば、2 人のレビュー担当者が直接矛盾する意見を述べている場合や、コメントがデザイン内で見つからない要素に言及している場合です
• レビュー担当者の意見が異なる場合は、両方の意見を提示してユーザーに判断を委ねます
• 変更計画の概要を提示して、承認を 1 回だけ待ちます。その後は追加の確認をせず、すべてを実行します
• 「コミットしてよいですか？」「保存する準備はできていますか？」など、これに類する質問を絶対にしてはいけません。最初の承認で、編集からコミットまでの全工程が承認されています
• 手動での変更は通常想定されるものです。API の制限について過度に説明したり謝罪したりせず、チェックリストに含めてください
• 操作をまとめます。変更ごとに 1 回ずつ呼び出すのではなく、複数の操作を含む単一の perform-editing-operations 呼び出しを使用してください