用途：改进 viz/ 可视化层中已有的象形图标（glyph），流程为审计现状、诊断问题、定向修改、重新渲染、前后对比。
适用场景：图标在小尺寸下渲染不佳（细节丢失、形状粘连）；视觉隐喻不清晰或与所代表技能不符；比例问题（过大、过小、偏心）；霓虹发光过强或过弱；在某调色板下好看但在其他调色板下效果差；新增调色板或改动渲染管线后的批量改进。
输入：必填为待改进图标的技能 ID（如 commit-changes）与要解决的具体问题（可读性、比例、发光、调色板兼容）；可选为展示目标质量水平的参考图标、要优化的目标调色板（默认全部）。
主要步骤：1）审计，定位图标函数（技能图标在 viz/R/primitives*.R 并在 viz/R/glyphs.R 映射；智能体图标在 viz/R/agent_primitives.R 并在 viz/R/agent_glyphs.R 映射），查看 cyberpunk 等调色板下 48px 与 160px 的渲染，按可读性、比例、隐喻、发光平衡、调色板兼容、复杂度六个维度打分，找出最低的 1-2 项作为改进目标。2）诊断根因，如缩放因子过小、中心偏移、线条过细、硬编码颜色等。3）定向修改，保持函数签名不变：glyph_name <- function(cx, cy, s, col, bright)，返回 ggplot2 图层列表，修改应最小化。4）重新渲染，执行 cd /mnt/d/dev/p/agent-almanac/viz 后运行 Rscript build-icons.R --only <domain> --no-cache，智能体图标用 Rscript build-agent-icons.R --only <agent-id> --no-cache，并检查输出文件大小应在 2-15 KB（WebP）。5）对比前后，目标维度至少提升 1 分且非目标维度不下降，必要时在力导向图中验证。
限制与注意：不要过度修改或改变函数签名；不要只针对单一调色板优化，应检查 3 个以上调色板；不要忽略小尺寸渲染；修改后必须重新渲染。若图标函数缺失或需完全重设计，应改用 create-skill-glyph。相关技能包括 create-skill-glyph、ornament-style-mono、chrysopoeia。