关于 faq-page
用于生成单页 FAQ 的 skill,包含可搜索和分类筛选的折叠问答,并指导内容编写、页面结构与可访问性检查。
主要功能
- 01实时搜索问题与答案
- 02按类别筛选条目
- 03创建可折叠 FAQ 分区
- 04检查键盘与移动端可用性
适用场景
- 01制作产品帮助或支持页面
- 02整理账单与账户类 FAQ
- 03根据简短需求创建响应式 FAQ
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nexu-io/ open-design --skill faq-page安装后在 Claude Code 中输入/faq-page确认已加载。
附带文件example.html
详细介绍
FAQ 页面技能
生成一个包含可折叠手风琴分区、搜索和类别筛选的单页 FAQ。
工作流
- 阅读当前生效的 DESIGN.md(已在上方注入)。为交互元素(手风琴标题、搜索输入框、类别标签)使用组件令牌。
- 根据简述选择领域(例如 SaaS 产品、电子商务、服务),并围绕 3–4 个类别编写 12–18 条真实的 FAQ。
- 边缘情况:
- 如果简述提供的 FAQ 少于 8 条,请索要更多内容,或根据领域生成合理的问题。
- 如果只有 1–5 条 FAQ,则跳过类别和搜索,显示简单列表。
- 对于很长的回答(超过 100 个词),请拆分成段落或项目符号,以提高可读性。
- 边缘情况:
- 按以下顺序排列各部分:
- 页眉——页面标题(“常见问题”或“帮助中心”),可选副标题(用 1 句话说明用户可以在此找到什么)。
- 搜索栏——醒目的搜索输入框,带占位文本和图标。使用功能性 JS 实时筛选问题。
- 类别筛选器——3–4 个胶囊样式按钮,用于按类别筛选(例如“账单”“账户”“技术”“常见问题”)。默认选中“全部”。
- FAQ 手风琴——可折叠的问题与答案:
- 问题以可点击的标题呈现,并带有展开/折叠图标(箭头或加号/减号)。
- 默认隐藏答案,点击后以平滑动画展开。
- 每个条目都带有用于筛选的
data-category属性。
- 页脚 CTA——“还有问题?”区域,带有联系链接或支持邮箱。
- 编写单个 HTML 文档:
- 从
<!doctype html>到</html>,CSS 和 JS 均内联。 - 手风琴使用语义化 HTML(通过
<details>和<summary>实现渐进增强,或使用带有正确 ARIA 属性的自定义 JS)。 - 搜索会根据问题或答案中的匹配文本进行筛选。
- 类别筛选器会根据
data-category显示或隐藏问题。 - 展开/折叠使用平滑过渡(max-height 或 grid-template-rows)。
- 在页眉、搜索栏、类别筛选器、手风琴容器和页脚上添加
data-od-id。
- 从
- 自检:
- 问题具体且真实,不使用通用占位内容。
- 答案简洁(2–4 句话)但完整。
- 支持键盘导航(通过 Tab 在问题间切换,按 Enter 展开)。
- 搜索不区分大小写,并根据匹配文本进行筛选。
- 任意时刻只展开一个手风琴条目(可选,取决于 UX 偏好)。
- 适配移动设备(手风琴标题易于点击,搜索易于使用)。
输出约定
在 <artifact> 标签之间输出:
<artifact identifier="faq-page" type="text/html" title="FAQ Page">
<!doctype html>
<html>...</html>
</artifact>
在 artifact 前输出一个句子,之后不输出任何内容。
按类别划分的问题示例
账单
- 如何更新付款方式?
- 你们接受哪些付款方式?
- 可以退款吗?
- 如何取消订阅?
账户
- 如何重置密码?
- 可以更改电子邮箱地址吗?
- 如何删除账户?
- 取消后我的数据会怎样?
技术
- 你们支持哪些浏览器?
- 有移动应用吗?
- 如何导出数据?
- API 的速率限制是多少?
常见问题
- [Product Name] 是什么?
- 如何开始使用?
- 你们提供客户支持吗?
- 在哪里可以查看服务条款?
评论
支持 Markdown