help-center-article-generator

ヘルプセンター記事ジェネレーター

サポートチケットをセルフサービスで解決できる回答に変換します。繰り返し寄せられる質問、機能ドキュメント、製品仕様をもとに、チケット数を減らすヘルプセンター記事を生成します。

対象： 同じ20件の質問がサポートチケットの80％を占めている一方、ヘルプ記事を書く時間がないアーリーステージのチーム。目標は、ある午後に記事をまとめて生成し、その後数か月にわたってチケットを削減することです。

使用するタイミング

• 「よくあるサポートの質問について、ヘルプセンター記事を書いて」
• 「これらのサポートチケットをFAQ記事にして」
• 「［機能］のドキュメントを生成して」
• 「ナレッジベースを充実させて」
• 「サポート件数が多すぎます。セルフサービスコンテンツの作成を手伝ってください」

フェーズ0：インテーク

コンテンツソース（いずれか、またはすべてを提供）

1. サポートチケットのエクスポート — 最近のチケットのCSVまたは一覧（件名、説明、解決方法）。このスキルで内容をクラスタリングし、繰り返し発生する主なトピックを特定します。
2. FAQ一覧 — よくある質問がすでにわかっている場合は、そのまま提供してください。
3. 機能ドキュメント — 顧客向け記事が必要な機能の社内ドキュメント、PRD、仕様書。
4. 製品の操作手順 — ワークフローを手順ごとに説明すると、このスキルが記事を生成します。
5. 改善したい既存の記事 — 書き直しが必要な現在のヘルプ記事のURLまたはテキスト。

設定

6. 製品名 — 製品名を教えてください。
7. 対象読者 — この記事を読むのは誰ですか？（技術者、非技術者、混在）
8. トーン — カジュアルで親しみやすい、プロフェッショナル、技術的／開発者向けドキュメントのようなトーン？
9. 記事構成の希望：
   • 標準 — 概要 → 手順 → トラブルシューティング → 関連記事
   • 開発者向け — 概要 → API リファレンス → コード例 → エラー
   • クイックスタート — 概要 → 理由 → 方法（最大3ステップ）→ 次のステップ
10. スクリーンショットのルール — スクリーンショットを使いますか？（このスキルは [Screenshot: description] のプレースホルダーを挿入します）
11. 一括生成か単体生成か？ — 1つの記事を作成しますか、それともチケットのエクスポートから複数の記事を生成しますか？

フェーズ1：トピックのクラスタリング（一括モード）

チケットのエクスポートが提供された場合は、チケットを記事のトピックごとにクラスタリングします。

クラスタリングの方法

1. 類似性でグループ化 — 件名や説明が似ているチケットをクラスタリングします
2. 頻度で順位付け — 最も多いクラスターを、優先度の高い記事とします
3. クラスターごとに記事の種類を特定します：

種類	使用するタイミング	例
操作方法	「Xのやり方は？」	「メール連携の設定方法」
トラブルシューティング	「Xが動作しない」	「解決方法：メールが送信されない」
概念／概要	「Xとは？」	「料金プランについて」
リファレンス	「Xにはどのような選択肢がある？」	「API のレート制限とクォータ」
利用開始	初回設定	「クイックスタート：最初のキャンペーン」

クラスターの出力

TOPIC CLUSTERS (ranked by ticket frequency):

1. [Topic] — [N tickets] — Type: [How-to]
   Common phrasing: "[How customers ask this question]"
   Resolution pattern: [What support typically tells them]

2. [Topic] — [N tickets] — Type: [Troubleshooting]
   ...

3. ...

フェーズ2：記事の生成

記事テンプレート — 操作方法

# [Action-oriented title — e.g., "How to Set Up Email Integration"]

