公式スキル · カスタマーサクセス
ヘルプ記事の作成
1つの作業についてヘルプ記事を書く。作業名のタイトル、先に答え、画面どおりのラベルの番号つき手順、スクリーンショットのメモ、トラブルシューティング、関連記事。
Claude・ChatGPT・コーディング用の AI で使えます。TeamとBusiness では、Pod に入れた公式スキルが改善のたびに自動で最新版になります。
使う場面
- 同じ質問がくり返し届き、回答が担当者の返信の中にしかないとき
- 新しい機能を出し、お客さまに使い方を伝える必要があるとき
AI に渡すもの
- 作業と、それができる人
- 実際の手順と画面のラベル
- 問い合わせでわかっている問題
できあがるもの
スクリーンショットの差し込み位置とトラブルシューティングつきの、そのまま公開できるヘルプ記事。
手順
- タイトルを作業名にする お客さまが検索する形で、作業そのものを書く:「連絡先を CSV で書き出す」「ワークスペースにメンバーを追加する」。「エクスポート機能」や「エクスポートについて」にはしない。1記事に1つの作業。メモが2つの作業にまたがるなら、2記事に分ける。
- 最初の2文で答える その作業で何ができるかと、いちばん短い道筋を書く:「連絡先は **連絡先** > **書き出し** から書き出せます。数分以内にファイルがメールで届きます。」続けて、だれが行えるか、先に何が必要か(役割、プラン、権限)。
- 番号つきの手順を、1手順1操作で書く 各手順は操作から書き始める。画面のラベルは、表示どおりの表記で太字にする。メニューの道筋は **設定** > **チーム** のように書き、「>」は太字にしない。操作の前に場所を書く:「右上の **設定** をクリックします。」手順は3〜10個。それより長ければ、見出しつきの節に分ける。
- うまくいったときの状態を書く 最後の手順のあとに、成功したらお客さまに何が見えるかを1行で:メッセージ、ファイル、一覧に増えた項目。
- 役に立つ場所にだけスクリーンショットを置く 押す場所が見つけにくい手順や、画面が込み入っている手順のあとに差し込み位置を入れる。すべての手順のあとには入れない。何が写っているかを書いておけば、あとで撮影でき、代替テキストにもなる。
- 実際の問題からトラブルシューティングを書く 各項目は、お客さまの言葉で症状を見出しにし、原因と対処を1〜3文で書く。問い合わせかプロダクトチームから聞いた問題だけを使い、エラーをつくらない。
- 関連記事を2〜4本リンクする 次にやりそうな作業と、前提となる作業。記事の実際のタイトルが渡されていればそれを使い、なければ「[関連: トピック]」と書く。
チームで使う
AI Skill Pod に追加すると、業務委託の方も含めてチーム全員が、自分の AI から同じ版を使えます。 AI スキルをチームで共有する方法を読む
変更履歴
- v1.0.0 · · First release.
出典
出典は英語のページです。
- Procedures | Google developer documentation style guide (2026-11-04に確認)
- UI elements and interaction | Google developer documentation style guide (2026-11-04に確認)
- Writing step-by-step instructions - Microsoft Style Guide (2026-11-04に確認)
- Tips & Templates for Writing Great Knowledge Base Articles (2026-11-04に確認)
- Create different types of articles in your Help Center (2026-11-04に確認)