好消息：你的 AI 助手已经了解你的图标套件
内容提要
Font Awesome 推出面向 AI 编码代理的官方工具，解决代理选图标时猜测类名或推荐付费图标的问题。其 GraphQL API 支持代理自动查询图标信息，CLI 工具提供搜索、下载 Kit 及授权功能，官方 Skills 可在 Claude Code、Cursor 等代理中直接安装使用，实现按账户权限准确获取图标。
延伸解读
从猜测到精准：AI 代理选图标方式的转变
以往 AI 编码代理在选图标时，常靠猜测类名或推荐付费图标，导致结果不准确。Font Awesome 推出的官方工具让代理能直接查询账户权限内的图标，基于实际账户返回准确结果，避免了猜测和越权推荐。
GraphQL API 与 CLI：代理获取图标的两层支撑
GraphQL API 提供自描述接口，代理可自动发现图标家族、样式和版本；公开元数据无需登录，账户相关数据需令牌。CLI 封装 API，处理授权，返回干净 JSON，适合构建脚本，并支持搜索 Kit 子集、自定义图标及下载 Kit。
官方 Skills：让代理无缝集成图标工作流
Font Awesome 官方 Skills 包含 /setup-fa、/suggest-icon、/add-icon 和 /fa-help 四个命令，可直接安装到 Claude Code、Cursor、GitHub Copilot、Windsurf 等代理中。安装后，代理能自动调用 CLI 功能，实现 Kit 子集搜索、自定义图标和自托管设置，无需切换上下文。
安全与权限：令牌管理及账户隔离
CLI 将登录凭证存储在操作系统钥匙串中，避免向代理暴露明文令牌。代理通过 CLI 访问账户时，只能获取账户有权限的图标，包括 Kit 子集和自定义图标，确保了权限隔离和安全性。
Q&A
Font Awesome 为 AI 编码代理推出了哪些官方工具？
Font Awesome 推出了 GraphQL API、fa CLI 和官方 Skills（包括 /setup-fa、/suggest-icon、/add-icon、/fa-help），这些工具让 AI 代理能够直接查询和获取图标。
AI 代理如何通过 Font Awesome 的 GraphQL API 获取图标信息？
GraphQL API 是自文档化的，代理可以直接指向 api.fontawesome.com，自动了解如何获取图标家族、样式和版本等信息。公开元数据无需登录，但访问账户相关的 Kits 和自定义图标需要访问令牌。
fa CLI 有哪些主要功能？
fa CLI 是 GraphQL API 的封装，提供常见查询的子命令，并处理授权。它可以搜索 Kit 子集（包括自定义图标）、下载和解压完整 Kit 用于自托管，还能运行自定义 GraphQL 查询，所有命令返回干净的 JSON。
如何安装 Font Awesome 的官方 Skills？
可以通过运行 npx skills add FortAwesome/fontawesome-agent-tools 来安装官方 Skills，它们支持 Claude Code、Cursor、GitHub Copilot、Windsurf 等编码代理。
使用 Font Awesome 的 AI 代理工具需要哪些前置步骤？
需要安装 CLI 和代理工具，然后登录一次（fa login）。之后代理会自动在 PATH 中查找 fa，并继承 CLI 的所有功能，如 Kit 子集搜索、自定义图标和自托管设置。
Font Awesome 的 AI 代理工具如何确保图标访问权限的准确性？
工具基于账户权限工作：GraphQL API 和 CLI 使用访问令牌来访问账户相关的 Kits 和自定义图标，搜索可以限定到 Kit 令牌，只返回该 Kit 子集中的图标，避免推荐无权限的图标。
