help-center-design について
help-center-design は、AI を前提としたヘルプセンター、ナレッジベース、FAQ、学習コンテンツを設計するスキルです。セルフサービスサポートとコンテンツ運用を担うチーム向けに、情報設計から AI 支援、継続的な管理まで扱います。
主な機能
- 01範囲と情報アーキテクチャの設計
- 02記事タイプとコンテンツテンプレートの作成
- 03分析指標とイベント追跡の定義
- 04引用とエスカレーション規則を含む AI 支援の設計
- 05コンテンツのレビューと更新体制の構築
活用シーン
- 01製品ヘルプセンターの新規構築
- 02カテゴリ、タグ、記事の優先順位付け
- 03AI サポートの RAG と有人対応規則の設計
- 04検索・サポートデータに基づくコンテンツ更新
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ vasilyu1983/ ai-agents-public --skill help-center-designインストール後、Claude Code で/help-center-designを入力して読み込まれたか確認します。
詳細
ヘルプセンターの設計
AI ファーストのヘルプセンター、ナレッジベース、よくある質問、学習教材を設計します。
このスキルでは、静的なヘルプポータルから、AI を活用した、組み込み型でパーソナライズされたセルフサービスシステムへの移行を反映しています。
ワークフロー(既定の順序として使用)
- 範囲と制約を定義する
- 対象者/ペルソナ、製品領域、製品のバージョン管理、チャネル(Web/アプリ内)、コンプライアンス要件、ローカライズのニーズ。
- 現在のナレッジを棚卸しする
- 問い合わせの多いチケット、検索数の多い語句、閲覧数の多い記事、エスカレーションの主な理由、既知のコンテンツオーナー。
- 情報アーキテクチャを構築する
- カテゴリ構成、タグ付け、ナビゲーション、URL 戦略、内部リンク。
- コンテンツを標準化する
- 記事の種類、テンプレート、AI に適した執筆ルール、ビジュアルの基準。
- 計測の仕組みを導入し、測定する
- KPI、イベントトラッキング、ダッシュボード、検索クエリのログ記録。
- AI サポートを安全に導入する
- 検索を優先した回答、引用、信頼度のしきい値、エスカレーションルール、トランザクションのガードレール。
- ナレッジ運用を実施する
- ガバナンス、情報の鮮度検知、リリースに応じた更新、継続的な最適化。
期待される成果物(依頼に応じて調整してください):
- ヘルプセンターの分類体系マップ+タグスキーマ
- 優先度順の記事バックログ上位 20 件+テンプレート
- 分析仕様(イベント+ダッシュボード KPI)
- AI サポート仕様(RAG ソース、エスカレーションのしきい値、安全ルール)
- 運用サイクル(担当者+レビューのスケジュール)
クイックリファレンス
コンテンツタイプの選択マトリクス
| ユーザーニーズ | コンテンツタイプ | 形式 | AI の役割 |
|---|---|---|---|
| 「方法を知りたい」 | ハウツー | ステップごとの手順 | 次のステップを提案 |
| 「うまくいかない理由を知りたい」 | トラブルシューティング | 問題 -> 原因 -> 解決策 | 診断して解決 |
| 「概要を知りたい」 | 概念説明 | 解説 | 背景を要約 |
| 「すぐに答えが欲しい」 | よくある質問 | 質問と回答の組み合わせ | 即座に回答 |
| 「仕様をすべて知りたい」 | リファレンス | 表、リスト | 検索して取得 |
| 「機能を学びたい」 | チュートリアル | 動画+インタラクティブコンテンツ | パーソナライズされた学習経路 |
プラットフォームの選定(料金とプランの制限を確認してください)
| 企業の段階 | プラットフォーム | 月額費用 | 最適な用途 |
|---|---|---|---|
| エンタープライズ | Zendesk | $55+/agent | 複雑なワークフロー、コンプライアンス |
| 成長期/SaaS | Intercom | $29/seat + $0.99/resolution | 会話型サポート、PLG |
| SMB/スタートアップ | Freshdesk | $29-69/agent | 予算重視、ネイティブ AI |
| 開発者向け | GitBook/Notion | $0-20/user | Docs-as-code |
セットアップ/移行に関する注意事項は references/platform-guides.md を、厳選した比較ソースは data/sources.json を参照してください。
2025-2026 年のベストプラクティス
主な変化
| 項目 | 従来(2024 年以前) | 最新(2025-2026 年) |
|---|---|---|
| サポートモデル | 独立したヘルプポータル | アプリ内に組み込まれたヘルプ |
| AI の役割 | 検索アシスタント | 安全なエスカレーションを伴う、より高度な自動化 |
| 検索 | キーワード一致 | セマンティック検索+RAG |
| コンテンツ | テキスト中心の記事 | ビジュアル優先(動画、GIF、スクリーンショット) |
| パーソナライズ | すべてのユーザーに同じ内容 | 役割、バージョン、行動に応じて調整 |
| メンテナンス | 手作業での編集 | AI による鮮度検知 |
| ナビゲーション | カテゴリの閲覧 | 会話型+コンテキストに応じた案内 |
検証なしに確定的な統計値を引用しないでください。必要に応じて、data/sources.json を使ってトレンドとベンチマークを更新してください。
AI ファーストの原則
- エージェントによる解決 — AI は回答するだけでなく、タスク(返金、予約、更新)を実行します
- セマンティックな理解 — キーワード一致ではなく、意図に基づいて検索します
- プロアクティブな支援 — ユーザーが尋ねる前にヘルプを提示します
- コンテンツの鮮度 — 古くなったコンテンツを自動検知し、更新を提案します
- 複数ソースの統合 — ドキュメント、チケット、Slack、リリースノートから情報を取り込みます
- 豊富な記憶を備えた AI — セッションをまたいでコンテキストを保持し、パーソナライズされたサポートを提供します
新たなトレンド(2026年)
| トレンド | 説明 | 影響 |
|---|---|---|
| 音声検索 | ユーザーは情報を探すとき、入力する代わりに話します | 自然言語によるナレッジベースのコンテンツが必要です |
| プロアクティブ AI | AI が問題を検出し、ユーザーから報告される前に解決します | 問い合わせ件数を減らします |
| ヘルプの埋め込み | ヘルプが独立したポータルではなく、状況に応じて表示されます | エンゲージメントが高まり、利用のハードルが下がります |
| 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.md | 5 種類すべての記事タイプの完全なテンプレート |
| taxonomy-patterns.md | カテゴリー構成、タグ付け、検索の最適化 |
| ai-integration.md | RAG の設定、チャットボットの構成、プラットフォーム連携 |
| platform-guides.md | Zendesk、Intercom、Freshdesk、GitBook の設定 |
| learning-paths.md | オンボーディングの手順、チュートリアルの設計、コース |
| metrics-optimization.md | KPI の追跡、アナリティクス、A/B テスト |
| knowledge-ops.md | ガバナンス、ワークフロー、運用の周期 |
| content-migration-guide.md | プラットフォームの移行、URL リダイレクト、コンテンツの仕分け |
| multilingual-support.md | 翻訳ワークフロー、用語集、RTL のサポート |
| accessibility-standards.md | ヘルプコンテンツ向け WCAG 2.2 AA、監査チェックリスト |
| sources.json | add_as_web_search フラグ付きの厳選ソース |
トレンド把握プロトコル
必須:ヘルプセンター、ナレッジベース、サポートプラットフォームに関する推奨事項をユーザーから尋ねられた場合は、回答前に簡単なウェブ検索を行い、最新のトレンドを確認してください。data/sources.json で add_as_web_search: true のフラグが付いたソースを優先し、推奨するプラットフォームについては公式ドキュメントも参照してください。
発動条件
- 「おすすめのヘルプセンタープラットフォームは何ですか?」
- 「[ナレッジベース/FAQ/サポート]には何を使えばよいですか?」
- 「カスタマーセルフサービスの最新情報は何ですか?」
- 「[AI サポート/チャットボット]の現在のベストプラクティスは何ですか?」
- 「[Zendesk/Intercom/Freshdesk]は 2026 年現在も有効ですか?」
- 「[Zendesk]と[Intercom]と[その他]を比較するとどうですか?」
- 「カスタマーサポートに最適な AI チャットボットは何ですか?」
必須の検索
- 検索:
"help center best practices 2026" - 検索:
"[specific platform] vs alternatives 2026" - 検索:
"AI customer support trends January 2026" - 検索:
"knowledge base platforms 2026"
報告内容
検索後、次の内容を提示してください。
- 現在の状況:現在人気のあるサポートプラットフォーム/ツール
- 新たなトレンド:注目を集めている新しい AI 機能、パターン、プラットフォーム
- 非推奨/衰退傾向:関連性が薄れつつあるアプローチやツール
- 推奨事項:固定的な知識だけでなく、最新データに基づく推奨
ウェブ検索が利用できない場合は、その制約を明記し、可能な範囲で静的な情報に基づいて案内してください。
トピック例(最新の検索で確認)
- ヘルプセンタープラットフォーム(Zendesk、Intercom、Freshdesk)
- AI サポートエージェント(Fin AI、Ada、Forethought)
- ナレッジベースツール(Document360、GitBook、Notion)
- アプリ内ガイダンス(UserPilot、Pendo、Chameleon)
- セルフサービス AI 機能と解決率
- サポート向けセマンティック検索と RAG