@pactor-app/skills 1.40.0 → 1.42.0

package/README.md

@@ -78,7 +78,7 @@ ln -s node_modules/@pactor-app/skills/pactor-prd ~/.claude/skills/pactor-prd
 | 路径 | 作用 |
 | --- | --- |
 | `pactor-prd/template/` | 可运行模板工程（common + provider/route 参考模块） |
-| `pactor-prd/references/*.md` | 目录结构、组件映射、页模板、mock、主题、验收清单 |
+| `pactor-prd/references/*.md` | 目录结构、组件映射、页模板、mock、主题、验收清单、资产库查找（`doc/` 组件/模板/业务组件文档） |
 
 详见 [`pactor-prd/SKILL.md`](pactor-prd/SKILL.md) 与 [`pactor-prd/template/README.md`](pactor-prd/template/README.md)。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pactor-app/skills",
-  "version": "1.40.0",
+  "version": "1.42.0",
   "description": "Agent skills for rapidly building pactor Server-Driven UI applications",
   "keywords": [
     "pactor",

package/pactor-prd/SKILL.md

@@ -2,7 +2,7 @@
 name: pactor-prd
 description: |
   Use when PRD or markdown wireframes drive Pactor YAML pages (skill id pactor-prd). Greenfield: copy template/ into a new repo. Incremental: in an existing Pactor project, add or update pages from new/changed wireframe files (DSL, sitemap, menus, data API, styles). Triggers: pactor-prd, prd-to-app, 线框图增量, 已有项目加页面, PRD 更新页面.
-version: 1.5.0
+version: 1.6.0
 ---
 
 # PRD → YAML 页面应用生成
@@ -73,6 +73,7 @@ version: 1.5.0
 - **增量**：仅 **add** 新建文件；**update** 改已有 yaml；**deprecate** 删文件并改 sitemap（须用户确认）
 - 校验见 `page-inventory-and-files.md`（全量）或 `incremental-wireframe-delta.md`（增量）
 - 按 `references/component-mapping.md` 映射组件；按 `references/page-templates.md` 选列表/详情/表单模板（**数据列表页直接复制 `yaml/models/data-list.yaml` 替换占位符**）；表单一律 `Form` 包裹
+- **组件/模板/业务组件拿不准时先查资产库**（`references/asset-library.md`）：组件详情含可套用的 DSL 示例与 whenToUse，线框模板含可渲染的提炼 DSL；业务组件以 details 条目 + packages/ui 导出为准（catalog 的 integration 字段不可信）
 - 同步更新 `sitemap.yaml` 的 `pages` + `menus`（hidden 详情/编辑带 `activeMenu`）
 - 每页 dataSources 全部 `type: http`：**有接口文档 → url 取文档接口地址**；无 → 按 `references/data-api.md` 命名约定写 `/api/d/...`（转发层空数据回退，无需 mock）；交互 events + actions 闭环
 
@@ -92,6 +93,7 @@ version: 1.5.0
 | `references/incremental-wireframe-delta.md` | **已有工程**：线框图 add/update/deprecate、改 sitemap/数据接口/样式 |
 | `references/project-structure.md` | 阶段 2：目录结构约定与 sitemap.yaml 骨架 |
 | `references/component-mapping.md` | 阶段 3：线框图区域 → pactor 组件映射 |
+| `references/asset-library.md` | 阶段 3–4：查资产库组件详情（DSL 示例/whenToUse）、线框模板（可渲染 DSL）、业务组件真伪核对、主题令牌；线上 https://pactor.innospots.com 或源码 `doc/` |
 | `references/page-templates.md` | 阶段 3：列表/详情/表单页 yaml 模板；数据列表页默认用「数据列表标准模型」（搜索 Form + 表格 + 抽屉新建/编辑） |
 | `references/data-api.md` | 阶段 3：数据接口层约定（纯转发、路径即契约、空数据回退、路径命名） |
 | `references/theme-and-style.md` | 阶段 4：主题令牌提取、皮肤、自定义 CSS、换肤 |

package/pactor-prd/references/asset-library.md

@@ -0,0 +1,51 @@
+# 资产库查找（doc/ 组件 · 模板 · 业务组件文档）
+
+生成页面时，组件选型、DSL 写法、页面模板拿不准，**先到资产库查现成方案**，不要凭空拼装。
+
+资产库有两种访问方式：
+
+1. **线上站点**：https://pactor.innospots.com —— 任何环境可用（含增量模式接入的外部工程）。
+   常用路径（注意带尾斜杠）：
+   - 组件分类清单：`/components/<分类>/`（如 `/components/business/`、`/components/data-entry/`），总览 `/components/overview/`
+   - 组件详情（DSL 示例 / whenToUse / 变体）：`/components/<分类>/<slug>/`（如 `/components/business/login/`）
+   - 线框模板：`/templates/wireframe/<slug>/`（如 `/templates/wireframe/login-layouts/`）
+   - 主题：`/themes/`
+2. **源码数据层**：本 monorepo 的 `doc/` 目录，全部是可直读的结构化静态文件（见下表）。
+
+> 适用前提：源码方式要求工作区是本 monorepo（含 `doc/`）；其他环境一律用线上站点。
+
+## 数据分布
+
+| 查找目标 | 位置 | 内容 |
+| --- | --- | --- |
+| 组件目录（有什么组件） | `doc/src/assets-data/components/<分类>.ts` | 条目含 `id`（规范 ID，如 `component.login`）、`name`、`purpose`、`maturity`、`description`；分类文件：general / layout / navigation / data-entry / data-display / feedback / media / charts / ai-chat / business |
+| 组件详情 + DSL 示例 | `doc/src/assets-data/details/<分类>-details.ts` | 每个条目含 **`dsl`（可直接套用的 DSL 片段，含 props/events）**、`whenToUse`（何时用/何时不用）、`variants`（变体与适用场景）、`previewNote`（结构说明） |
+| 页面模板 | `doc/src/content/wireframe-templates/<slug>/` | 14 个模板：`admin-shell` `dashboard` `search-list` `card-list` `form-page` `drawer-form` `modal-confirm` `detail-tabs` `detail-sections` `tree-master-detail` `login-layouts` `chat-page` `grant-panel` `info-text-cards`；`index.md` 为模板文档，`previews/*.yaml` 为**可渲染的提炼 DSL**，可直接复制改造 |
+| 主题 / 令牌 | `doc/src/assets-data/themes/`、`doc/src/assets-data/tokens/` | 主题家族与令牌定义，阶段 4 换肤对齐用 |
+
+## 怎么用（按阶段）
+
+**阶段 3 · 组件映射**
+1. 先按 `references/component-mapping.md` 粗选组件；
+2. 拿不准选型或写法时，在 `details/<分类>-details.ts` 找对应条目：`whenToUse` 确认是否该用，`dsl` 片段直接作为页面片段的起点，`variants` 决定 props 组合；
+3. 线框图整页结构接近某个线框模板时，读 `content/wireframe-templates/<slug>/index.md` + `previews/*.yaml`，以模板骨架改造，优于逐区域拼。
+
+**阶段 3 · 业务组件**
+- `components/business.ts` 有 26 个文档条目，但 **catalog 的 `integration` 字段不可信**（文档规范条目也标 integrated）；
+- **只有 `details/business-details.ts` 中存在条目的 9 个**（Login / EntityCard / CardList / ExpressionEditor / FieldCondition / RuleConfig / RuleExpression / ScriptEditor / SearchableSelect）是 `packages/ui` 真实实现、可直接用；
+- 其余条目（高级表格、人员选择器等）只有产品文档定义、无实现——线框图命中时用基础组件组合近似，并在交付说明中标注差距。
+
+**阶段 4 · 样式**：主题家族与令牌定义在 `assets-data/themes/` / `tokens/`，与 `references/theme-and-style.md` 配合。
+
+## 权威顺序与核对
+
+1. `packages/ui` 当前导出（`src/components/`，含 `register.ts` 的 DSL 类型注册）——最终以代码为准；
+2. `details/*-details.ts` 的 `dsl` 示例——已按真实实现核对过；
+3. `components/*.ts` catalog 描述——仅作选型参考。
+
+三处冲突时以 1 为准，并提示同步资产库数据。
+
+## 可选：本地运行态预览
+
+本地调试资产库站点本体时，在 `doc/` 下 `pnpm dev`（默认 4336 端口）；
+日常查找优先用线上站点 https://pactor.innospots.com 或直读数据文件，不必本地起服务。