mcpField
F
FAQ Builder

FAQ Builder

github.com/jmsktm文档处理10204 次安装40 周前更新
代码仓库

关于 FAQ Builder

FAQ Builder 是用于创建和维护客户常见问题内容的技能,面向支持与内容团队。它能从工单、文档和客户互动中发现问题,并通过分类、撰写、维护和数据分析完善 FAQ。

主要功能

  1. 01从工单和搜索中发现问题
  2. 02设计 FAQ 分类层级
  3. 03撰写清晰的问答内容
  4. 04按产品变化维护 FAQ
  5. 05分析效果并优化内容
  6. 06提供 FAQ 模板与检查项

适用场景

  1. 01将支持工单整理为 FAQ
  2. 02从产品文档生成问答
  3. 03审查 FAQ 覆盖和时效
  4. 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:发现问题

挖掘支持数据,找出客户实际提出的问题

  1. 支持工单分析

    • 导出近期工单(建议覆盖 90 天)
    • 按主题/功能领域分类
    • 找出重复出现的问题(出现 3 次以上)
    • 记录客户使用的原话
    • 跟踪问题频率和趋势
  2. 搜索查询挖掘

    • 分析帮助中心的搜索查询
    • 找出零结果搜索(没有答案的问题)
    • 跟踪最常见的搜索词
    • 记录搜索失败模式
    • 将搜索查询与现有内容缺口对应起来
  3. 客户互动来源

    • 实时聊天记录
    • 社区论坛帖子
    • 社交媒体提及
    • 销售电话中的异议
    • 入门引导电话中的问题
    • NPS/CSAT 调查评论
  4. 内部知识来源

    • 支持团队的经验知识
    • 销售 FAQ 文档
    • 产品文档缺口
    • 工程团队已知问题
    • 功能发布说明
工作流 2:设计 FAQ 结构

将问题组织成逻辑清晰、便于浏览的层级结构

  1. 分类体系

    • 快速入门:账户设置、入门步骤、基本概念
    • 功能与使用:如何使用特定功能
    • 计费与付款:定价、发票、升级
    • 账户管理:设置、安全、数据
    • 故障排除:常见问题及解决方法
    • 集成:第三方连接
  2. 问题层级

    • 顶级分类(最多 5–8 个)
    • 子分类(每个分类 3–7 个)
    • 具体问题(每个子分类 5–15 个)
    • 链接相关问题
  3. 导航设计

    • 搜索功能(主要方式)
    • 按分类浏览(次要方式)
    • 热门问题版块
    • 最近更新版块
    • 上下文相关 FAQ(在应用内展示)
工作流 3:撰写答案

撰写清晰、有帮助的答案,解决用户的问题

  1. 答案结构模板

    [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
    
  2. 写作指南

    • 开门见山地给出答案(不要铺垫)
    • 使用客户的语言,而非内部行话
    • 让答案便于快速浏览(使用项目符号和标题)
    • 对复杂流程配上可视化内容
    • 提供具体示例
    • 链接到详细文档,供读者深入了解
  3. 答案质量检查清单

    • 在第一句话中直接回答问题
    • 使用客户常用的表达
    • 包含必要的步骤/操作
    • 流程复杂时提供视觉辅助
    • 链接到相关内容
    • 提供升级处理途径
    • 由非专家进行测试
工作流 4:FAQ 维护

确保内容准确且及时更新

  1. 更新触发条件

    • 产品功能变更
    • UI/UX 更新
    • 定价变更
    • 政策更新
    • 出现新的常见问题
    • 有人指出答案质量问题
  2. 审核频率

    • 每周:检查过时的截图和步骤
    • 每月:查看问题频率数据
    • 每季度:全面审核内容
    • 发布时:更新受影响的 FAQ
  3. 质量监控

    • 跟踪“这有帮助吗?”反馈
    • 监控通过 FAQ 升级处理的比率
    • 分析搜索与工单之间的关联
    • 查看支持工单中对 FAQ 的引用
  4. 下线流程

    • 归档已弃用功能的 FAQ
    • 重定向旧 URL
    • 更新交叉引用
    • 从搜索索引中移除
工作流 5:FAQ 分析与优化

衡量效果并持续改进

  1. 关键指标

    • 工单拦截率:未创建工单的访客占比
    • 搜索成功率:通过搜索找到答案的用户占比
    • 有帮助评分:标记为有帮助的内容占比
    • 页面停留时间:参与度指标
    • 转到工单的退出率:未能解决问题的 FAQ 占比
  2. 优化措施

    • 有帮助评分低 → 重写答案
    • 转到工单的退出率高 → 答案不完整
    • 浏览量低但工单量高 → 内容发现问题
    • 搜索无结果 → 内容缺口
    • 搜索量高但点击量低 → 标题与描述不匹配
  3. 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