mcpField
H
help-center-design

help-center-design

github.com/vasilyu1983デザイン・UI50 回インストール
リポジトリ

help-center-design について

help-center-design は、AI を前提としたヘルプセンター、ナレッジベース、FAQ、学習コンテンツを設計するスキルです。セルフサービスサポートとコンテンツ運用を担うチーム向けに、情報設計から AI 支援、継続的な管理まで扱います。

主な機能

  1. 01範囲と情報アーキテクチャの設計
  2. 02記事タイプとコンテンツテンプレートの作成
  3. 03分析指標とイベント追跡の定義
  4. 04引用とエスカレーション規則を含む AI 支援の設計
  5. 05コンテンツのレビューと更新体制の構築

活用シーン

  1. 01製品ヘルプセンターの新規構築
  2. 02カテゴリ、タグ、記事の優先順位付け
  3. 03AI サポートの RAG と有人対応規則の設計
  4. 04検索・サポートデータに基づくコンテンツ更新

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/vasilyu1983/ai-agents-public --skill help-center-design

インストール後、Claude Code で/help-center-designを入力して読み込まれたか確認します。

詳細

ヘルプセンターの設計

AI ファーストのヘルプセンター、ナレッジベース、よくある質問、学習教材を設計します。

このスキルでは、静的なヘルプポータルから、AI を活用した、組み込み型でパーソナライズされたセルフサービスシステムへの移行を反映しています。

ワークフロー(既定の順序として使用)

  1. 範囲と制約を定義する
    • 対象者/ペルソナ、製品領域、製品のバージョン管理、チャネル(Web/アプリ内)、コンプライアンス要件、ローカライズのニーズ。
  2. 現在のナレッジを棚卸しする
    • 問い合わせの多いチケット、検索数の多い語句、閲覧数の多い記事、エスカレーションの主な理由、既知のコンテンツオーナー。
  3. 情報アーキテクチャを構築する
    • カテゴリ構成、タグ付け、ナビゲーション、URL 戦略、内部リンク。
  4. コンテンツを標準化する
    • 記事の種類、テンプレート、AI に適した執筆ルール、ビジュアルの基準。
  5. 計測の仕組みを導入し、測定する
    • KPI、イベントトラッキング、ダッシュボード、検索クエリのログ記録。
  6. AI サポートを安全に導入する
    • 検索を優先した回答、引用、信頼度のしきい値、エスカレーションルール、トランザクションのガードレール。
  7. ナレッジ運用を実施する
    • ガバナンス、情報の鮮度検知、リリースに応じた更新、継続的な最適化。

期待される成果物(依頼に応じて調整してください):

  • ヘルプセンターの分類体系マップ+タグスキーマ
  • 優先度順の記事バックログ上位 20 件+テンプレート
  • 分析仕様(イベント+ダッシュボード KPI)
  • AI サポート仕様(RAG ソース、エスカレーションのしきい値、安全ルール)
  • 運用サイクル(担当者+レビューのスケジュール)

クイックリファレンス

コンテンツタイプの選択マトリクス
ユーザーニーズコンテンツタイプ形式AI の役割
「方法を知りたい」ハウツーステップごとの手順次のステップを提案
「うまくいかない理由を知りたい」トラブルシューティング問題 -> 原因 -> 解決策診断して解決
「概要を知りたい」概念説明解説背景を要約
「すぐに答えが欲しい」よくある質問質問と回答の組み合わせ即座に回答
「仕様をすべて知りたい」リファレンス表、リスト検索して取得
「機能を学びたい」チュートリアル動画+インタラクティブコンテンツパーソナライズされた学習経路
プラットフォームの選定(料金とプランの制限を確認してください)
企業の段階プラットフォーム月額費用最適な用途
エンタープライズZendesk$55+/agent複雑なワークフロー、コンプライアンス
成長期/SaaSIntercom$29/seat + $0.99/resolution会話型サポート、PLG
SMB/スタートアップFreshdesk$29-69/agent予算重視、ネイティブ AI
開発者向けGitBook/Notion$0-20/userDocs-as-code

