prd-grade-fe
Installation
SKILL.md
prd-grade-fe
$SKILL dưới đây = Base directory của skill này (dòng "Base directory for this skill" khi skill được nạp; trong repo framework là skills/prd-grade-fe). Mọi script và reference đi kèm thư mục skill, không phụ thuộc repo.
Hub mỏng. Không sở hữu luật thiết kế: thẩm mỹ là của hallmark (skills/hallmark/SKILL.md), luật tất định là của impeccable (npx -y impeccable@3.6.1 detect, pin cứng). Hub sở hữu thứ tự và hợp đồng giữa các pha, cộng hai script có --self-test:
| File | Vai trò |
|---|---|
scripts/design-sync.py |
design.md là nguồn chân lý: block css :root{} → frontmatter YAML (impeccable đọc) + tokens.css. --check rc 1 khi drift. |
scripts/fe-gate.sh |
Cổng trước khi giao: assert target tồn tại → detect --json → rc 0/1/2 đúng nghĩa → viewport-check.mjs 320/375/414/768. Exit 0 xanh · 1 lỗi impeccable · 2 finding/viewport đỏ · 3 skipped (thiếu node/mạng) · 4 target thiếu. |
scripts/badge-consistency.py |
Rule tất định impeccable không có (GH#164): trong MỘT file, badge trạng thái (render*Badge/*Status*/*Pill*/span pill) phải cùng chữ ký icon-hay-dot · rounded-* · hằng token (STATUS_GLASS); badge lệch đa số (≥2) → file:line, fe-gate tính là finding rc 2. |
references/presets/macos-glass.design.md |
Preset mặc định đã qua detect rc 0; bằng chứng ở macos-glass.evidence.md. |
references/intake.md |
Route A/B/C → design.md. |
references/impeccable-audit.md |
Rubric audit (5 trục /20) · harden · polish, distill có nguồn. |
When to use
- User muốn một trang/màn hình frontend đưa vào production, không phải mockup nhanh (mockup nhanh →
/brhoặc hallmark trần). - User đưa theme dưới dạng "mặc định đi", "đây là tài liệu thiết kế", hoặc "làm giống trang này: ".
- Project đã có
design.mdvà cần thêm màn hình cùng hệ kèm cổng kiểm.