---

name: asset-maintenance description: "Safely inspect, preview, and maintain the bilingual diagram asset tree." disable-model-invocation: true metadata: disco-role: operating license: NOASSERTION

Asset maintenance

Use this sub-skill when you need to inspect, validate, rename, or trim the repo's bilingual diagram assets without reopening the source checkout or running the original in-place scripts first.

Start here

1. Read references/asset-layout.md to understand the asset tree, workbook assumptions, generated-versus-source assets, and special cases.
2. Read references/maintenance-workflows.md for dry-run-first rename, name-column, and whitespace-trim flows.
3. Use scripts/asset_maintenance.py for inventory, rename-plan, add-name-column, and trim operations.
4. If a command fails or a dependency is missing, check references/troubleshooting.md before touching the live tree.

Router boundaries

• Concept lookup, diagram-family explanations, roadmap navigation, and model-catalog questions route to ../knowledge-atlas/SKILL.md.
• Do not use src/clip_images.py or src/rename_images.py as the first execution path; they are source behavior references and mutate in place.
• Do not bulk rewrite assets unless the user explicitly passes --apply to the bundled helper and has chosen a safe output tree or accepted the in-place rename effect.

Critical operating facts

• images_chinese/ and images_english/ each contain png_big/, png_small/, and source_svg/; English also has source_xlsx/ for selected source workbooks.
• src/conf/info-ch.xlsx and src/conf/info-en.xlsx are headerless naming maps. Row 1 is slide 1, not zero.
• Chinese AI Roadmap(AI知识架构).png is a special asset present in the image tree but absent from the Chinese naming workbook.
• English source_svg/ is not a 1:1 mirror of png_big/; the RoPE diagrams use source_xlsx/ instead.
• File names may contain Chinese punctuation, spaces, full-width brackets, and other Unicode characters; preserve them exactly.
• The bundled helper defaults to dry-run previews and requires --apply before any mutation.

Safe maintenance pattern

• Inventory first.
• Stage copied fixtures before applying rename or trim operations.
• Validate counts, workbook rows, and stem alignment after every change.
• Prefer output trees or copied workbooks over touching originals when trimming.
• Keep source-script adaptation rationale in the bundled references, not in the live repo files.