公式スキル · カスタマーサクセス

サポートチケットからバグ報告を書く

顧客の不満を、再現手順、期待する動作と実際の動作、環境、影響、証拠、顧客への質問がそろった、開発がすぐ着手できるバグ報告にする。

Claude・ChatGPT・コーディング用の AI で使えます。TeamとBusiness では、Pod に入れた公式スキルが改善のたびに自動で最新版になります。

使う場面

AI に渡すもの

できあがるもの

Jira、Linear、GitHub にそのまま貼れるバグ報告と、顧客への質問。

手順

  1. 何が、どこで失敗するかがわかる件名を書く 型は「[どこで・いつ] [操作] が [どう失敗する]」。例:「レポートの CSV エクスポートで1,000行を超える行が落ちる」。「エクスポートが壊れている」や、顧客の言葉そのままの「至急!!バグ」にはしない。
  2. 再現手順を、番号つきの単一の操作で書く わかっている状態から始める(「Team プランの管理者としてログインした状態」)。1手順に1クリックか1入力。画面の表記はそのまま太字で書く。顧客の手順があいまいなら、書ける分だけ書き、不確かな手順に「[未確認]」と付ける。
  3. 期待する動作と実際の動作を書く 期待: ドキュメントやこれまでの動作から、製品がすべきこと。実際: 起きたことを、目に見える形で(メッセージの文面、表示されたもの、表示されなかったもの)。エラーメッセージは一字一句そのまま引用する。
  4. 環境と頻度を記録する ブラウザー、アプリのバージョン、OS、プラン、アカウント ID、発生日時とタイムゾーン。頻度: 毎回、ときどき(y回中x回)、1回だけ。
  5. 影響の大きさを見積もる 報告している顧客数やチケット数、回避策の有無、お金・データ・セキュリティに関わるか。重大度(S1〜S4)を提案し、理由を1行で書く。
  6. 証拠を添える スクリーンショット、録画、ログ、チケット ID を並べる。顧客の個人情報は報告に書かず、チケット ID で参照する。
  7. 顧客に聞くことを並べる 足りない事実を、サポート担当がそのまま貼れる質問にする(「お使いのブラウザーとバージョンを教えていただけますか」)。質問は4つまで、大事な順に。

チームで使う

AI Skill Pod に追加すると、業務委託の方も含めてチーム全員が、自分の AI から同じ版を使えます。 AI スキルをチームで共有する方法を読む

チームのPodに追加

変更履歴

出典

出典は英語のページです。

  1. Bug Writing Guidelines (2026-11-04に確認)
  2. Bug Report Guidelines | WebKit (2026-11-04に確認)
  3. Configuring issue templates for your repository (2026-11-04に確認)