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

ヘルプ記事の作成

1つの作業についてヘルプ記事を書く。作業名のタイトル、先に答え、画面どおりのラベルの番号つき手順、スクリーンショットのメモ、トラブルシューティング、関連記事。

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

使う場面

AI に渡すもの

できあがるもの

スクリーンショットの差し込み位置とトラブルシューティングつきの、そのまま公開できるヘルプ記事。

手順

  1. タイトルを作業名にする お客さまが検索する形で、作業そのものを書く:「連絡先を CSV で書き出す」「ワークスペースにメンバーを追加する」。「エクスポート機能」や「エクスポートについて」にはしない。1記事に1つの作業。メモが2つの作業にまたがるなら、2記事に分ける。
  2. 最初の2文で答える その作業で何ができるかと、いちばん短い道筋を書く:「連絡先は **連絡先** > **書き出し** から書き出せます。数分以内にファイルがメールで届きます。」続けて、だれが行えるか、先に何が必要か(役割、プラン、権限)。
  3. 番号つきの手順を、1手順1操作で書く 各手順は操作から書き始める。画面のラベルは、表示どおりの表記で太字にする。メニューの道筋は **設定** > **チーム** のように書き、「>」は太字にしない。操作の前に場所を書く:「右上の **設定** をクリックします。」手順は3〜10個。それより長ければ、見出しつきの節に分ける。
  4. うまくいったときの状態を書く 最後の手順のあとに、成功したらお客さまに何が見えるかを1行で:メッセージ、ファイル、一覧に増えた項目。
  5. 役に立つ場所にだけスクリーンショットを置く 押す場所が見つけにくい手順や、画面が込み入っている手順のあとに差し込み位置を入れる。すべての手順のあとには入れない。何が写っているかを書いておけば、あとで撮影でき、代替テキストにもなる。
  6. 実際の問題からトラブルシューティングを書く 各項目は、お客さまの言葉で症状を見出しにし、原因と対処を1〜3文で書く。問い合わせかプロダクトチームから聞いた問題だけを使い、エラーをつくらない。
  7. 関連記事を2〜4本リンクする 次にやりそうな作業と、前提となる作業。記事の実際のタイトルが渡されていればそれを使い、なければ「[関連: トピック]」と書く。

チームで使う

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

チームのPodに追加

変更履歴

出典

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

  1. Procedures | Google developer documentation style guide (2026-11-04に確認)
  2. UI elements and interaction | Google developer documentation style guide (2026-11-04に確認)
  3. Writing step-by-step instructions - Microsoft Style Guide (2026-11-04に確認)
  4. Tips & Templates for Writing Great Knowledge Base Articles (2026-11-04に確認)
  5. Create different types of articles in your Help Center (2026-11-04に確認)