skill-icon-generator

单个 Skill 图标生成器

一次只处理用户指定的一个 Skill。使用本 Skill 自带的脚本、Lucide/品牌母版、 人工映射和 Sharp 运行时；生成前完成品牌判定、语义判断、现有占用排除与感知 相似度检查。

工作流

CREATE A TODO LIST FOR THE TASKS BELOW（每个步骤一个 TODO，并随执行更新状态）：

1. 将用户指定路径规范化为 <target-skill-dir>，将本文件目录记为 <generator-skill-dir>。

2. 完整读取目标 SKILL.md。目标不存在、不是 Skill，或 YAML frontmatter 中 name / description 缺失时，报告原因并停止；不得选图或写文件。

3. 从 name + description 提炼：

   • 主语义：这个 Skill 的任务形态或核心能力，例如 MCP、审查、部署、写作。
   • 次语义：业务对象或领域，例如 Privy、飞书、社媒、市场。
   • 品牌绑定：若 Skill 的名称或核心能力直接绑定一个明确的第三方品牌、 产品或平台，且移除该品牌后任务对象会改变，则标记为品牌绑定型。
   • 品牌绑定型优先表达品牌身份；其他 Skill 必须优先表达主语义，不得只命中 次语义关键词。

4. 检查目标现有 assets/icon.svg / icon.png：

   • 已存在且用户未明确要求替换：报告现有资产并停止。
   • 用户明确要求替换：后续生成命令使用 --force。

5. 读取 assets/brand-registry.json、assets/curated-specs.json 和 --list-icons 输出。若目标名称命中品牌注册表，采用注册表中唯一的品牌 Logo 与官方主色；同品牌已有映射时直接复用。非品牌候选再排除：

   • 已被其他 Skill 人工映射占用的相同 Lucide 或品牌母版；
   • 与任一已映射图标感知相似度 > 50% 的 Lucide；
   • 只符合次语义、不符合主语义的 Lucide。

6. 目标没有人工映射时：

   • 已注册品牌直接使用注册表中唯一的纯品牌母版，不叠加任务修饰符。
   • 未注册的品牌绑定型先按“品牌 Logo 规则”选择和规范化品牌母版，并同步登记到 assets/brand-registry.json；不得退回无关 Lucide。
   • 非品牌型内部比较至少 3 个语义候选，按以下顺序裁决：
     1. 主语义准确；
     2. 与次语义不冲突；
     3. 感知相似度最低；
     4. 48×48 下轮廓清晰。 不向用户展示未通过门禁的草稿。若内置母版没有合格候选，为公司库目标补充一个 官方 Lucide 母版并新增人工映射；不得用无关图形或稳定哈希结果凑数。

7. 首次使用、依赖缺失、升级后或用户要求自检时运行：

   npm install --prefix "<generator-skill-dir>" --no-package-lock
   node "<generator-skill-dir>/scripts/self_check.mjs"
   

   必须看到 SELF_CHECK_PASS；否则展示失败项并停止。

8. 先预览最终选择：

   node "<generator-skill-dir>/scripts/generate_icon.mjs" \
     "<target-skill-dir>" --dry-run
   

   检查 mark_type、lucide_icon、metaphor、 closest_match.similarity 与品牌/主语义一致。

9. 运行单目标生成器。只有步骤 4 明确允许替换时才追加 --force：

   node "<generator-skill-dir>/scripts/generate_icon.mjs" \
     "<target-skill-dir>"
   

10. 若生成命令失败，报告错误与部分产物并停止；不得绕过相似度门禁，不得自行追加 --force 重试。

11. 打开实际 PNG，验证 SVG、PNG、agents/openai.yaml 和感知相似度报告。

12. 输出 ICON_GENERATION_REPORT，包含目标、品牌判定、主/次语义、颜色族、 mark_type、图形母版、隐喻、品牌来源（如适用）、选择来源、最相似图标及 百分比、输出路径。