需要为某个情境、名词、动词或概念推荐 Font…

为具体 use case 选择合适 Font Awesome 图标，并确保图标存在且在项目 Kit 中可用。

适用场景

解决思路

1. 所有脚本路径相对于此技能目录（`plugins/icons/skills/suggest-icon/`），应从该目录运行。
2. 先用自身对 Font Awesome 图标的知识做快速初猜，但因版本不同可能不准，需叠加多个信息源验证。
3. 开始时运行 `command -v fa` 检查 `fa` CLI 是否在 PATH 中。
4. `fa kit` 子命令要求 `fa` 版本 0.8.0 或更新；若需要 `fa kit`，按 https://docs.fontawesome.com/web/use-with/fa-cli 建议用户升级 `fa`。
5. 若找到 `fa`：用它进行图标查找和搜索（返回结构化 JSON）。若项目配置了 Kit，还用 `fa search --kit-token <TOKEN>` 仅搜索 Kit 中可用图标，并用 `fa kit icon` 确认特定图标已包含。
6. 对 `fa kit ...` 操作，先检查认证（`fa whoami` 或 `FA_API_TOKEN`）；若无法认证，回退到未限定范围的搜索，并警告用户无法验证 Kit 覆盖。
7. 若未找到 `fa`：回退到 Python 脚本。Kit 感知搜索需要 `fa` CLI；没有它无法把建议限定到 Kit 子集，警告用户建议可能包含其 Kit 没有的图标。
8. 用 `latest-version.py` 获取最新版本。
9. 若项目有 `.font-awesome.md` 文件且记录 **Kit ID**（kit token），用户的图标来自该 Kit，而 Kit 只包含所有 Font Awesome 图标的子集；不要建议 Kit 不包含的图标，否则会导致破损、不渲染的结果。
10. 存在 Kit token 时，把每个建议限定到 Kit：用 `fa search --kit-token <TOKEN> --query <your-guess>` 而不是 `fa search --version <version> ...`。这样只返回 Kit 中实际可用的图标（截至 Kit 的子集），因此每个结果都可安全推荐。
11. 在展示主要推荐前，用 `fa kit icon --kit-token <TOKEN> <icon>` 确认；它会告知该图标是否在 Kit 中，以及有哪些 family-styles 可用。
12. 若最想推荐的图标不在 Kit 中，明确说明，改为推荐最接近的 Kit 可用替代项，并告知用户可在 https://fontawesome.com/kits 把缺失图标加入 Kit（之后即可用）。
13. 若不存在 `.font-awesome.md` 或其中未记录 Kit，则照常从完整图标集建议。
14. 确定版本：若用户指定 Font Awesome 版本，使用该版本；否则使用最新版本（见工具选择）。后续所有步骤使用解析出的版本。
15. 同时检查项目根目录的 `.font-awesome.md`；若记录 **Kit ID**（kit token），保留备用——将搜索和建议限定到 Kit（见「尊重已配置的 Kit」）。
16. 进行初步猜测：基于你的知识，选择你认为最符合 use case 参数的图标名。
17. 验证图标是否存在：`fa` CLI 运行 `fa icons --version <version> --name <your-guess>`；若 `data.release.icon` 非空则存在，`familyStylesByLicense` 字段显示 free/pro 明细。
18. 回退验证：运行 `./scripts/icon-exists.py --version <version> --icon-name <your-guess>`；退出码 `0` 表示存在，退出码 `1` 表示不存在。
19. 若配置了 Kit token，还用 `fa kit icon --kit-token <TOKEN> <your-guess>` 确认 Kit 成员资格。图标可在 Font Awesome 中存在但仍不在 Kit 子集中——若不在 Kit，不要按原样推荐（见步骤 5）。
20. 搜索替代项：无论初步猜测是否存在都要做——搜索常会发现更具体或更合适的图标。
21. 配置 Kit（`fa` CLI）时：运行 `fa search --kit-token <TOKEN> --query <your-guess> --page-size 10`。它只返回 Kit 中可用的图标，因此每个结果都安全。存在 Kit token 时优先使用。
22. 无 Kit（`fa` CLI）时：运行 `fa search --version <version> --query <your-guess> --page-size 10`。结果位于 `data.searchPaginated.icons[]`，每项含 `id`、`label`、`unicode` 和 `familyStylesByLicense`。
23. 回退搜索：运行 `./scripts/search.py --version <version> --query <your-guess>`，从 Font Awesome GraphQL API 查找相关图标。（它无法限定到 Kit 子集。）
24. 展示推荐：选择最佳匹配作为主要推荐；若搜索发现其他好选项，包含相关替代项。
25. 若配置 Kit，每个推荐都必须是 Kit 包含的图标；若最佳概念匹配不在 Kit，改为推荐最接近的 Kit 可用替代，并说明缺失图标可在 https://fontawesome.com/kits 加入 Kit。
26. 使用 markdown 表格展示，例如：`| Icon | Families | Availability |` 和 `| mug-saucer | classic, sharp, duotone, sharp-duotone | Free |`。
27. 若图标仅 Pro，注明需要 Font Awesome 订阅，例如：`| album-collection | classic, sharp, duotone, sharp-duotone | Pro (requires a [subscription](https://fontawesome.com/plans)) |`。
28. 绝不提供裸 SVG 标记：若用户要求原始 `<svg>` 输出，不要根据自身知识生成；改为引导用户使用 `/add-icon`，它可通过 `fa icons --svg-format` 从 Font Awesome API 获取权威 SVG 标记。
29. 主动提出添加图标：展示推荐后询问用户「Would you like me to add this icon to your code?」。若用户同意或提供位置，使用推荐的图标名（以及位置，若给出）调用 `/add-icon`。

适用边界 · 注意事项

• 不适用于不使用 Font Awesome 的项目，或无法访问 Font Awesome API/CLI 的场景。
• 不适用于用户要求直接生成裸 `<svg>` 标记的请求；应改用 `/add-icon` 获取权威 SVG。
• 不适用于无法接受 Font Awesome Kit/订阅依赖且需要完全开源、无厂商约束图标方案的场景。