datocms-feedback

DatoCMS フィードバック

DatoCMS のスキル／MCP ワークフローが行き詰まった場合に使う、事前入力済みの datocms.com/support URL です。問題を解決するためのワークフローではなく、切り替え先として使います。

表示を伴う操作を始める前に

• ユーザーが DatoCMS のスキル／MCP に関するフィードバックの報告、送信、要約を明示的に依頼した場合 → すぐに出力フローを開始します。
• 不満や行き詰まりが推測される場合 → 生成しません。一度だけ提案し、確認を待ちます。
• 信頼できる再試行の方法がある場合 → フィードバックには言及せず、進行中の DatoCMS ワークフローを続けます。

試行錯誤には使用しません。単一のコマンドの失敗、MCP 呼び出し、API エラー、検証結果、スキーマの不一致、環境変数の不足、セットアップの失敗は、再試行の方法がある限り、進行中のワークフロー内で対応します。

プロジェクト／スキーマ／フロントエンド／移行／プラグインの問題がまだ解決可能な場合 → 該当する DatoCMS スキルに誘導します。

不満が推測される場合

一度だけ提案し、その後は待ちます。

It looks like this may have gone past the normal retry-and-correct loop. Sorry about that. These workflows are still evolving, and clear feedback helps us understand where the experience broke down. If you want, I can build a prefilled DatoCMS support link with the goal, where the skills/MCP flow got stuck, and relevant runtime context.

ユーザーが同意した場合は、出力フローに従います。

URL の形式

ベース URL：https://www.datocms.com/support。クエリパラメーターは encodeURIComponent で URL エンコードし、その後 '→%27、(→%28、)→%29 に変換します。生の ' があると、シングルクォートで囲んだシェル URL が壊れます。

• topics=technical-support/ai-integration-issues — スキル／MCP のフィードバック用の固定スラッグ（/ は %2F に URL エンコードします）。必須です。これがないとフォームは表示されません。
• subject=<短い件名> — 1 行。
• body=<サニタイズ済みメッセージ> — 本文のルールを参照してください。

#form アンカーを追加します。ページを読み込むとフォームまでスクロールします。

本文のルール

• ユーザーの視点で書きます。
• 以下を含めます：試みた目的、スキル／MCP のどちらが関与したか（または両方か）、確認できるランタイムの状況、確認できる推論レベル、失敗した内容、期待する結果。
• 不足している詳細が重要でない場合は、not visible from this conversation を使用します。
• レポートの理解に必要な詳細が不足している場合に限り、生成前に短い質問を最大 1 つします。
• 生の詳細は短くします。コマンド名、呼び出し名、安全な短いエラー抜粋は、役立つ場合に限り含めます。
• シークレット、トークン、認証ヘッダー、非公開の内容、ユーザーを特定できる詳細、リクエスト／レスポンスの全ペイロード、生のトランスクリプトのダンプ、長いローカルパスは含めません。
• 本文内で DatoCMS に代わって謝罪しません。
• プレーンテキストの本文は約 4000 文字未満にします。エンコード後の URL はエッジの上限（Vercel で約 14 KB）以内に収める必要があります。長くなる場合は短くしてください。
• Hi DatoCMS support,／Thanks, のような挨拶は入れません。このフォームはメールではありません。

本文の形式

会話の状況に応じて短くしない限り、次の形式を使います。

I ran into a frustrating issue while trying to use the DatoCMS skills/MCP workflow.

Goal: [goal].
Workflow involved: [skills/MCP/both/not visible from this conversation].

What happened: [short sanitized summary of the loop, wrong routing, repeated misunderstanding, or dead end].

Context:
- Runtime/client: [visible value or not visible from this conversation]
- Runtime identifier: [visible value or not visible from this conversation]
- Reasoning level: [visible value or not visible from this conversation]
- Safe error excerpt: [short excerpt or not included]

Expected: [expected outcome]. Could not get there because: [impact].

Sharing so you can see where the skills/MCP experience broke down.

出力フロー

2 つのステップで進めます。ステップ 1 では URL を作成したり、表示したりしないでください。

ステップ 1 — 本文の下書きを表示する。 確認用に、サニタイズ済みの本文テキスト（テキストエリアに入力される内容）を出力します。末尾に次の文を付けます：「事前入力済みのサポートページをブラウザーで開きますか？」

ステップ 2 — リンクを開く。 ユーザーの確認後に URL を作成し、開きます。

• macOS：open '<url>'
• Linux：xdg-open '<url>'
• Windows：start '' '<url>'

シェルが & と # を別の意味に解釈しないよう、URL をシングルクォートで囲みます。クリックできる代替手段として、URL を単独の行に表示します。

「下書きを作成しました」のような表現や、要約は入れません。