mcpField
F
FAQ Builder

FAQ Builder

github.com/jmsktmドキュメント10204 回インストール40 週間前に更新
リポジトリ

FAQ Builder について

FAQ Builderは、顧客向けFAQの作成と保守を支援するスキルです。サポートやコンテンツ担当者向けに、チケットや文書、顧客とのやり取りから質問を見つけ、分類、回答作成、更新、効果分析を行います。

主な機能

  1. 01チケットや検索から質問を発見
  2. 02FAQのカテゴリ階層を設計
  3. 03明確なFAQ回答を作成
  4. 04製品変更に合わせてFAQを更新
  5. 05効果を分析して内容を最適化
  6. 06FAQテンプレートとチェック項目

活用シーン

  1. 01サポートチケットをFAQに整理
  2. 02製品文書からQ&Aを作成
  3. 03FAQの網羅性と鮮度を監査
  4. 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:質問の発見

サポートデータを分析して、顧客が実際に尋ねていることを特定します

  1. サポートチケットの分析

    • 最近のチケットをエクスポートします(過去 90 日間を推奨)
    • トピックや機能の領域ごとに分類します
    • 繰り返し寄せられる質問を特定します(3 回以上)
    • 顧客が使っている正確な表現を記録します
    • 質問の頻度や傾向を追跡します
  2. 検索クエリの分析

    • ヘルプセンターの検索クエリを分析します
    • 検索結果が 0 件のクエリ(回答が見つからない質問)を特定します
    • 最もよく使われる検索語句を追跡します
    • 検索に失敗するパターンを記録します
    • 検索クエリと既存コンテンツの不足を対応付けます
  3. 顧客とのやり取りの情報源

    • ライブチャットの記録
    • コミュニティフォーラムの投稿
    • ソーシャルメディアでの言及
    • 営業電話での懸念事項
    • オンボーディング時の質問
    • NPS/CSAT アンケートのコメント
  4. 社内ナレッジの情報源

    • サポートチームの暗黙知
    • 営業向け FAQ ドキュメント
    • 製品ドキュメントの不足箇所
    • エンジニアリングチームが把握している既知の問題
    • 機能のリリースノート
ワークフロー 2:FAQ の構成設計

論理的で分かりやすい階層に質問を整理します

  1. カテゴリ構成

    • はじめに:アカウントの設定、最初の手順、基本概念
    • 機能と使い方:特定の機能の使い方
    • 請求と支払い:料金、請求書、アップグレード
    • アカウント管理:設定、セキュリティ、データ
    • トラブルシューティング:よくある問題と解決方法
    • インテグレーション:サードパーティとの連携
  2. 質問の階層

    • 最上位カテゴリ(最大 5~8 個)
    • サブカテゴリ(カテゴリごとに 3~7 個)
    • 個別の質問(サブカテゴリごとに 5~15 個)
    • 関連する質問へのリンク
  3. ナビゲーション設計

    • 検索機能(主要な方法)
    • カテゴリ別の閲覧(補助的な方法)
    • よく読まれている質問のセクション
    • 最近更新された項目のセクション
    • コンテキストに応じた FAQ(アプリ内への配置)
ワークフロー 3:回答の作成

質問を解決する、明確で役立つ回答を作成します

  1. 回答の構成テンプレート

    [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
    
  2. 執筆ガイドライン

    • まず回答を提示します(前置きは不要です)
    • 社内用語ではなく、顧客が使う言葉を使います
    • ざっと読める形式にします(箇条書き、見出し)
    • 複雑な手順には図や画像を含めます
    • 具体例を示します
    • 詳細を知りたい場合に参照できるドキュメントへリンクします
  3. 回答の品質チェックリスト

    • 最初の文で質問に直接答えている
    • 顧客が使う言葉を使っている
    • 必要な手順や操作が含まれている
    • 手順が複雑な場合、視覚的な補助がある
    • 関連コンテンツへのリンクがある
    • エスカレーションの方法が示されている
    • 専門知識のない人がテストしている
ワークフロー 4:FAQ のメンテナンス

コンテンツの正確さと鮮度を保つ

  1. 更新のトリガー

    • 製品機能の変更
    • UI/UX の更新
    • 料金の変更
    • ポリシーの更新
    • 新たによくある質問が出てきた場合
    • 回答の品質に関する問題が報告された場合
  2. レビューの頻度

    • 毎週:古くなったスクリーンショットや手順がないか確認します
    • 毎月:質問の頻度データを確認します
    • 四半期ごと:コンテンツ全体を監査します
    • リリース時:影響を受ける FAQ を更新します
  3. 品質のモニタリング

    • 「役に立ちましたか?」のフィードバックを追跡します
    • FAQ からのエスカレーション率を監視します
    • 検索からチケットへの相関を分析します
    • FAQ を参照しているサポートチケットを確認します
  4. 廃止プロセス

    • 非推奨機能に関する FAQ をアーカイブします
    • 古い URL をリダイレクトします
    • 相互参照を更新します
    • 検索インデックスから削除します
ワークフロー 5:FAQ の分析と最適化

効果を測定し、継続的に改善します

  1. 主要な指標

    • 自己解決率:チケットを作成しなかった訪問者の割合
    • 検索成功率:検索で回答を見つけた人の割合
    • 役立ち度評価:「役に立った」と評価された割合
    • ページ滞在時間:エンゲージメントの指標
    • チケットへの遷移:問題を解決できなかった FAQ
  2. 最適化のアクション

    • 役立ち度評価が低い → 回答を書き直します
    • チケットへの遷移率が高い → 回答が不完全です
    • 閲覧数は少ないがチケット数が多い → 見つけにくい状態です
    • 検索結果がゼロ → コンテンツに不足があります
    • 検索数は多いがクリック数が少ない → タイトルと説明が一致していません
  3. 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:構造化されたコンテンツ管理を行います

コメント