关于 fa-help
基于文档回答 Font Awesome 问题的技能。它会查找并获取相关官方页面,整理答案并引用来源,而非依赖可能过时的训练数据。
主要功能
- 01检索文档索引
- 02获取相关官方页面
- 03依据当前文档整理答案
- 04引用文档来源
- 05推荐相关技能
适用场景
- 01解答 Font Awesome 集成问题
- 02查询图标功能的使用方法
- 03查找答案对应的官方资料
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ fortawesome/ fontawesome-agent-tools --skill fa-help安装后在 Claude Code 中输入/fa-help确认已加载。
详细介绍
通过获取并引用官方文档来回答 Font Awesome 问题。此技能以权威且版本准确的内容为依据,而不是依赖可能已经过时的训练数据。
文档来源
Font Awesome 在 https://docs.fontawesome.com 发布了便于大模型使用的文档。/llms.txt 索引列出了所有可用页面。每个页面都是独立的 Markdown 文件,包含标题、表格和代码示例。
步骤
-
获取文档索引。 使用
WebFetch获取https://docs.fontawesome.com/llms.txt。此文件列出了所有可用的文档页面及其 URL 和简短说明。可以使用类似这样的提示词:“请逐字返回此文件的完整内容。我需要查看每个 URL 及其说明。” -
确定相关页面。 阅读用户的问题,并浏览
llms.txt索引,找到最相关的文档 URL。URL 以.md结尾,路径结构具有描述性(例如,/web/setup/use-kit.md、/web/style/animate.md、/web/use-with/react/troubleshoot.md)。大多数问题对应一两个页面。如果问题涉及多个主题,优先选择最具体的页面。 -
获取文档页面。 使用
WebFetch获取上一步确定的相关 Markdown 页面。先获取最具体的页面。如果回答需要第二个页面中的上下文,也获取该页面,但每个问题最多限于三个页面。获取文档时,可以使用类似这样的提示词:“请以 Markdown 格式返回此文档页面的完整内容。保留所有标题、代码块和表格。”
-
综合回答。 以获取的文档为主要依据:
- 直接、简洁地回答用户的问题。
- 包含文档中的相关代码示例,并尽可能根据用户的使用场景进行调整。
- 如果用户的项目中有
.font-awesome.md文件,请根据其具体集成方式、版本和许可证定制回答。 - 如果文档介绍了多种方法,请推荐最适合用户项目的方法。
-
引用来源。 在回答末尾附上所引用文档页面的链接,方便用户了解更多信息。将
.mdURL 转换为网页 URL,方法是移除.md扩展名。例如:来源:使用 Kit
-
推荐相关技能。 如果问题自然地引出用户可以采取的操作,请推荐相关技能:
- 如果用户询问如何添加图标 → 推荐
/add-icon - 如果用户询问如何设置 Font Awesome → 推荐
/setup-fa - 如果用户想找到合适的图标 → 推荐
/suggest-icon
- 如果用户询问如何添加图标 → 推荐
指南
- 绝不提供裸 SVG 标记。 如果用户要求输出 Font Awesome 图标的原始
<svg>,不要根据自身知识或训练数据生成。请引导用户使用/add-icon,以便从 Font Awesome API 获取权威的 SVG 标记。 - 始终获取文档。 不要只凭记忆回答——文档是权威来源,可能包含与训练数据不同的 v7 特定信息。
- 限定回答范围。 此技能用于回答 Font Awesome 相关问题。如果问题涉及与 Font Awesome 无关的通用 CSS、JavaScript 或框架,请说明这一点,并在不获取文档的情况下简要回答。
- 如实说明信息缺口。 如果文档没有涵盖用户的问题,请如实说明。不要编造答案。
- 尊重用户的集成方式。 如果存在
.font-awesome.md,请根据用户的设置定制示例,而不是提供通用代码。