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. 03为 AI 客服设计 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+/客服人员复杂工作流、合规要求
成长期/SaaSIntercom$29/席位 + $0.99/次解决对话式支持、PLG
SMB/初创公司Freshdesk$29-69/客服人员预算友好、原生 AI
面向开发者GitBook/Notion$0-20/用户文档即代码

有关设置/迁移说明,请参阅 references/platform-guides.md;有关精选对比来源,请参阅 data/sources.json。

2025-2026 年最佳实践

关键转变
方面传统方式(2024 年以前)现代方式(2025-2026 年)
支持模式独立帮助门户嵌入应用内的帮助
AI 角色搜索助手更高程度的自动化,并安全升级
搜索关键词匹配语义搜索 + RAG
内容以文字为主的文章视觉优先(视频、GIF、截图)
个性化对所有用户一视同仁根据角色、版本和行为定制
维护手动整理AI 驱动的内容时效性检测
导航按类别浏览对话式 + 情境化

未经核实,请勿引用确切统计数据;需要时请通过 data/sources.json 更新趋势和基准数据。

AI 优先原则
  1. Agent 式解决问题 — AI 执行任务(退款、预订、更新),而不仅仅是回答问题
  2. 语义理解 — 基于意图的搜索,而不是关键词匹配
  3. 主动协助 — 在用户提出请求前主动提供帮助
  4. 内容时效性 — 自动检测过时内容并建议更新
  5. 多源综合 — 从文档、工单、Slack、发布说明中提取信息
  6. 丰富记忆的 AI — 保留跨会话上下文,提供个性化支持
新兴趋势(2026)
趋势描述影响
语音搜索用户通过语音而非输入来查找信息需要采用自然语言撰写知识库内容
主动式 AIAI 在用户报告问题前检测并解决问题减少流入的支持请求
嵌入式帮助帮助内容在上下文中显示,而非作为独立门户提高参与度,降低使用门槛
AI 运营负责人负责监督 AI Agent 行为的新职位工作重心从执行转向监督
缓解幻觉使用 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 个步骤
  • 故障排查:症状 -> 原因 -> 解决方案
  • 常见问题:快速解答,并附上指向更深入文档的链接
  • 概念说明:解释术语和思维模型
  • 参考资料:精确规格(表格、限制、错误代码)

请使用 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)
Agent 式 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

请参阅 references/ai-integration.md,了解 RAG 设置、评估和升级模式。

指标与 KPI

核心指标
指标定义基准
自助服务率无需客服 Agent 介入即可解决的问题占比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.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.json精选来源及其 add_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 支持 Agent(Fin AI、Ada、Forethought)
  • 知识库工具(Document360、GitBook、Notion)
  • 应用内引导(UserPilot、Pendo、Chameleon)
  • 自助服务 AI 功能和解决率
  • 面向支持场景的语义搜索和 RAG

评论

支持 Markdown