セットアップ/移行に関する注意事項は references/platform-guides.md を、厳選した比較ソースは data/sources.json を参照してください。

2025-2026 年のベストプラクティス

主な変化
項目従来(2024 年以前)最新(2025-2026 年)
サポートモデル独立したヘルプポータルアプリ内に組み込まれたヘルプ
AI の役割検索アシスタント安全なエスカレーションを伴う、より高度な自動化
検索キーワード一致セマンティック検索+RAG
コンテンツテキスト中心の記事ビジュアル優先(動画、GIF、スクリーンショット)
パーソナライズすべてのユーザーに同じ内容役割、バージョン、行動に応じて調整
メンテナンス手作業での編集AI による鮮度検知
ナビゲーションカテゴリの閲覧会話型+コンテキストに応じた案内

検証なしに確定的な統計値を引用しないでください。必要に応じて、data/sources.json を使ってトレンドとベンチマークを更新してください。

AI ファーストの原則
  1. エージェントによる解決 — AI は回答するだけでなく、タスク(返金、予約、更新)を実行します
  2. セマンティックな理解 — キーワード一致ではなく、意図に基づいて検索します
  3. プロアクティブな支援 — ユーザーが尋ねる前にヘルプを提示します
  4. コンテンツの鮮度 — 古くなったコンテンツを自動検知し、更新を提案します
  5. 複数ソースの統合 — ドキュメント、チケット、Slack、リリースノートから情報を取り込みます
  6. 豊富な記憶を備えた AI — セッションをまたいでコンテキストを保持し、パーソナライズされたサポートを提供します
新たなトレンド(2026年)
トレンド説明影響
音声検索ユーザーは情報を探すとき、入力する代わりに話します自然言語によるナレッジベースのコンテンツが必要です
プロアクティブ AIAI が問題を検出し、ユーザーから報告される前に解決します問い合わせ件数を減らします
ヘルプの埋め込みヘルプが独立したポータルではなく、状況に応じて表示されますエンゲージメントが高まり、利用のハードルが下がります
AI オペレーションリードAI エージェントの動作を監督する新たな役割です実行から監督へと重点が移ります
ハルシネーションの抑制RAG による根拠付けで、AI の捏造を減らします引用元や情報源へのリンクが必要です

ヘルプセンターのアーキテクチャ

カテゴリ構成のルール
HIERARCHY LIMITS
- Maximum depth: 2-3 levels
- Top-level categories: 5-9 (cognitive load principle)
- Articles per category: 10-20 (scannable)
- Avoid: Deep nesting, internal org structure
推奨される最上位カテゴリ
STANDARD CATEGORIES (adapt to product)
1. Getting Started        — First-run, setup, quick wins
2. [Core Feature 1]       — Primary use case
3. [Core Feature 2]       — Secondary use case
4. Account & Billing      — Settings, payments, security
5. Integrations           — Third-party connections
6. Troubleshooting        — Common issues, error codes
7. API & Developers       — Technical documentation
8. What's New             — Changelog, releases
ナビゲーションのパターン
  • パンくずリスト — 階層内の現在位置を常に表示します
  • 関連記事 — 文脈に応じた関連性の高いリンクを3〜5件表示します
  • 次のステップ — 次に取るべき行動を案内します
  • 検索の見つけやすさ — 常にファーストビュー内に表示します
  • 人気の記事 — アクセス数の多いコンテンツを表示します

記事の種類(種類は少なく保つ)

  • ハウツー:タスクの完了方法、3〜10ステップ
  • トラブルシューティング:症状 -> 原因 -> 解決策
  • FAQ:詳しいドキュメントへのリンクを含む、すばやく確認できる回答
  • 概念解説:用語やメンタルモデルの説明
  • リファレンス:正確な仕様(表、制限、エラーコード)

references/article-templates.md にあるコピー&ペースト用テンプレートを使用してください。

AI 統合パターン

チャットボットのアーキテクチャ
MODERN AI SUPPORT FLOW (2025)

