svg-collisions
创建或修复没有重叠文本/形状的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 (
--strictvs normal) - Whether collisions are real (text-on-rect label patterns are often intentional)
Procedure
- Run collision detection.
- Inspect reported collisions by severity.
- Fix only true problems (especially text-over-text).
- 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/ortools/dev/svg-templates/
References
- Tool doc:
tools/dev/README.md(svg-collisions section) - SVG methodology:
docs/guides/SVG_CREATION_METHODOLOGY.md