recomp 是一个面向前端开发的组件复刻技能（支持主流 AI agents ），它解决了组件库框架（例如 React ）和你项目开发框架（例如 SolidJS ）不一致的问题：指导 AI 阅读组件库文档，把组件的交互和行为模式复刻成适配你框架的 headless(无头) 组件源码和使用示范——所有产出直接展示在对话里，复制即用. https://github.com/brickhu/skills/recomp
现在的设计组件库，为什么你都用不上？
不是它们不好——shadcn/ui 、Radix 、MUI 、Ant Design ，一个比一个精致。问题出在"用得上"这三个字上。
深夜 23:47 ，你正在为自己的 App 打磨一个日期选择组件。你发现了 shadcn/ui 的 DatePicker ，很惊艳，交互模式也基本符合你的要求。你花了大把时间研究它的安装使用流程，把使用文档翻了个遍——然而一个根本问题始终绕不过去：框架不对。它只支持 React ，而你的项目用的是 SolidJS 。
其实，我们选用第三方设计组件库时，普遍都会面临这么几个问题：
- 框架对不上：JSX 、hooks 、受控组件，复制过来直接报错——最精致的组件库几乎全是 React 写的，而你用的是 SolidJS / Vue / Svelte
- 样式对不上：组件库用 Tailwind 写的，你的项目用的是 StyleX / CSS-in-JS ，class 满天飞，接不进来
- 设计对不上：组件库自带一套 design token ，跟你的设计系统打架，改起来比重写还累
这就是前端开发者的普遍困境：我们想用别人的轮子来解放生产力，但不是每一个轮子（组件）都适合你的底盘（框架）——于是你只能安慰自己"回头自己写一个"。
组件库是"成品菜"，你要的其实是"菜谱"
组件库就是一盘做好的成品菜——React 实现、样式、设计 token ，整整齐齐端到你面前，看似复制过来就能"吃"。
但前提是：你家灶台（框架）和口味（样式方案）恰好和这家餐厅一样。 你的灶台是 Vue / Solid / Svelte ，口味是 StyleX / 你的 design token——所以这盘菜再好，你也吃不了。
你真正需要的，不是这盘菜，而是它的菜谱：
- 下拉框：方向键怎么选、回车怎么确定、Escape 怎么关
- 弹窗：焦点怎么锁、滚动怎么锁，关闭事件如何注入回调函数？
- 无障碍：读屏软件听到什么、ARIA 角色挂在哪个节点上
这些交互逻辑和模式，跟框架、样式都无关。 你要节约的，正是花在组件模式上的时间。
| 菜谱（行为契约） | 灶台（你的框架） | 摆盘（你的样式） |
|---|---|---|
| 状态、键盘、焦点、ARIA | Svelte 5 的 runes / Vue 的 v-model / Solid 的 signal | 设计 token 、StyleX 、Tailwind |
菜谱不该被厨房锁死。你要做的，只是把菜谱翻译成你家灶台的用法。
recomp——通过成品菜，生成适合你的菜谱
recomp 是开源的 AI 技能包，装上之后，你的 AI 编程助手就变成你的组件复刻外包：发一个组件库文档 URL ，它交付四样东西：
- 行为契约摘要——接口、行为，外加文档没写清楚、需要你拍板的开放问题，你先审再动手
- headless 组件源码——纯行为、零样式，按你的框架惯用法写：Vue 用
v-model、Svelte 5 用bind:/runes 、Solid 用 signal ，不是把 JSX 改个名就交差 - 使用说明 + 依赖清单——复制就能用
- 样式接口契约——data-attribute 全集、class 插槽、CSS 变量，接你的设计 token 用
样式和设计 token 完全归你。 它交付的是行为层，怎么"摆盘"是你的设计系统说了算。
还有一个组件库给不了的优势：免安装。 组件库要 npm install 进 node_modules ，背着依赖树和升级义务； recomp 交付的是纯源码——复制进你的组件目录就是你的代码，不装依赖、不进 node_modules 、不用跟着上游版本走。你要的是一份菜谱，不是把人家厨房整套搬回家。
安装与使用：一个完整例子
安装（二选一）：
# 方式一：一行命令（推荐）——路径里的 /recomp 就是技能名，无需再加 -s
npx skills add brickhu/skills/recomp
或手动复制到你的 AI 助手技能目录（ Claude Code 、Cursor 、Zed 都行）：
git clone https://github.com/brickhu/skills.git
cp -r skills/recomp ~/.agents/skills/recomp
以"给 Svelte 5 项目复刻 shadcn/ui 的 Dialog"为例，完整流程是这样：
复制 shadcn/ui 的 Dialog 的文档地址，打开你的 AI 编程助手（ Claude Code 、Codex 、Cursor 、Zed 都行），新建对话，输入：
recomp https://ui.shadcn.com/docs/components/dialog ，项目在 ~/my-app （ Svelte 5 ）
# 如果你的对话在项目工程目录下可以直接输入：
recomp https://ui.shadcn.com/docs/components/dialog
它先回你一份行为契约摘要：
✅ 验证通过：是 shadcn/ui 的 Dialog 组件文档
---
接口：open （是否打开）/ onOpenChange （状态变化通知）→ Svelte 5 写法 bind:open
文档明确的行为：按 Esc 关闭 · 点击弹窗外层关闭 · 打开时锁定页面滚动
依赖：无，纯原生实现
---
回复 yes / 确认 采纳建议，或直接输入你的想法
你回复 yes ，它继续问第 2 处（焦点是否限制在弹窗内），再回复 yes——开放问题全部确认完毕，它直接按文件输出完整源码（节选）：
// src/Button.tsx （节选）
import { splitProps, type JSX } from "solid-js";
type Props = JSX.ButtonHTMLAttributes<HTMLButtonElement> & {
loading?: boolean;
};
export function Button(props: Props) {
const [local, rest] = splitProps(props, ["disabled", "loading", "onClick", "children"]);
return (
<button
{...rest}
disabled={local.disabled || local.loading}
data-state={local.loading ? "loading" : "idle"}
aria-busy={local.loading}
onClick={(e) => {
if (local.disabled || local.loading) return;
local.onClick?.(e);
}}
>
{local.loading && <span aria-hidden="true">…</span>}
{local.children}
</button>
);
}
以及使用示范：
import { createSignal } from "solid-js";
import { Button } from "./src/Button";
function App() {
const [loading, setLoading] = createSignal(false);
return (
<Button
loading={loading()}
class="submit" // class 就是样式入口，接你的设计 token
onClick={() => {
setLoading(true);
submit();
}}
>
提交
</Button>
);
}
复制源码、接上你的样式，完事。不满意某处行为？直接在对话里说——"Escape 处理不对""这里用 bind 不要用 v-model"——它当场重出完整文件，不用打补丁。
你可能会担心：AI 复刻的组件，靠谱吗？
放心，最容易被做砸的几个环节，它都提前上了保险：
- 不是组件库页面？拒绝。 你发的是博客、工具库、设计稿，它直接拒绝并说明原因，绝不硬着头皮"猜着复刻"
- 无障碍语义绝不瞎猜。 ARIA 角色、焦点管理、键盘行为，要么按 WAI-ARIA APG 规范补全（并逐条标注出处），要么明确告诉你"这块没实现"——宁可留白，不做假
- 不碰你的工程。 探测你的框架、CSS 方案、设计 token 时只读：不建目录、不改文件，探测结果只用在当前这一个组件上
- 许可边界分明。 复刻的是"接口 + 行为"，不抄别人的源码和样式值，来源记录留档，商用也安心
不过有个局限性需要说清楚：recomp 交付的是无样式的 headless （无头）组件源码，不是成品组件封装——拿到源码之后，样式需要你自己去处理。这个局限来源于 recomp 的底层哲学：模式可以通用，但设计一定要个性化。
一句话：AI 负责复刻，接口、行为、边界全都在你手里。
最后：一种新的组件消费范式
从"成品菜"封装，到"菜谱复刻"，对前端开发者来说，是一次开发范式的升迁——你的灶台，该有自己的菜谱了！
recomp 开源免费（ MIT ），支持任何能加载 SKILL.md 的 AI 助手（ Claude Code 、Codex 、Cursor 、Zed 都行），随便用、随便改、随便分享。
📦 仓库地址：https://github.com/brickhu/skills/recomp 📖 中英文使用指南都在仓库里（ README_cn.md / README.md ）
欢迎 Star ，欢迎提 issue ，欢迎把你复刻的好组件分享出来。
Select Language