FAQ Builder について
FAQ Builderは、顧客向けFAQの作成と保守を支援するスキルです。サポートやコンテンツ担当者向けに、チケットや文書、顧客とのやり取りから質問を見つけ、分類、回答作成、更新、効果分析を行います。
主な機能
- 01チケットや検索から質問を発見
- 02FAQのカテゴリ階層を設計
- 03明確なFAQ回答を作成
- 04製品変更に合わせてFAQを更新
- 05効果を分析して内容を最適化
- 06FAQテンプレートとチェック項目
活用シーン
- 01サポートチケットをFAQに整理
- 02製品文書からQ&Aを作成
- 03FAQの網羅性と鮮度を監査
- 04検索やフィードバックから内容の不足を特定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jmsktm/ claude-settings --skill faq-builderインストール後、Claude Code で/faq-builderを入力して読み込まれたか確認します。
詳細
FAQ ビルダー
サポートチケット、ドキュメント、ユーザーとのやり取りを、包括的で検索可能な FAQ コンテンツに変換する、専門的な FAQ データベース作成システムです。このスキルでは、よくある質問の特定、明確な回答の作成、コンテンツの階層的な整理、FAQ を常に最新の状態に保つための構造化されたワークフローを提供します。
FAQ は、顧客のセルフサービスの基盤です。適切に構築された FAQ データベースは、サポートチケットを減らし、顧客の不満を軽減し、サポートチームが複雑な問題に対応できるようにします。このスキルを使えば、実際に利用され、顧客が実際に尋ねる質問に答える FAQ を作成できます。
サポート運用とコンテンツ戦略のベストプラクティスに基づき、このスキルはデータマイニング、コンテンツ作成、継続的な改善を組み合わせ、製品の成長に合わせて拡張できる FAQ を作成します。
コアワークフロー
ワークフロー 1:質問の発見
サポートデータを分析して、顧客が実際に尋ねていることを特定します
-
サポートチケットの分析
- 最近のチケットをエクスポートします(過去 90 日間を推奨)
- トピックや機能の領域ごとに分類します
- 繰り返し寄せられる質問を特定します(3 回以上)
- 顧客が使っている正確な表現を記録します
- 質問の頻度や傾向を追跡します
-
検索クエリの分析
- ヘルプセンターの検索クエリを分析します
- 検索結果が 0 件のクエリ(回答が見つからない質問)を特定します
- 最もよく使われる検索語句を追跡します
- 検索に失敗するパターンを記録します
- 検索クエリと既存コンテンツの不足を対応付けます
-
顧客とのやり取りの情報源
- ライブチャットの記録
- コミュニティフォーラムの投稿
- ソーシャルメディアでの言及
- 営業電話での懸念事項
- オンボーディング時の質問
- NPS/CSAT アンケートのコメント
-
社内ナレッジの情報源
- サポートチームの暗黙知
- 営業向け FAQ ドキュメント
- 製品ドキュメントの不足箇所
- エンジニアリングチームが把握している既知の問題
- 機能のリリースノート
ワークフロー 2:FAQ の構成設計
論理的で分かりやすい階層に質問を整理します
-
カテゴリ構成
- はじめに:アカウントの設定、最初の手順、基本概念
- 機能と使い方:特定の機能の使い方
- 請求と支払い:料金、請求書、アップグレード
- アカウント管理:設定、セキュリティ、データ
- トラブルシューティング:よくある問題と解決方法
- インテグレーション:サードパーティとの連携
-
質問の階層
- 最上位カテゴリ(最大 5~8 個)
- サブカテゴリ(カテゴリごとに 3~7 個)
- 個別の質問(サブカテゴリごとに 5~15 個)
- 関連する質問へのリンク
-
ナビゲーション設計
- 検索機能(主要な方法)
- カテゴリ別の閲覧(補助的な方法)
- よく読まれている質問のセクション
- 最近更新された項目のセクション
- コンテキストに応じた FAQ(アプリ内への配置)
ワークフロー 3:回答の作成
質問を解決する、明確で役立つ回答を作成します
-
回答の構成テンプレート
[Direct Answer] - 1-2 sentences answering the question directly [Explanation] - Why/how, if needed for context [Steps] - Numbered steps if action required [Screenshot/Visual] - If helpful [Related Questions] - Links to related content [Still Need Help?] - Escalation path -
執筆ガイドライン
- まず回答を提示します(前置きは不要です)
- 社内用語ではなく、顧客が使う言葉を使います
- ざっと読める形式にします(箇条書き、見出し)
- 複雑な手順には図や画像を含めます
- 具体例を示します
- 詳細を知りたい場合に参照できるドキュメントへリンクします
-
回答の品質チェックリスト
- 最初の文で質問に直接答えている
- 顧客が使う言葉を使っている
- 必要な手順や操作が含まれている
- 手順が複雑な場合、視覚的な補助がある
- 関連コンテンツへのリンクがある
- エスカレーションの方法が示されている
- 専門知識のない人がテストしている
ワークフロー 4:FAQ のメンテナンス
コンテンツの正確さと鮮度を保つ
-
更新のトリガー
- 製品機能の変更
- UI/UX の更新
- 料金の変更
- ポリシーの更新
- 新たによくある質問が出てきた場合
- 回答の品質に関する問題が報告された場合
-
レビューの頻度
- 毎週:古くなったスクリーンショットや手順がないか確認します
- 毎月:質問の頻度データを確認します
- 四半期ごと:コンテンツ全体を監査します
- リリース時:影響を受ける FAQ を更新します
-
品質のモニタリング
- 「役に立ちましたか?」のフィードバックを追跡します
- FAQ からのエスカレーション率を監視します
- 検索からチケットへの相関を分析します
- FAQ を参照しているサポートチケットを確認します
-
廃止プロセス
- 非推奨機能に関する FAQ をアーカイブします
- 古い URL をリダイレクトします
- 相互参照を更新します
- 検索インデックスから削除します
ワークフロー 5:FAQ の分析と最適化
効果を測定し、継続的に改善します
-
主要な指標
- 自己解決率:チケットを作成しなかった訪問者の割合
- 検索成功率:検索で回答を見つけた人の割合
- 役立ち度評価:「役に立った」と評価された割合
- ページ滞在時間:エンゲージメントの指標
- チケットへの遷移:問題を解決できなかった FAQ
-
最適化のアクション
- 役立ち度評価が低い → 回答を書き直します
- チケットへの遷移率が高い → 回答が不完全です
- 閲覧数は少ないがチケット数が多い → 見つけにくい状態です
- 検索結果がゼロ → コンテンツに不足があります
- 検索数は多いがクリック数が少ない → タイトルと説明が一致していません
-
A/B テスト
- 回答形式をテストします(動画とテキスト)
- 質問の表現をテストします
- カテゴリの構成をテストします
- CTA の配置をテストします
クイックリファレンス
| アクション | コマンド/トリガー |
|---|---|
| FAQ の候補を見つけるためにチケットを分析する | "Mine tickets for FAQ opportunities" |
| トピックから FAQ を作成する | "Create FAQ for [feature]" |
| FAQ の網羅性を監査する | "Audit FAQ completeness" |
| FAQ の指標を確認する | "Show FAQ performance" |
| コンテンツの不足を見つける | "Identify FAQ gaps" |
| 質の低い FAQ を書き直す | "Improve FAQ for [question]" |
| FAQ の階層を構成する | "Design FAQ categories" |
| FAQ の鮮度を確認する | "Audit FAQ currency" |
| ドキュメントから FAQ を作成する | "Convert docs to FAQ" |
| 重複する FAQ を統合する | "Consolidate FAQ duplicates" |
ベストプラクティス
質問の作成
- 顧客が使う言葉をそのまま使います
- 行動を表す動詞から始めます:「どうすれば…できますか?」「…とは何ですか?」「…できますか?」
- 具体的にします:「パスワードのヘルプ」ではなく「パスワードをリセットするにはどうすればよいですか?」
- 検索意図に合わせます。質問はユーザーが入力する内容と一致させます
- 社内用語は避けます
回答の作成
- 前置きはせず、最初の文で回答します
- 受動態ではなく、二人称(「あなた」)を使います
- 複雑な回答は番号付きの手順に分けます
- UI に関する回答にはスクリーンショットを含めます
- 回答は簡潔に保ちます(300 語未満を目標にします)
- 網羅的な説明については、詳細なドキュメントにリンクします
整理
- 最上位のカテゴリは 5~8 個に制限します
- よく見られる質問には、最大 2 回のクリックでたどり着けるようにします
- 関連する質問同士を相互リンクします
- 一貫した命名規則を使います
- 強力な検索機能を有効にします
メンテナンス
- FAQ の各セクションに担当者を割り当てます
- FAQ に影響する製品変更のアラートを作成します
- 「役に立ちましたか?」の回答を必ず追跡します
- 古いコンテンツは削除せず、アーカイブします
- バージョン履歴を保持します
統合
- 製品 UI に状況に応じた FAQ を埋め込みます
- チャットボットやサポートのフローに FAQ を表示します
- オンボーディングの一連の流れに含めます
- サポートのマクロで参照します
- ナレッジベースの検索対象に追加します
FAQ テンプレート
シンプルな質問のテンプレート
## [Question in customer language]
[Direct answer in 1-2 sentences.]
[Additional context if needed.]
**Related questions:**
- [Related FAQ 1]
- [Related FAQ 2]
*Last updated: [Date]*
手順に関する質問のテンプレート
## How do I [action]?
[Brief explanation of what this does.]
### Steps
1. [First step]
![Screenshot if helpful]
2. [Second step]
3. [Third step]
### Notes
- [Any important considerations]
- [Common gotchas]
**Need help?** [Contact support link]
*Last updated: [Date]*
トラブルシューティングのテンプレート
## [Problem statement as customer would phrase it]
This usually happens when [common cause].
### Quick fixes
1. **Try this first**: [Most common solution]
2. **If that doesn't work**: [Second option]
3. **Still having issues**: [Third option]
### When to contact support
If none of the above work, [contact support] with:
- [Information to include]
- [Error messages/screenshots]
*Last updated: [Date]*
注意すべき兆候
- チケットへの遷移率が高い:回答で質問を解決できていません
- 検索成功率が低い:コンテンツが検索語と一致していません
- 古いスクリーンショット:製品が変更されています
- 社内用語:顧客が理解できません
- エスカレーション先がない:行き止まりがユーザーを困らせます
- コンテンツの重複:混乱を招き、SEO の効果を薄めます
- 孤立した FAQ:コンテンツへのナビゲーション経路がありません
統合ポイント
- サポートチケット管理:チケット作成前にFAQを自動提案します
- チャットボット:FAQを最初の回答ソースとして使用します
- アプリ内ヘルプ:コンテキストに応じたFAQウィジェットを表示します
- 検索:FAQとドキュメントを横断して統合検索します
- 分析:問い合わせの削減とエンゲージメントを追跡します
- CMS:構造化されたコンテンツ管理を行います