SuperAPI AI 工具集

fa-help

编程与开发

查看项目

更新于 10-15 15:33

技能介绍

用途

fa-help 用于回答关于 Font Awesome 的问题。它的核心思路是:不依赖可能过时的训练数据,而是抓取并引用官方文档,让答案建立在权威、版本准确的内容之上。

主要能力

  • 从官方文档源获取内容。Font Awesome 在 https://docs.fontawesome.com 发布了对 LLM 友好的文档,索引位于 /llms.txt,列出所有可用页面。每个页面都是自包含的 Markdown 文件,包含标题、表格和代码示例。
  • 定位相关页面。根据用户问题扫描 llms.txt 索引,找到最相关的文档 URL。这些 URL 以 .md 结尾,路径结构具有描述性(例如 /web/setup/use-kit.md、/web/style/animate.md、/web/use-with/react/troubleshoot.md)。大多数问题对应一到两个页面;如果问题跨主题,优先选择最具体的页面。
  • 抓取文档页面。抓取上一步确定的 Markdown 页面,优先抓取最具体的页面。如果答案需要第二个页面的上下文,也可以抓取,但每个问题最多三个页面。
  • 综合答案。以抓取到的文档为主要来源,直接简洁地回答用户问题,包含文档中的相关代码示例(尽可能适配用户上下文)。如果用户项目中有 .font-awesome.md 文件,则根据其具体集成方式、版本和许可证来定制答案。如果文档描述了多种方法,推荐最适合用户项目的一种。
  • 引用来源。在答案末尾附上所引用文档页面的链接,将 .md URL 去掉 .md 扩展名转换为网页 URL。
  • 推荐相关技能。如果答案自然引向用户可以采取的操作,则推荐相关技能:询问如何添加图标时推荐 /add-icon;询问如何设置 Font Awesome 时推荐 /setup-fa;寻找合适图标时推荐 /suggest-icon。

使用方式

该技能通过抓取官方文档来回答问题。具体步骤包括:抓取文档索引、识别相关页面、抓取文档页面、综合答案、引用来源、推荐相关技能。抓取时使用 WebFetch,并配合相应提示词以获取完整内容。

适用场景

适用于用户提出关于 Font Awesome 的问题,例如如何添加图标、如何设置 Font Awesome、如何寻找合适图标、特定集成方式(如 React)的用法或故障排除等。

限制

  • 绝不提供裸 SVG 标记。如果用户要求 Font Awesome 图标的原始 <svg> 输出,不要凭自身知识或训练数据生成,而应引导用户使用 /add-icon,它可以从 Font Awesome API 获取权威的 SVG 标记。
  • 始终抓取文档。不要仅凭记忆回答,文档是权威来源,可能包含与训练数据不同的 v7 特定信息。
  • 保持在范围内。该技能回答关于 Font Awesome 的问题。如果问题涉及通用 CSS、JavaScript 或与 Font Awesome 无关的框架,应说明并简要回答,不抓取文档。
  • 诚实面对空白。如果文档未覆盖用户问题,应如实说明,不要编造答案。
  • 尊重用户的集成方式。如果存在 .font-awesome.md,应针对其设置定制示例,而不是展示通用代码。