用途:为应用或开源包绘制极简母版图标,输出 1024x1024 SVG。图形为深灰圆角矩形(Apple 风格圆角)上的对称字形,定位是避免 LLM 一次性生成 SVG 的常见缺陷(路径臃肿、伪 <image> 矢量、坐标过度精确)。
不适用:概念探索用 icon-brief;评审渲染图或修小尺寸问题用 icon-critique;生成 favicon/商店/资源文件用 icon-export;UI 图标集、插画、字标、栅格 logo 矢量化也不适用。
工作流:先取 brief,读取 icon-design/brief.md,没有则写 5 行 quick brief(产品、概念 + 一个格式塔手法、对称轴、配色)并标注;无概念不得开画。从模板开始,复制 assets/master-template.svg,得到 viewBox="0 0 1024 1024" 与真实 squircle 背景路径 <path id="bg">,不要手写或手改该路径,用脚本重生成: python3 "${CLAUDE_SKILL_DIR}/scripts/squircle.py"(iOS 26+) python3 "${CLAUDE_SKILL_DIR}/scripts/squircle.py" --legacy(iOS 7-18)
绘制要点:坐标尽量落在 64/32/16 倍数,最多 2 位小数;能用基本图形就用(圆用 <circle>、条用 <rect>),有轮廓的主体用绝对命令 <path>;笔画最多 2 种宽度(≥48 单位)、颜色 ≤3 种。填色而非描边,64px 下目标约 20% 墨量,用背景色挖空做图底关系。对称通过构造实现:跨轴部件居中于 x=512,离轴部件放入 <defs><g id="half">,用 <use href="#half"/> 加 translate(1024,0) scale(-1,1) 镜像。字形最大边长约 460–655 单位,居中 r=409 安全圆优先。只使用安全静态子集:无文本、渐变、滤镜、CSS、@media、脚本、外部引用、位图。生成 2–4 个候选文件 icon-design/candidates/<n>-<slug>.svg,不覆盖已有文件,候选间变化轮廓而非同一想法的尺寸。逐个校验: python3 "${CLAUDE_SKILL_DIR}/scripts/check_svg.py" icon-design/candidates/1-<slug>.svg --axis v (横向用 --axis h,有机主体用 --axis none。)修复所有 ERROR,权衡报告 WARN。最后交付候选并推荐 icon-critique,不要宣布定稿、不要导出。
限制:背景圆角矩形只用于自渲染场景(favicon、README、GitHub);iOS/App Store 需全方形变体,由 icon-export 将背景 rx 设为 0 导出,不得在导出中再套一层圆角。镜像 <use> 半形需完全不透明填充,半形不得跨轴。fill="none" 且无 stroke 会渲染空白。光学居中允许微调 ≤8 单位,但 bbox 中心需在 linter ±6 容差内。不得模仿现有标志。字形字母用路径绘制可行但 16px 可读性差。linter 通过仅代表有效,不代表好看,人工评审是必要步骤。若无法运行 linter(缺 python3 或脚本),应失败关闭,标记 UNVALIDATED 并报告。