# `@deppon/deppon-skills`

本仓库维护的 **Cursor Agent Skills**（`SKILL.md` 集合），用于对齐 `@deppon/deppon-template`、`@deppon/deppon-ui` 等私有 npm 包的前端生成流程。

> **产品 PRD / 高保真原型**（`deppon-prd-generator`）由 **`@deppon/pm-toolkit`** 分发，**不包含**在本包中。

## 与 Cursor 的关系

- Cursor 会从**项目目录下的** `.cursor/skills/<name>/SKILL.md` 加载技能。
- **不会**自动从 `node_modules` 读 skill，因此安装本 npm 包后需要执行一次**安装脚本**（见下文）。

## 发布（维护方）

在 `deppon-npm` 根目录维护 `.cursor/skills/`；`npm pack` / `npm publish` 前会通过 `prepack` → `npm run build` 将其中内容复制到包内 **`dist/`**：

```bash
cd packages/deppon-skills
npm run build         # 可选手动执行；prepack 会再次执行
npm pack
npm run publish:auto  # 等同 npm publish，需已登录 publishConfig 中的私有 registry
```

版本可与 monorepo 一起做 lerna 发布，或单独改本包 `version` 后 `npm run publish:auto`。

## 使用（消费方）

1. 安装：

```bash
npm install @deppon/deppon-skills -D
```

2. 将包内 **`dist/`** 下各 skill 目录复制到当前项目：

```bash
npx deppon-skills-install
```

会在当前目录创建/覆盖 `.cursor/skills/*`。

3. 用 Cursor 打开该项目即可。业务运行时仍需安装 `@deppon/deppon-template` 等，参见 skill `deppon-npm-private-registry`。

## 更新

升级 `@deppon/deppon-skills` 后重新执行：

```bash
npx deppon-skills-install
```

若在 monorepo 内直接维护 `.cursor/skills` 而不通过 npm，则无需安装本包。