svg-collisions

metabench 的头像作者 metabench

创建或修复没有重叠文本/形状的SVG图表。适用于发布新的SVG、编辑WLILO风格的图表,或当碰撞检查报告重叠/裁剪时。

📖 中文导读:创建或修复没有重叠文本/形状的SVG图表。适用于发布新的SVG、编辑WLILO风格的图表,或当碰撞检查报告重叠/裁剪时。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: svg-collisions description: Create or repair SVG diagrams without overlapping text/shapes. Use when shipping new SVGs, editing WLILO-styled diagrams, or when collision checks report overlaps/clipping.

SVG Collisions (Repair + Validation)

Scope

  • Detect overlaps/collisions in SVGs
  • Apply safe layout fixes (move label backgrounds, adjust spacing)
  • Re-run validation until clean

Inputs

  • SVG filepath
  • Desired strictness (--strict vs normal)
  • Whether collisions are real (text-on-rect label patterns are often intentional)

Procedure

  1. Run collision detection.
  2. Inspect reported collisions by severity.
  3. Fix only true problems (especially text-over-text).
  4. Re-run strict mode before shipping.

Validation

Run:

  • node tools/dev/svg-collisions.js <file> --strict

Escalation / Research request

Ask for dedicated research if:

  • strict mode repeatedly reports false positives tied to viewBox scaling
  • you need a new reusable theme/layout template under data/svg-templates/ or tools/dev/svg-templates/

References

  • Tool doc: tools/dev/README.md (svg-collisions section)
  • SVG methodology: docs/guides/SVG_CREATION_METHODOLOGY.md