User query
  -> Intent detection (semantic understanding)
  -> RAG retrieval (KB + tickets + docs)
  -> Response and action (answer and/or execute task)
  -> Escalation check (confidence below threshold?)
  -> Human agent (if needed)
エージェント型 AI の機能(2025〜2026年)
機能例プラットフォーム
タスクの実行返金処理Ada、Zendesk AI
予約通話を予約Chatbase、Calendly
アカウントの更新プランを変更Fin AI、カスタム
チケットの作成人間の担当者にエスカレーションすべてのプラットフォーム
複数システムの照会注文と配送状況を確認MCP 統合
AI が利用するコンテンツ
AI-FRIENDLY WRITING RULES

DO:
- Clear headings with keywords
- Structured data (tables, lists)
- Explicit step numbering
- Error messages verbatim
- Unique article titles

DON'T:
- Ambiguous pronouns
- Implicit assumptions
- Marketing fluff in support content
- Duplicate content across articles

RAG の設定、評価、エスカレーションのパターンについては、references/ai-integration.md を参照してください。

指標と KPI

主要な指標
指標定義ベンチマーク
セルフサービス率エージェントなしで解決した問題の割合60〜80%
問い合わせ抑制率ナレッジベースによって回避されたチケットの割合30〜50%
検索成功率検索結果が役に立った検索の割合>70%
CSAT(ナレッジベース)記事の有用性に対する評価80%超が肯定的
解決までの時間セルフサービスでの完了時間<3 min
検索結果ゼロ率結果が見つからなかった検索の割合<5%
コンテンツの健全性指標
FRESHNESS INDICATORS
- Last updated > 6 months -> Review required
- Last updated > 12 months -> Likely stale
- No views in 90 days -> Consider archive
- High bounce rate -> Content mismatch

QUALITY INDICATORS
- Thumbs down > 20% -> Rewrite needed
- Escalation after viewing -> Content gap
- Search -> immediate exit -> Title mismatch
ROI の計算
SELF-SERVICE ROI FORMULA

Monthly Savings = (Deflected Tickets x $13) - Platform Cost

Example:
- 1,000 deflected tickets/month
- $13 average agent cost
- $500 platform cost
- ROI = ($13,000 - $500) = $12,500/month

計測の設定、ダッシュボード、最適化のプレイブックについては、references/metrics-optimization.md を参照してください。

学習とオンボーディング

アプリ内ヘルプのパターン
パターンユースケースツール
ツールチップフィールド単位のガイダンスネイティブ、Appcues
ホットスポット機能の発見UserPilot、Pendo
チェックリストオンボーディングの進捗Whatfix、Chameleon
ツアー新機能の紹介Intercom、Appcues
コンテキストに応じたヘルプエラーからの復旧カスタム、Zendesk
チュートリアルのベストプラクティス(2025年)
VIDEO TUTORIALS
- Length: 2-4 minutes (40% higher completion)
- Format: Screen recording + voiceover
- Chapters: Clickable sections
- Captions: Always include (accessibility)

INTERACTIVE GUIDES
- Click-through walkthroughs
- Sandbox environments
- Progress saving
- Skip option for experienced users

オンボーディングの順序設計、アクセシビリティ、効果測定については、references/learning-paths.md を参照してください。

ナレッジ運用(2026年)

ヘルプセンターをプロダクトのように運用します。

  • カテゴリごと、および主要記事ごとに担当者を割り当て、レビュー頻度と更新の SLA を定めます。
  • リリースノート、インシデントレポート、チケットの傾向を、コンテンツ更新の自動トリガーとして使用します。
  • コンテンツの鮮度を示すシグナル(検索後の離脱、記事閲覧後のエスカレーション、低評価)を使って、書き直しの優先順位を決めます。

ガバナンス、ワークフロー、チェックリストについては、references/knowledge-ops.md を参照してください。

導入チェックリスト

フェーズ 1:基盤(第 1~2 週)

必須:

  • プラットフォームを選定します(Zendesk/Intercom/Freshdesk)
  • カテゴリー構成を定義します(最上位カテゴリーを 5~9 個)
  • 各タイプの記事テンプレートを作成します
  • アナリティクスのトラッキングを設定します
  • 検索設定を構成します
