关于 FAQ Builder
FAQ Builder 是用于创建和维护客户常见问题内容的技能,面向支持与内容团队。它能从工单、文档和客户互动中发现问题,并通过分类、撰写、维护和数据分析完善 FAQ。
主要功能
- 01从工单和搜索中发现问题
- 02设计 FAQ 分类层级
- 03撰写清晰的问答内容
- 04按产品变化维护 FAQ
- 05分析效果并优化内容
- 06提供 FAQ 模板与检查项
适用场景
- 01将支持工单整理为 FAQ
- 02从产品文档生成问答
- 03审查 FAQ 覆盖和时效
- 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:发现问题
挖掘支持数据,找出客户实际提出的问题
-
支持工单分析
- 导出近期工单(建议覆盖 90 天)
- 按主题/功能领域分类
- 找出重复出现的问题(出现 3 次以上)
- 记录客户使用的原话
- 跟踪问题频率和趋势
-
搜索查询挖掘
- 分析帮助中心的搜索查询
- 找出零结果搜索(没有答案的问题)
- 跟踪最常见的搜索词
- 记录搜索失败模式
- 将搜索查询与现有内容缺口对应起来
-
客户互动来源
- 实时聊天记录
- 社区论坛帖子
- 社交媒体提及
- 销售电话中的异议
- 入门引导电话中的问题
- NPS/CSAT 调查评论
-
内部知识来源
- 支持团队的经验知识
- 销售 FAQ 文档
- 产品文档缺口
- 工程团队已知问题
- 功能发布说明
工作流 2:设计 FAQ 结构
将问题组织成逻辑清晰、便于浏览的层级结构
-
分类体系
- 快速入门:账户设置、入门步骤、基本概念
- 功能与使用:如何使用特定功能
- 计费与付款:定价、发票、升级
- 账户管理:设置、安全、数据
- 故障排除:常见问题及解决方法
- 集成:第三方连接
-
问题层级
- 顶级分类(最多 5–8 个)
- 子分类(每个分类 3–7 个)
- 具体问题(每个子分类 5–15 个)
- 链接相关问题
-
导航设计
- 搜索功能(主要方式)
- 按分类浏览(次要方式)
- 热门问题版块
- 最近更新版块
- 上下文相关 FAQ(在应用内展示)
工作流 3:撰写答案
撰写清晰、有帮助的答案,解决用户的问题
-
答案结构模板
[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 -
写作指南
- 开门见山地给出答案(不要铺垫)
- 使用客户的语言,而非内部行话
- 让答案便于快速浏览(使用项目符号和标题)
- 对复杂流程配上可视化内容
- 提供具体示例
- 链接到详细文档,供读者深入了解
-
答案质量检查清单
- 在第一句话中直接回答问题
- 使用客户常用的表达
- 包含必要的步骤/操作
- 流程复杂时提供视觉辅助
- 链接到相关内容
- 提供升级处理途径
- 由非专家进行测试
工作流 4:FAQ 维护
确保内容准确且及时更新
-
更新触发条件
- 产品功能变更
- UI/UX 更新
- 定价变更
- 政策更新
- 出现新的常见问题
- 有人指出答案质量问题
-
审核频率
- 每周:检查过时的截图和步骤
- 每月:查看问题频率数据
- 每季度:全面审核内容
- 发布时:更新受影响的 FAQ
-
质量监控
- 跟踪“这有帮助吗?”反馈
- 监控通过 FAQ 升级处理的比率
- 分析搜索与工单之间的关联
- 查看支持工单中对 FAQ 的引用
-
下线流程
- 归档已弃用功能的 FAQ
- 重定向旧 URL
- 更新交叉引用
- 从搜索索引中移除
工作流 5:FAQ 分析与优化
衡量效果并持续改进
-
关键指标
- 工单拦截率:未创建工单的访客占比
- 搜索成功率:通过搜索找到答案的用户占比
- 有帮助评分:标记为有帮助的内容占比
- 页面停留时间:参与度指标
- 转到工单的退出率:未能解决问题的 FAQ 占比
-
优化措施
- 有帮助评分低 → 重写答案
- 转到工单的退出率高 → 答案不完整
- 浏览量低但工单量高 → 内容发现问题
- 搜索无结果 → 内容缺口
- 搜索量高但点击量低 → 标题与描述不匹配
-
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 个
- 大多数热门问题应最多点击两次即可找到
- 为相关问题添加交叉链接
- 使用一致的命名规范
- 启用强大的搜索功能
维护
- 为每个 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:没有导航路径可以找到内容
集成点
- 支持工单:在创建工单前自动推荐常见问题
- 聊天机器人:将常见问题作为一线回复来源
- 应用内帮助:提供上下文相关的常见问题小组件
- 搜索:统一搜索常见问题和文档
- 分析:跟踪问题拦截率和互动情况
- CMS:结构化内容管理
评论
支持 Markdown