@cloudai-design/oneskill

CloudAI 设计体系的 agent 语境，打成一个 skill 目录：主题 token、组件选型与用法、整页模板、 设计走查规则，外加一套从零起工程的脚手架。

给 AI 装上它，让它照着这套规范写页面，而不是每次凭训练数据猜颜色和间距。

装

npx @cloudai-design/oneskill

装进当前目录的 .agents/skills/CloudAI-UI/。换落点用 --dir .claude/skills， 升级到新版本加 --force。

用

让 AI 读 .agents/skills/CloudAI-UI/SKILL.md。手上还没有工程时，它会先跑包内的脚手架搭一个：

node .agents/skills/CloudAI-UI/setup/create-app.mjs my-app --brand aidbs

产出的是 Vite + React 18 + Tailwind v3 + shadcn，主题插件已装好，组件 registry 别名已配好， 首屏是页面外壳骨架。已有 Tailwind v3 + shadcn 工程的话读 setup/existing-project.md， 只改三处配置接上主题。

技术栈

组件与主题只支持 Tailwind v3 + shadcn。设计规范部分（层级、间距、状态、走查）与技术栈 无关，别的栈可以只借规范——SKILL.md 里的「降级模式」说了怎么用。

相关包

| 包 | 做什么 | | --- | --- | | @cloudai-design/tailwind | 主题插件，语义 token 的真源 | | @cloudai-design/eslint-plugin | 把「颜色写死了」变成 lint 报错 | | @cloudai-design/cli | 已有工程装同一批语境的另一条通道 |

MIT