知识库(Knowledge Base)是一个结构化内容的自助服务库,帮助用户在不联系支持的情况下找到答案。该技能覆盖知识库的完整生命周期:设计符合用户思维的信息架构、撰写便于扫描的文章、优化搜索以便用户一次命中、衡量答复率(deflection)以证明业务价值,以及严格维护内容以保持准确。
用途
当用户需要设计或重构帮助中心/知识库分类法、撰写或改进支持文章(操作指南、故障排除、FAQ、参考)、优化帮助中心搜索(关键词、同义词、元数据、文章标题)、衡量答复率或构建内容健康仪表盘、实现产品内上下文帮助或工具提示文案、构建文章维护工作流或内容审查节奏、按类型创建文章模板,以及审计现有知识库内容缺口或过时内容时,应触发此技能。它不适用于编写内部工程运行手册或操作手册(应使用事件管理技能),也不适用于编写 API 文档或开发者文档(应使用技术写作或开发者体验技能)。
主要能力
- 信息架构设计:顶层分类映射用户目标而非产品功能,建议5-8个顶层分类,每个文章仅归属一个主分类,分类名使用平实语言,避免超过两级嵌套。提供分类法验证测试:让五位未见过该结构的用户寻找特定常见任务,若少于四人找到正确分类则重新设计标签。
- 文章类型与模板:区分操作指南(150-400词)、故障排除(200-600词)、FAQ(每答50-150词)、参考(长度按需,使用锚点链接)和概念文章,并强调大多数文章应为操作指南或故障排除。
- 搜索优化:采用三层关键词策略——标题关键词、同义词(如“reset”对应“forgot”“change”“recover”)、错误字符串(如“Error 403: Forbidden”),并将同义词存入搜索工具的同义词词典。
- 答复率度量:提供公式
Deflection rate = 1 - (tickets opened after KB visit / total KB visits),并列出健康目标:答复率>70%、文章评分>80%正面、失败搜索率<10%、文章后联系点击率<5%、文章过时天数<180天、搜索到点击率>60%。 - 内容维护工作流:每篇文章必须有具名负责人,按文章类型设定审查频率(如频繁变化功能的操作指南每60天、稳定功能每180天、故障排除每90天、参考每60天、FAQ每90天),功能移除时归档而非删除,并可通过脚本标记超过审查阈值的文章。
- 产品内上下文帮助:提供工具提示、内联帮助文本、帮助面板、空状态链接、错误消息链接等模式及实现方式,文案使用第二人称,说明用户能做什么,超过两句话应链接到完整文章。
使用方式
技能激活时,首次回复以🧢表情开头。首次在对话中激活时,运行 ls ~/.claude/skills/ ~/.agent/skills/ ~/.agents/skills/ .claude/skills/ .agent/skills/ .agents/skills/ 2>/dev/null 检查已安装的配套技能,并与本文件 frontmatter 中的 recommended_skills 字段比较。参考资料按需加载:references/article-templates.md 提供操作指南、故障排除、FAQ 和参考文章的现成模板及注释示例。常见任务包括:挖掘90天支持工单并按用户目标打标签以确定分类候选、卡片分类验证、构建层级、映射现有内容;关键词审计工作流包括导出失败搜索、聚类同义词、补充同义词或加入内容待办、重写低点击查询对应的标题;答复率测量需设置会话级跟踪,定义“答复事件”(访问知识库且未在同一会话内点击联系支持或开工单)和“失败事件”(访问知识库并开工单或点击联系支持)。
适用场景
适用于帮助中心架构设计、支持文章撰写与模板化、搜索与自助服务优化、答复率度量与内容健康仪表盘、产品内上下文帮助实现、文章维护与审查节奏建立、知识库内容审计。
限制
资料未提供该技能的具体安装方式、收费模式、支持平台或效果数据。技能内容强调避免按产品功能结构组织内容、避免用散文写操作步骤、避免无同义词词典、避免以页面浏览量衡量成功、避免从不归档旧文章。资料还指出失败搜索数据是最有价值但常被忽视的信号,文章标题应为扫描而非SEO编写,过时内容的高评分会造成虚假健康信号,答复率下降若无会话级跟踪则不可见。