TypeUI 设计基础原则
为 AI 生成界面提供与设计系统无关的通用 UI/UX 准则，在缺少具体规范或美学与无障碍冲突时给出可依据的判断。
通用 UI/UX 设计原则参考（视觉层级、交互法则、排版基础、WCAG 无障碍要求），设计系统无关、纯知识型指导，不涉及远程服务，风险面小于同仓库其他平台适配 skill。
这个 Skill 能做什么，适合哪些场景？
typeui-fundamentals 是 TypeUI 技能集中的一个独立技能，位于仓库的 skills/fundamentals/ 目录。它提供五份原则文档，覆盖视觉层次、间距、交互与 UX 法则、字体排印以及 WCAG 2.1/2.2 无障碍要求。这些原则不绑定任何设计系统，应在加载设计系统之后读取，用于解释“为什么这样设计”并裁决规范未覆盖的决定。明确声明了冲突优先级：具体 token 以设计系统为准，结构原则以本层为准，流程以垂直层为准，而无障碍在任何层级都不可妥协。
技能本体是一组 Markdown 参考文档：ui-principles.md（层次、布局节奏、色彩、深度、响应式）、spacing-principles.md（4 点网格、间距层级）、ux-principles.md（30 条 UX 法则、9 种控件状态、触控目标）、typography-principles.md（字阶、可读性、响应式字体）、accessibility.md（对比度、焦点可见性、键盘导航、ARIA）。加载后，Agent 在设计系统未覆盖的决策上依据这些原则给出答案，并在原则与设计系统冲突时标记冲突供人复核。它不定义工作流阶段、质量门、反模式目录或设计 token。
- 全栈/前端开发者让 Claude Code 或 Codex 生成界面，但项目还没有成型的设计系统，需要原则兜底而不是随意发挥。
- 团队已使用 TypeUI 设计系统技能，希望 Agent 在加载 DESIGN.md/token 之后仍能解释每项决定背后的原理。
- 审查者或评审 Agent 需要检查生成界面是否满足 WCAG 要求，如对比度、焦点可见性、键盘导航。
- 美学与无障碍要求发生冲突时，需要一个明确规则：无障碍优先于视觉偏好。
- 使用不支持任何特定设计系统的多框架项目（任意前端栈），需要垂直无关、适用于所有界面的基础准则。
这个 Skill 有哪些优点和局限？
- 设计系统无关，适用于任意前端栈与界面类型。
- 覆盖面完整：层次、间距、UX 法则、字体、WCAG 无障碍五大模块。
- 冲突优先级规则明确，避免原则与设计系统互相矛盾。
- SKILL.md 采用 MIT 许可，元数据标注作者为 typeui.sh。
- 可与其他 TypeUI 技能（设计系统、垂直流程）分层组合。
- 需要配合设计系统使用才能发挥最大价值，单独使用时缺少具体 token 与组件规范。
- 仓库整体 GitHub 许可标记为 NOASSERTION，仅 SKILL.md 与 CLI 声明 MIT，重分发前需自行确认。
- 原则文档中的模块（30 条 UX 法则、9 状态契约等）的实际质量与准确性无测试套件或评测证据。
- 源文档未提供各客户端的具体安装路径与触发示例。
- 工作流、质量门、反模式与行业内容在其他技能中，需要额外安装才能获得。
如何安装这个 Skill？
在终端运行：npx skills add https://github.com/bergside/typeui --skill typeui-fundamentals。也可从 GitHub 仓库 bergside/typeui 手动复制 skills/fundamentals/ 目录到你的 Agent Skills 目录。源文档未说明各客户端的默认安装路径，请查阅所用工具的文档。
如何使用这个 Skill？
按技能的加载顺序说明：先加载你的设计系统（SKILL.md / DESIGN.md 及 token 模块），再加载本技能的五份原则文档。之后正常请求 UI 工作，例如“用这个设计系统实现一个设置页，并确保符合 WCAG 对比度要求”。当设计系统未覆盖某项决定时，Agent 会回退到这些原则。CLI 仅用于安装/生成，技能本身无运行时命令。