SuperAPI AI 工具集

suggest-icon

设计与创作

查看项目

更新于 10-15 21:46

技能介绍

用途:根据用户给出的情境、名词、动词或概念,推荐合适的 Font Awesome 图标,并给出可用的替代选项。

主要能力:先用自身知识做初步猜测,再通过多来源验证,避免因版本差异导致不准确。可检查图标是否存在、搜索相关图标、查看图标所属家族与免费/专业版可用性,并在项目配置了 Kit 时把推荐范围限定在 Kit 子集内。

使用方式:脚本路径相对于本技能目录 plugins/icons/skills/suggest-icon/。开始时运行 command -v fa 检查 fa CLI 是否在 PATH 中。若存在,用 fa 做图标查询与搜索(返回结构化 JSON);若项目配置了 Kit,用 fa search --kit-token <TOKEN> 限定搜索,并用 fa kit icon 确认图标是否包含。fa kit 子命令需要 fa 0.8.0 或更新版本,升级说明见 https://docs.fontawesome.com/web/use-with/fa-cli。若未找到 fa,则回退到 Python 脚本,但 Kit 感知搜索需要 fa CLI。用 latest-version.py 获取最新版本。

Kit 处理:若项目根目录有 .font-awesome.md 且记录了 Kit ID(kit token),图标来自该 Kit,而 Kit 只包含全部图标的一个子集。不要推荐 Kit 中不存在的图标。搜索用 fa search --kit-token <TOKEN> --query <your-guess>,主推荐前用 fa kit icon --kit-token <TOKEN> <icon> 确认。若最想推荐的图标不在 Kit 中,应明确说明,改推荐最接近的 Kit 内替代,并提示可在 https://fontawesome.com/kits 添加。若无 .font-awesome.md 或未记录 Kit,则从完整图标集推荐。

步骤:确定版本(用户指定则用指定版本,否则用最新版);检查 .font-awesome.md 中的 Kit ID;做初步猜测;验证图标是否存在(fa icons --version <version> --name <your-guess>,或回退 ./scripts/icon-exists.py --version <version> --icon-name <your-guess>);搜索替代(fa search --version <version> --query <your-guess> --page-size 10,或回退 ./scripts/search.py --version <version> --query <your-guess>);用 markdown 表格呈现推荐,列出图标、家族、可用性,专业版需注明需要订阅;最后询问是否将图标加入代码,若同意则调用 /add-icon。

限制:不要提供裸 SVG 标记;若用户要求原始 <svg> 输出,应引导使用 /add-icon,通过 fa icons --svg-format 从 Font Awesome API 获取权威 SVG。无 fa CLI 时无法按 Kit 子集限定推荐,需警告用户建议可能包含其 Kit 中没有的图标。