公式スキル · カスタマーサクセス
サポートチケットからバグ報告を書く
顧客の不満を、再現手順、期待する動作と実際の動作、環境、影響、証拠、顧客への質問がそろった、開発がすぐ着手できるバグ報告にする。
Claude・ChatGPT・コーディング用の AI で使えます。TeamとBusiness では、Pod に入れた公式スキルが改善のたびに自動で最新版になります。
使う場面
- チケットに不具合が書かれていて、開発に回すとき
- 開発から詳細不足でチケットが差し戻されたとき
AI に渡すもの
- チケットやチャットのやりとり
- わかれば顧客の環境
- 自分で試した再現の結果(任意)
できあがるもの
Jira、Linear、GitHub にそのまま貼れるバグ報告と、顧客への質問。
手順
- 何が、どこで失敗するかがわかる件名を書く 型は「[どこで・いつ] [操作] が [どう失敗する]」。例:「レポートの CSV エクスポートで1,000行を超える行が落ちる」。「エクスポートが壊れている」や、顧客の言葉そのままの「至急!!バグ」にはしない。
- 再現手順を、番号つきの単一の操作で書く わかっている状態から始める(「Team プランの管理者としてログインした状態」)。1手順に1クリックか1入力。画面の表記はそのまま太字で書く。顧客の手順があいまいなら、書ける分だけ書き、不確かな手順に「[未確認]」と付ける。
- 期待する動作と実際の動作を書く 期待: ドキュメントやこれまでの動作から、製品がすべきこと。実際: 起きたことを、目に見える形で(メッセージの文面、表示されたもの、表示されなかったもの)。エラーメッセージは一字一句そのまま引用する。
- 環境と頻度を記録する ブラウザー、アプリのバージョン、OS、プラン、アカウント ID、発生日時とタイムゾーン。頻度: 毎回、ときどき(y回中x回)、1回だけ。
- 影響の大きさを見積もる 報告している顧客数やチケット数、回避策の有無、お金・データ・セキュリティに関わるか。重大度(S1〜S4)を提案し、理由を1行で書く。
- 証拠を添える スクリーンショット、録画、ログ、チケット ID を並べる。顧客の個人情報は報告に書かず、チケット ID で参照する。
- 顧客に聞くことを並べる 足りない事実を、サポート担当がそのまま貼れる質問にする(「お使いのブラウザーとバージョンを教えていただけますか」)。質問は4つまで、大事な順に。
チームで使う
AI Skill Pod に追加すると、業務委託の方も含めてチーム全員が、自分の AI から同じ版を使えます。 AI スキルをチームで共有する方法を読む
変更履歴
- v1.0.0 · · First release.
出典
出典は英語のページです。
- Bug Writing Guidelines (2026-11-04に確認)
- Bug Report Guidelines | WebKit (2026-11-04に確認)
- Configuring issue templates for your repository (2026-11-04に確認)