[1-2 sentence overview: What this article covers and who it's for]

**Time to complete:** [X minutes]
**Prerequisites:** [What they need before starting — e.g., "Admin access, API key"]

---

## Step 1: [Action verb + what to do]

[1-2 sentences explaining this step]

[Screenshot: Description of what the user should see — e.g., "Settings page with Integrations tab highlighted"]

> **Tip:** [Helpful context or shortcut]

## Step 2: [Action verb + what to do]

[Instructions]

[Screenshot: Description]

## Step 3: [Action verb + what to do]

[Instructions]

---

## Verify It Worked

[How to confirm the setup was successful]

[Screenshot: Description of success state]

---

## Troubleshooting

### [Common problem 1]
**Symptom:** [What the user sees]
**Cause:** [Why this happens]
**Fix:** [Step-by-step resolution]

### [Common problem 2]
**Symptom:** [...]
**Cause:** [...]
**Fix:** [...]

---

## FAQ

**Q: [Common follow-up question]**
A: [Answer]

**Q: [Another common question]**
A: [Answer]

---

## Related Articles

- [[Article title]] — [1-line description of when to read it]
- [[Article title]] — [...]

記事テンプレート — トラブルシューティング

# Fix: [Problem description — e.g., "Emails Not Sending"]

[1-2 sentences: When you'd encounter this problem]

---

## Quick Fix

Try this first (resolves ~80% of cases):

1. [Most common fix — step 1]
2. [Step 2]
3. [Verify]

---

## If That Didn't Work

### Check 1: [First thing to verify]
[How to check + what to look for]

✅ If [expected result] → This isn't the issue. Move to Check 2.
❌ If [unexpected result] → [Specific fix for this case]

### Check 2: [Second thing to verify]
[How to check]

✅ If OK → Move to Check 3.
❌ If not → [Fix]

### Check 3: [Third thing to verify]
[How to check]

✅ If OK → Move to "Still Not Working?"
❌ If not → [Fix]

---

## Still Not Working?

If none of the above resolved your issue:

1. [What information to gather — e.g., "Screenshot of the error message"]
2. [Where to get help — e.g., "Email [email protected] with the above info"]
3. [Expected response time]

---

## Why This Happens

[2-3 sentences explaining the root cause for curious users. Optional but builds trust.]

## Related Articles

- [[Article]] — [Context]

記事テンプレート — 利用開始／クイックスタート

# Getting Started with [Feature/Product]

[1-sentence: What you'll accomplish by the end of this guide]

**Time:** [X minutes] | **Difficulty:** [Beginner/Intermediate]

---

## What You'll Need

- [Prerequisite 1]
- [Prerequisite 2]

---

## Step 1: [First thing to do] (2 min)

[Clear instructions]

[Screenshot: Description]

## Step 2: [Second thing] (3 min)

[Instructions]

## Step 3: [Third thing] (2 min)

[Instructions]

---

## You're All Set! 🎉

[What they can now do]

**Next steps:**
- [Logical next action — link to next article]
- [Power user tip — link to advanced article]
- [Join community — link if applicable]

フェーズ3：記事の品質チェック

生成した記事ごとに、以下を確認します。

• タイトルが行動を促す内容になっている — 「方法」「解決方法：」「利用開始」「理解する」などで始まっている
• ざっと読んで内容を把握できる — 見出し、番号付き手順、重要な用語の太字を使い、長文のかたまりを避けている
• 内容が網羅されている — うまくいく場合だけでなく、ワークフロー全体を扱っている
• トラブルシューティングが含まれている — よくある失敗のシナリオを少なくとも2つ扱っている
• 専門用語を使っていない — 社内用語ではなく、顧客が使う言葉を用いている
• スクリーンショットのプレースホルダーがある — UI を操作する手順すべてにプレースホルダーがある
• 関連記事にリンクしている — ユーザーがヘルプセンター内を移動できるよう、相互参照している
• 検索しやすい — タイトルと最初の段落に、顧客が実際に検索するキーワードが含まれている

フェーズ4：出力

単体記事モード

現在の作業ディレクトリに [article-slug].md として保存します。

一括モード

すべての記事を、現在の作業ディレクトリ内の help-center/ サブディレクトリに保存し、目次として _index.md を作成します。

インデックスのテンプレート

# Help Center — [Product Name]
Generated: [DATE] | Articles: [N]

## Getting Started
- [[getting-started-guide.md]] — First-time setup walkthrough
- [[quick-start.md]] — 5-minute quick start

## How-To Guides
- [[how-to-setup-email.md]] — Set up email integration
- [[how-to-invite-team.md]] — Invite team members
- ...

## Troubleshooting
- [[fix-emails-not-sending.md]] — Emails not sending
- [[fix-login-issues.md]] — Can't log in
- ...

## Reference
- [[api-rate-limits.md]] — API limits and quotas
- [[billing-plans.md]] — Plan comparison and billing FAQ

コスト

コンポーネント	コスト
すべての記事の生成	無料（LLM による推論）
合計	無料

必要なツール

ありません。純粋な推論スキルで、生の入力から構造化された記事を生成します。

トリガーフレーズ

• 「サポートチケットからヘルプセンターの記事を作成して」
• 「[feature] のドキュメントを生成して」
• 「ナレッジベースを充実させて」
• 「よくある質問をヘルプ記事に変換して」
• 「ヘルプセンター記事ジェネレーターを実行して」