フェーズ 2:コンテンツ(第 3~4 週)

必須:

  • 既存ドキュメントを監査します
  • 上位 20 件の記事を移行または書き直します
  • ビジュアルコンテンツ(スクリーンショット、GIF)を追加します
  • 内部リンクを実装します
  • 古い URL からのリダイレクトを設定します
フェーズ 3:AI 統合(第 5~6 週)

必須:

  • AI チャットボットを有効にします
  • RAG/セマンティック検索を構成します
  • エスカレーションのしきい値を設定します
  • よくある問い合わせをテストします
  • 解決率を監視します
フェーズ 4:最適化(継続中)

必須:

  • 検索結果がゼロだった検索を毎週確認します
  • 古くなったコンテンツを毎月更新します
  • 記事タイトルの A/B テストを実施します
  • エスカレーションのパターンを分析します
  • チケットの傾向に基づいて拡充します

リソース

リソース内容
article-templates.md5 種類すべての記事タイプの完全なテンプレート
taxonomy-patterns.mdカテゴリー構成、タグ付け、検索の最適化
ai-integration.mdRAG の設定、チャットボットの構成、プラットフォーム連携
platform-guides.mdZendesk、Intercom、Freshdesk、GitBook の設定
learning-paths.mdオンボーディングの手順、チュートリアルの設計、コース
metrics-optimization.mdKPI の追跡、アナリティクス、A/B テスト
knowledge-ops.mdガバナンス、ワークフロー、運用の周期
content-migration-guide.mdプラットフォームの移行、URL リダイレクト、コンテンツの仕分け
multilingual-support.md翻訳ワークフロー、用語集、RTL のサポート
accessibility-standards.mdヘルプコンテンツ向け WCAG 2.2 AA、監査チェックリスト
sources.jsonadd_as_web_search フラグ付きの厳選ソース

トレンド把握プロトコル

必須:ヘルプセンター、ナレッジベース、サポートプラットフォームに関する推奨事項をユーザーから尋ねられた場合は、回答前に簡単なウェブ検索を行い、最新のトレンドを確認してください。data/sources.json で add_as_web_search: true のフラグが付いたソースを優先し、推奨するプラットフォームについては公式ドキュメントも参照してください。

発動条件
  • 「おすすめのヘルプセンタープラットフォームは何ですか?」
  • 「[ナレッジベース/FAQ/サポート]には何を使えばよいですか?」
  • 「カスタマーセルフサービスの最新情報は何ですか?」
  • 「[AI サポート/チャットボット]の現在のベストプラクティスは何ですか?」
  • 「[Zendesk/Intercom/Freshdesk]は 2026 年現在も有効ですか?」
  • 「[Zendesk]と[Intercom]と[その他]を比較するとどうですか?」
  • 「カスタマーサポートに最適な AI チャットボットは何ですか?」
必須の検索
  1. 検索:"help center best practices 2026"
  2. 検索:"[specific platform] vs alternatives 2026"
  3. 検索:"AI customer support trends January 2026"
  4. 検索:"knowledge base platforms 2026"
報告内容

検索後、次の内容を提示してください。

  • 現在の状況:現在人気のあるサポートプラットフォーム/ツール
  • 新たなトレンド:注目を集めている新しい AI 機能、パターン、プラットフォーム
  • 非推奨/衰退傾向:関連性が薄れつつあるアプローチやツール
  • 推奨事項:固定的な知識だけでなく、最新データに基づく推奨

ウェブ検索が利用できない場合は、その制約を明記し、可能な範囲で静的な情報に基づいて案内してください。

トピック例(最新の検索で確認)
  • ヘルプセンタープラットフォーム(Zendesk、Intercom、Freshdesk)
  • AI サポートエージェント(Fin AI、Ada、Forethought)
  • ナレッジベースツール(Document360、GitBook、Notion)
  • アプリ内ガイダンス(UserPilot、Pendo、Chameleon)
  • セルフサービス AI 機能と解決率
  • サポート向けセマンティック検索と RAG

コメント