dym-lieflat-charts-contributor-checks

Skill: dym-lieflat-charts-contributor-checks — Hai gate khi bạn sửa chính repo

Vì sao dùng: chỉ dành cho người sửa template/token/catalog trong repo. Người dùng cuối không bao giờ cần file này. Sinh ra cái gì: không sinh file. Chỉ trả exit code + danh sách lỗi ra stderr.

Repo không có .github/workflows/ (đã kiểm: ls .github → không tồn tại). Hai script này là gate chạy tay.

Gate 1 — validate.mjs (bắt buộc, không phụ thuộc gì)

cd <repo>
node scripts/validate.mjs; echo "EXIT=$?"

Chạy thật ở commit 475c9b6:

检查通过：52 个 HTML 文件，56 个文本文件。
EXIT=0

Khi fail:

检查失败（N 项）：
- <mô tả lỗi>
...
EXIT=1

Exit code: 0 = pass, 1 = fail. Không có mã nào khác — kiểm tận nơi ở scripts/validate.mjs, chỉ có đúng một lời gọi process.exit(1), còn đường pass rơi xuống console.log rồi kết thúc bình thường. Vế pass in ra stdout, vế fail in ra stderr.

Nó gác 7 nhóm, và điểm đáng chú ý là nó gác cả nội dung tài liệu, không chỉ sự tồn tại của file:

1. File phát hành tồn tại — SKILL.md, catalog.md, report-catalog.md, mono-tokens.js, color-presets.js, agents/openai.yaml, 19 file templates/color/*, và cho mỗi NN từ 01→12: cả report-NN.zh.html, report-NN.en.html, docs/assets/reports/report-NN.png.
2. Gallery đủ hình — mỗi nhóm (basics/lupi/glance/maps) × mỗi bản màu (gallery/porcelain/palm/wire) phải chứa đủ các id="..." bắt buộc (vd basics phải có treemap, histo, boxplot, stream, candle), và chuỗi đánh số phải khớp regex (L1–L19 hoặc 19 张…).
3. Luật trong SKILL.md không được xoá lén — bắt buộc còn chuỗi L1–L15 与 F1–F13, còn 5 ngoại lệ hình dự bị (F17 Candlestick, F15 Tick Box, L20 Parallel Coordinates, L17 Calendar Heat, F16 Stream Ribbon), và 5 role màu custom `BG` `TXT` `MUT` `GRID` `DATA`.
4. catalog.md còn đủ dòng — danh sách cứng F13–F17, L16/L17/L19/L20, G19–G22, M1/M2, và cụm chữ 主力与后备.
5. Cú pháp JS — trích từng khối <script> trong mọi file HTML rồi new vm.Script(...). Đây là bản node --check cho HTML.
6. Không trùng id trong cùng một file HTML (báo kèm số dòng cả hai lần xuất hiện).
7. Kỷ luật màu và tính tất định:
   • Math.random( xuất hiện ở bất kỳ file .html/.js/.mjs nào (trừ chính validate.mjs) → fail, phải dùng rnd() tất định.
   • File templates/color/*-{porcelain,palm,wire}.html chỉ được dùng đúng các kênh màu có trong preset tương ứng của color-presets.js — lệch một hex là fail.
   • File còn lại (trừ color-presets.js và templates/reports/) không được có hex "có màu": nếu max(R,G,B) - min(R,G,B) > 18 → "检测到明显彩色值".