design-system

原文涵盖的主题

• Design System — Onboarding + Shared Brand Tokens
• When to invoke
• Onboarding question set (10 questions)
• Hard rules
• Derived 12-token palette
• Forcing-question library (Matt Pocock grill-with-docs pattern)
• Customization in use (worked example)
• Assumptions

The design-system skill is the shared brand owner for the markdown-html plugin. Run its onboarding once. Every converter (md-document, md-review, md-slides) reads the resulting config via configloader.py and applies the same 12 CSS custom properties to its output. Without this, conversions render with placeholder defaults — technically functional but unbranded. This skill ships exactly three Python tools: 1. onboard.py — interactive (or --defaults / --set / --show / --reset) wizard. 2. configloader.py — importable customization loader with project > global > defaults precedence and MARKDOWNHTMLNOCONFIG=1 bypass. 3. brandpalettevalidator.py — WCAG-AA contrast checker + HSL palette deriver. All three are stdlib-only and contain no LLM calls (deterministic per Path-B discipline). | Symptom | Action | |---|---| | User says "convert this markdown to HTML" for the first time in this workspace | Run python3 markdown-html/skills/design-system/scripts/onboard.py | | /.config/markdown-html/design-system.json doesn't exist OR setupcompletedat is null | Refuse conversion, surface onboarding | | User wants per-repo brand override | python3 .../onboard.py --scope project | | User wants to change

这里只展示节选，请以完整原文和当前要求为准。