mcpField
F
fa-help

fa-help

github.com/fortawesome开发4511 次安装17 周前更新
代码仓库

关于 fa-help

基于文档回答 Font Awesome 问题的技能。它会查找并获取相关官方页面,整理答案并引用来源,而非依赖可能过时的训练数据。

主要功能

  1. 01检索文档索引
  2. 02获取相关官方页面
  3. 03依据当前文档整理答案
  4. 04引用文档来源
  5. 05推荐相关技能

适用场景

  1. 01解答 Font Awesome 集成问题
  2. 02查询图标功能的使用方法
  3. 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 文件,包含标题、表格和代码示例。

步骤

  1. 获取文档索引。 使用 WebFetch 获取 https://docs.fontawesome.com/llms.txt。此文件列出了所有可用的文档页面及其 URL 和简短说明。可以使用类似这样的提示词:“请逐字返回此文件的完整内容。我需要查看每个 URL 及其说明。”

  2. 确定相关页面。 阅读用户的问题,并浏览 llms.txt 索引,找到最相关的文档 URL。URL 以 .md 结尾,路径结构具有描述性(例如,/web/setup/use-kit.md、/web/style/animate.md、/web/use-with/react/troubleshoot.md)。大多数问题对应一两个页面。如果问题涉及多个主题,优先选择最具体的页面。

  3. 获取文档页面。 使用 WebFetch 获取上一步确定的相关 Markdown 页面。先获取最具体的页面。如果回答需要第二个页面中的上下文,也获取该页面,但每个问题最多限于三个页面。

    获取文档时,可以使用类似这样的提示词:“请以 Markdown 格式返回此文档页面的完整内容。保留所有标题、代码块和表格。”

  4. 综合回答。 以获取的文档为主要依据:

    • 直接、简洁地回答用户的问题。
    • 包含文档中的相关代码示例,并尽可能根据用户的使用场景进行调整。
    • 如果用户的项目中有 .font-awesome.md 文件,请根据其具体集成方式、版本和许可证定制回答。
    • 如果文档介绍了多种方法,请推荐最适合用户项目的方法。
  5. 引用来源。 在回答末尾附上所引用文档页面的链接,方便用户了解更多信息。将 .md URL 转换为网页 URL,方法是移除 .md 扩展名。例如:

    来源:使用 Kit

  6. 推荐相关技能。 如果问题自然地引出用户可以采取的操作,请推荐相关技能:

    • 如果用户询问如何添加图标 → 推荐 /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,请根据用户的设置定制示例,而不是提供通用代码。

评论

支持 Markdown