kdesign-skill

KDesign 组件库 Cursor Skill 安装器。

使用 Playwright 爬取 KDesign 组件文档（React / Vue3 / Vue2），自动生成 SKILL.md 并部署到 ~/.cursor/skills/kdesign/，让 Cursor AI 在编码时能正确查阅和使用 KDesign 组件。

快速使用

npx kdesign-skill use skills

功能

• 交互式安装：箭头键选择要安装的组件库版本
• 并行爬取：5 并发爬取组件文档，速度快
• 增量更新：已有文档自动跳过，只爬新增组件
• 自动部署：爬取完成后自动生成 SKILL.md + metadata.json + 组件索引
• 支持卸载：一键清理已安装的 Skill 文件

安装后效果

安装后在 ~/.cursor/skills/kdesign/ 目录下会生成：

kdesign/
├── SKILL.md                    # AI 使用指南
├── metadata.json               # 版本和更新时间
└── references/
    ├── component-index.md      # 组件总索引
    ├── react/                  # React 组件文档
    │   ├── button.md
    │   ├── select.md
    │   └── ...
    ├── vue3/                   # Vue3 组件文档
    │   └── ...
    └── vue2/                   # Vue2 组件文档
        └── ...

当你在 Cursor 中编写使用 KDesign 组件的代码时，AI 会自动读取这些文档来提供准确的组件用法、API 参数和代码示例。

技术栈

| 库 | 用途 | |---|---| | Playwright | 浏览器自动化，爬取 SPA 渲染内容 | | Commander | CLI 命令解析 | | @inquirer/prompts | 交互式终端菜单 | | Turndown | HTML → Markdown 转换 | | Chalk | 终端彩色输出 | | Ora | 终端加载动画 |

开发

git clone <repo>
cd kdesign-skill
npm install
npx playwright install chromium
node cli.js use skills

License

MIT