@alanwang-merit/meritdata-platform-skill-package 1.0.9 → 1.0.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alanwang-merit/meritdata-platform-skill-package",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },

package/readme.md

@@ -0,0 +1,547 @@
+# MeritData Platform 25 Skill 三层架构
+
+> **梳理时间**：2026-09-12
+> **覆盖范围**：27 个 `meritdata-platform-*` 二开 skill（24 公司级 + 3 团队私有）
+> **架构设计**：参考 `meritdata-platform-suite` 仓库的 `core/` `themes/` `extensions/` 三层目录结构，与 sample-project 实际清单对齐
+> **目的**：明确每个 skill 在体系中的定位（做什么用、归谁管、和谁组合用），帮助开发者精准路由
+
+---
+
+## 🏛️ 三层架构总览（27 个 skill）
+
+```
+        ┌─────────────────────────────────────────────────────────────┐
+        │  📘 核心层 (core)             2 个 skill					 │
+        │  ─ meritdata-platform-playbook（编排）					 │  编排/综合入口
+        │  ─ meritdata-platform-cloud-dev（综合开发）				    │
+        └──────────────┬──────────────────────────────────────────────┘
+                       ↓                                              
+        ┌─────────────────────────────────────────────────────────────┐
+        │  📗 主题层 (themes)           9 个 skill					 │
+        │														 │
+        │  【业务运行时 4】										 │
+        │  ─ meritdata-platform-bpm（业务流程）						│
+        │  ─ meritdata-platform-job（定时任务）						│
+        │  ─ meritdata-platform-impexp（数据 IO）					  │
+        │  ─ meritdata-platform-org-sync（HR 同步）					  │
+        │                                              			      │  平台能力
+        │  【平台基础 3】                                 			 │
+        │  ─ meritdata-platform-core（SDK 工具集）      			      │
+        │  ─ meritdata-platform-entities（同 JVM 实体） 			      │
+        │  ─ meritdata-platform-integration（外部接口） 			     │
+        │                                              			      │
+        │  【前端 2】											    │
+        │  ─ meritdata-platform-frontend（前端工程）    			     │
+        │  ─ meritdata-platform-ui-components（Vue 组件库）		      │
+        └──────────────┬───────────────────────────────────────────────┘
+                       ↓                                              
+        ┌──────────────────────────────────────────────────────────────┐
+        │  📙 扩展层 (extensions)     16 个 skill      			       │
+        │														  │
+        │  【用户与认证 3】                              			     │
+        │  ─ meritdata-platform-sso（SSO 单点登录）    			      │
+        │  ─ meritdata-platform-session（用户会话）    			      │
+        │  ─ meritdata-platform-resource-auth（URL/按钮权限）	           │
+        │                                            			       │
+        │  【数据与安全 3】                             			     │
+        │  ─ meritdata-platform-data-secret（数据密级）			      │
+        │  ─ meritdata-platform-crypto-gm（国密算法）  			      │
+        │  ─ meritdata-platform-logging（操作日志）    			      │
+        │                                             			       │
+        │  【性能与通讯 2】                              			     │
+        │  ─ meritdata-platform-cache（Redis 缓存）   			        │
+        │  ─ meritdata-platform-messaging（消息通知） 			      │  业务增强 + 工程辅助
+        │														   │
+        │  【配置 1】												│
+        │  ─ meritdata-platform-config-item（业务配置）			      │
+        │                                             			       │
+        │  【工程辅助 5】                                			      │
+        │  ─ meritdata-platform-2nd-dev-check（开始前体检）			 │
+        │  ─ meritdata-platform-deploy（打包部署）     			      │
+        │  ─ meritdata-platform-portal-customization（portal 定制）		│
+        │  ─ meritdata-platform-code-review-by-rules（按规则审查）		 │
+        │  ─ meritdata-platform-bootstrap-2nd-dev（新工程生成）		 │
+        │                                                               │
+        │  【联调测试 2】                                			      │
+        │  ─ meritdata-platform-menu-config（菜单挂载）				 │
+        │  ─ meritdata-platform-nacos-importer（Nacos 导入）		   │
+        └──────────────────────────────────────────────────────────────┘
+```
+
+| 层级 | 数量 | 定位 | 来源 |
+|------|:---:|------|------|
+| 📘 核心层 (core) | **2** | 编排/综合入口 | `meritdata-platform-suite/core/` |
+| 📗 主题层 (themes) | **9** | 平台能力（业务核心）| `meritdata-platform-suite/themes/` |
+| 📙 扩展层 (extensions) | **16** | 业务增强（11 公司级）+ 代码审查（1）+ 团队私有（3）+ 工程辅助（1 公司级）| suite extensions/ + sample-project 自有 |
+| **合计** | **27** | | |
+
+---
+
+## 📘 核心层 (core) — 2 个（一行 2 个布局）
+
+> **定位**：**编排入口 + 综合入口**——项目**全程的指挥中心**，提供**全局路由**。
+> **使用方式**：项目**开始**通过 playbook（编排）→ **全程**通过 cloud-dev（综合开发） → 收尾**不**经过核心层。
+
+### 索引表
+
+| # | Skill |
+|---|-------|
+| 1 | `meritdata-platform-playbook` |
+| 2 | `meritdata-platform-cloud-dev` |
+
+### 详情表（一行 2 个 skill）
+
+| Skill | 角色 | 触发场景 |
+|-------|------|---------|
+| `meritdata-platform-playbook` | 唯一编排入口 | 跨 skill 需求、12 Phase 编排、整体开发流程、路由表 |
+| `meritdata-platform-cloud-dev` | 综合开发入口 | 加新模块 / 二开 / 新建工程 / 平台能力查询（含 22 模块 + templates/）|
+
+**调用关系**：
+- 项目**开始**必须经过 playbook（编排）确定路线
+- 任何开发任务**先**经过 cloud-dev（综合入口）再展开具体主题层
+- 项目**收尾**不走核心层（直接走扩展层 deploy 部署）
+
+---
+
+## 📗 主题层 (themes) — 9 个（按 3 类细分，一行 2 个布局）
+
+> **定位**：**平台核心能力**——按业务主题划分的"必用"能力。
+> **使用方式**：根据业务需求直接触发，是日常开发**最常用**的 9 个 skill。
+
+### A. 业务运行时（4 个）
+
+**索引表**：
+
+| # | Skill |
+|---|-------|
+| 3 | `meritdata-platform-bpm` |
+| 4 | `meritdata-platform-job` |
+| 5 | `meritdata-platform-impexp` |
+| 6 | `meritdata-platform-org-sync` |
+
+**详情表（一行 2 个）**：
+
+| Skill | Skill |
+|-------|-------|
+| `meritdata-platform-bpm` | `meritdata-platform-job` |
+| `meritdata-platform-impexp` | `meritdata-platform-org-sync` |
+
+**关键能力与触发场景**：
+
+| Skill | 关键能力 | 触发场景 |
+|-------|---------|---------|
+| `meritdata-platform-bpm` | `BpmEngine` 25+ 方法 / 6 篇 BPM 攻略 | 业务流程审批 |
+| `meritdata-platform-job` | `@JobHandler` / `IJobApi` XXL-JOB 调度 | 定时任务 / 数据同步 |
+| `meritdata-platform-impexp` | Excel 导入导出 / 文件附件 | 数据 IO 业务 |
+| `meritdata-platform-org-sync` | HR/ERP 集成 / 7 大子攻略 | 组织人员同步 |
+
+### B. 平台基础（3 个）
+
+**索引表**：
+
+| # | Skill |
+|---|-------|
+| 7 | `meritdata-platform-core` |
+| 8 | `meritdata-platform-entities` |
+| 9 | `meritdata-platform-integration` |
+
+**详情表（一行 2 个，3 个技能填 2 行）**：
+
+| Skill | Skill |
+|-------|-------|
+| `meritdata-platform-core` | `meritdata-platform-entities` |
+| `meritdata-platform-integration` | （无）|
+
+**关键能力与触发场景**：
+
+| Skill | 关键能力 | 触发场景 |
+|-------|---------|---------|
+| `meritdata-platform-core` | 平台 SDK 工具集（NacosUtils / SM3Encoder / SessionUtils）| 跨主题基础 SDK |
+| `meritdata-platform-entities` | 同 JVM 60+ 实体类（Emp / Org / Lookup / Q类）| 数据实体（同 JVM 调用）|
+| `meritdata-platform-integration` | 49+ 外部 REST 端点（org/role/dict/menu/basic-config）| 跨 JVM Feign HTTP |
+
+### C. 前端（2 个）
+
+**索引表**：
+
+| # | Skill |
+|---|-------|
+| 10 | `meritdata-platform-frontend` |
+| 11 | `meritdata-platform-ui-components` |
+
+**详情表（一行 2 个）**：
+
+| Skill | Skill |
+|-------|-------|
+| `meritdata-platform-frontend` | `meritdata-platform-ui-components` |
+
+**关键能力与触发场景**：
+
+| Skill | 关键能力 | 触发场景 |
+|-------|---------|---------|
+| `meritdata-platform-frontend` | Vue 2 前端工程模板（cloud-module-base）| 前端工程基建 |
+| `meritdata-platform-ui-components` | 14 个 Vue 公共组件（UserSelect / DeptSelect / CloudDialog）| 前端组件库 |
+
+**主题间协同**：
+- **核心层 cloud-dev 综合后**：展开具体主题（bpm / entities / integration / job 等）
+- **业务运行时四件套**：bpm + job + impexp + org-sync
+- **平台基础三件套**：entities + integration + core（SDK）
+- **前端两件套**：frontend（工程）+ ui-components（组件库）
+
+---
+
+## 📙 扩展层 (extensions) — 16 个（按 6 类细分，一行 2 个布局）
+
+> **定位**：**业务增强 + 工程辅助 + 团队私有**——按需触发的辅助能力。
+> **使用方式**：根据业务场景**有需要时**调用，不是开发主线。
+
+### A. 用户与认证（3 个）
+
+**索引表**：
+
+| # | Skill |
+|---|-------|
+| 12 | `meritdata-platform-sso` |
+| 13 | `meritdata-platform-session` |
+| 14 | `meritdata-platform-resource-auth` |
+
+**详情表（一行 2 个，3 个填 2 行）**：
+
+| Skill | Skill |
+|-------|-------|
+| `meritdata-platform-sso` | `meritdata-platform-session` |
+| `meritdata-platform-resource-auth` | （无）|
+
+**关键能力与触发场景**：
+
+| Skill | 关键能力 | 触发场景 |
+|-------|---------|---------|
+| `meritdata-platform-sso` | `IPortalSSOApi` 单点登录 | SSO/CAS 认证 |
+| `meritdata-platform-session` | `SessionUtils` 21 方法 | 用户会话管理 |
+| `meritdata-platform-resource-auth` | 20+ 资源授权 / `@PreAuthorize` | URL/按钮权限 |
+
+### B. 数据与安全（3 个）
+
+**索引表**：
+
+| # | Skill |
+|---|-------|
+| 15 | `meritdata-platform-data-secret` |
+| 16 | `meritdata-platform-crypto-gm` |
+| 17 | `meritdata-platform-logging` |
+
+**详情表（一行 2 个，3 个填 2 行）**：
+
+| Skill | Skill |
+|-------|-------|
+| `meritdata-platform-data-secret` | `meritdata-platform-crypto-gm` |
+| `meritdata-platform-logging` | （无）|
+
+**关键能力与触发场景**：
+
+| Skill | 关键能力 | 触发场景 |
+|-------|---------|---------|
+| `meritdata-platform-data-secret` | `@EnableDataSecretFilter` / Hibernate Filter | 数据密级 / 行级权限 |
+| `meritdata-platform-crypto-gm` | SM2/SM3/SM4 国密算法 | 电子签章 / 加密 |
+| `meritdata-platform-logging` | `ILogPostService` + `@LogDesc` / `@LogOperation` | 操作审计 / 脱敏 |
+
+### C. 性能与通讯（2 个）
+
+**索引表**：
+
+| # | Skill |
+|---|-------|
+| 18 | `meritdata-platform-cache` |
+| 19 | `meritdata-platform-messaging` |
+
+**详情表（一行 2 个）**：
+
+| Skill | Skill |
+|-------|-------|
+| `meritdata-platform-cache` | `meritdata-platform-messaging` |
+
+**关键能力与触发场景**：
+
+| Skill | 关键能力 | 触发场景 |
+|-------|---------|---------|
+| `meritdata-platform-cache` | `SysCacheServiceFacade` 23 方法 / Redis 分布式锁 | 性能优化 |
+| `meritdata-platform-messaging` | `CloudFeignMessageClient` 5 消息方法 | 站内信 / 邮件 / 短信 |
+
+### D. 配置（1 个）
+
+**索引表**：
+
+| # | Skill |
+|---|-------|
+| 20 | `meritdata-platform-config-item` |
+
+**详情表（1 个 skill 占一行，右侧空）**：
+
+| Skill | Skill |
+|-------|-------|
+| `meritdata-platform-config-item` | （无）|
+
+**关键能力与触发场景**：
+
+| Skill | 关键能力 | 触发场景 |
+|-------|---------|---------|
+| `meritdata-platform-config-item` | `MeritdataCloudProperties` 业务配置 | 业务开关 / 业务参数 |
+
+### E. 工程辅助（4 个公司级）
+
+**索引表**：
+
+| # | Skill |
+|---|-------|
+| 21 | `meritdata-platform-2nd-dev-check` |
+| 22 | `meritdata-platform-deploy` |
+| 23 | `meritdata-platform-portal-customization` |
+| 24 | `meritdata-platform-code-review-by-rules` |
+
+**详情表（一行 2 个，4 个填 2 行）**：
+
+| Skill | Skill |
+|-------|-------|
+| `meritdata-platform-2nd-dev-check` | `meritdata-platform-deploy` |
+| `meritdata-platform-portal-customization` | `meritdata-platform-code-review-by-rules` |
+
+**关键能力与触发场景**：
+
+| Skill | 关键能力 | 触发场景 |
+|-------|---------|---------|
+| `meritdata-platform-2nd-dev-check` | **开始前就绪度体检** | 接手样例工程前 / 新工程生成后 7 大类 60+ 项自检 |
+| `meritdata-platform-deploy` | 后端 mvn + 前端 npm + Nginx 部署 | 上线部署 |
+| `meritdata-platform-portal-customization` | portal 首页框架配置 / 主题切换 / Logo / 个性化 URL | portal 定制 |
+| `meritdata-platform-code-review-by-rules` | 基于 `.claude/rules/` 11 个代码规范 | 按项目规范审查 PR |
+
+### F. 联调测试（3 个）
+
+**索引表**：
+
+| # | Skill |
+|---|-------|
+| 25 | `meritdata-platform-bootstrap-2nd-dev` |
+| 26 | `meritdata-platform-menu-config` |
+| 27 | `meritdata-platform-nacos-importer` |
+
+**详情表（一行 2 个，3 个填 2 行）**：
+
+| Skill | Skill |
+|-------|-------|
+| `meritdata-platform-bootstrap-2nd-dev` | `meritdata-platform-menu-config` |
+| `meritdata-platform-nacos-importer` | （无）|
+
+**关键能力与触发场景**：
+
+| Skill | 关键能力 | 触发场景 |
+|-------|---------|---------|
+| `meritdata-platform-bootstrap-2nd-dev` | 自包含新二开项目生成（41 bundled 文件）| 从零生成新工程到 `generated-projects/` |
+| `meritdata-platform-menu-config` | 运行时菜单挂载 / SQL 配菜单 | 联调上线时挂菜单 |
+| `meritdata-platform-nacos-importer` | Nacos 配置导入 | 二开过程中 properties 导入 Nacos |
+
+**调用关系（按 6 类）**：
+- **认证/权限三件套**：sso + session + resource-auth（前后端鉴权）
+- **数据安全三件套**：data-secret + crypto-gm + logging（密级 + 加密 + 审计）
+- **性能/通讯两件套**：cache + messaging（缓存 + 通知）
+- **开始前工具**：2nd-dev-check（接手样例 / 新工程后）
+- **代码审查工具**：code-review-by-rules（按 .claude/rules/ 11 个代码规范审查）
+- **Portal 定制**：portal-customization（首页 / 主题 / Logo / 个性化 URL）
+
+---
+
+## 🔀 三层典型组合使用场景
+
+### 场景 1：加新业务模块（最常见）
+
+```
+【开始前】2nd-dev-check（体检样例工程）→ 扩展层 E
+【开始】playbook（编排）→ cloud-dev（综合）→ 核心层
+  ├─ entities（实体类）→ 主题层 B
+  ├─ core（基础 SDK）→ 主题层 B
+  ├─ bpm（如果含审批）→ 主题层 A
+  ├─ job（如果有定时）→ 主题层 A
+  ├─ impexp（如果含导入导出）→ 主题层 A
+  └─ menu-config（挂菜单）→ 扩展层 F
+【收尾】deploy（部署）→ 扩展层 E
+```
+
+### 场景 2：组织人员同步
+
+```
+playbook（编排）→ org-sync（HR/ERP）→ 主题层 A
+  └─ integration（外部接口）→ 主题层 B
+session（取用户）→ 扩展层 A
+entities（同 JVM 实体）→ 主题层 B
+```
+
+### 场景 3：数据密级控制
+
+```
+data-secret（@EnableDataSecretFilter）→ 扩展层 B
+session（取用户密级）→ 扩展层 A
+core（Nacos 3 键配置）→ 主题层 B
+```
+
+### 场景 4：前端页面开发
+
+```
+cloud-dev（业务模块）→ 主题层核心层
+frontend（Vue 2 工程）→ 主题层 C
+ui-components（14 个公共组件）→ 主题层 C
+integration（外部接口）→ 主题层 B
+```
+
+### 场景 5：上线流程
+
+```
+deploy（打包）→ 扩展层 E
+nacos-importer（Nacos 导入）→ 扩展层 F
+menu-config（挂菜单）→ 扩展层 F
+```
+
+> 📌 **2nd-dev-check 是"开始前"工具，不是"上线前"**——上线前不重复体检（开发过程中已逐步自检）
+
+### 场景 6：按规则代码审查（PR 前）
+
+```
+code-review-by-rules（按 .claude/rules/ 审查）→ 扩展层 E
+  ├─ 加载 11 个代码规范（.claude/rules/）
+  └─ 输出 ❌ 违规 / ✅ 符合 / ⚠️ 建议 三类
+```
+
+---
+
+## 📊 三层架构统计
+
+| 维度 | 核心层 | 主题层 | 扩展层 | 团队私有 | 合计 |
+|------|:---:|:---:|:---:|:---:|:---:|
+| **总 skill 数** | 2 | 9 | 13 | 3 | **27** |
+| 其中公司级 | 2 | 9 | 13 | 0 | 24 |
+| 其中团队私有 | 0 | 0 | 0 | 3 | 3 |
+| **调用方式** | | | | | |
+| SDK in-process | 0 | 4 | 8 | 0 | 12 |
+| Feign HTTP | 0 | 2 | 2 | 0 | 4 |
+| 业务运行时 | 0 | 4 | 0 | 0 | 4 |
+| 路由/入口 | 2 | 0 | 0 | 0 | 2 |
+| 开始前体检 | 0 | 0 | 1 | 0 | 1 |
+| 工程工具（含部署）| 0 | 0 | 1 | 3 | 4 |
+
+---
+
+## 🔗 与其他文档关系
+
+| 文档 | 内容 |
+|------|------|
+| [平台能力按研发阶段汇总.md](平台能力按研发阶段汇总.md) | 27 skill 按研发阶段 + 业务场景 + skill 类型 三维度汇总 |
+| [基于研发流程微服务二开.md](基于研发流程微服务二开.md) | 12 Phase 研发流程对应 skill 矩阵 |
+| [通用技能总览.md](通用技能总览.md) | 通用 skill 速查（与 meritdata 互补）|
+| [研发流程常用技能与规范统计.md](研发流程常用技能与规范统计.md) | 通用 skill 实战统计 |
+| `D:\A_meritdata\AI\AI赋能专项工作\meritdata-platform-suite\core\|themes\|extensions\` | 原始三层目录（公司级 21 个）|
+
+---
+
+## 💡 三层架构使用建议
+
+1. **项目开始时**：先查**核心层**（playbook 编排 + cloud-dev 综合入口）
+2. **接手样例/新工程前**：看**扩展层 2nd-dev-check**（体检 7 大类 60+ 项）
+3. **做具体业务开发**：看**主题层**（9 个核心 skill，按 3 类细分）
+4. **加业务增强功能**：看**扩展层**（10 个横切关注点，按 6 类细分）
+5. **代码审查 / 部署 / 联调**：看**扩展层 E 类**（code-review-by-rules / deploy / portal-customization / 2nd-dev-check）
+6. **项目初始化/收尾**：看**扩展层 F 类**（bootstrap / nacos-importer / menu-config）
+7. **避免误用**：
+   - ❌ 不用 playbook 直接写代码（应交给 cloud-dev）
+   - ❌ 不用 cloud-dev 做整体编排（应交给 playbook）
+   - ❌ 不用扩展层 skill 写业务逻辑（它们是业务增强）
+   - ❌ 不用 2nd-dev-check 在收尾时（应在开始前使用）
+   - ❌ 不用团队私有 skill 写日常开发（它们是工程辅助）
+
+---
+
+## 📦 安装与分发（npm 一键安装）
+
+> **skill 已发布到 npm 仓库**，可一键下载 + 自动分发到本地 `.claude` 和 `.agents` 目录。
+> 来源：[`@alanwang-merit/meritdata-platform-skill-package`](https://www.npmjs.com/package/@alanwang-merit/meritdata-platform-skill-package)
+
+### 一键安装（推荐）
+
+```bash
+# 1. 安装 skill 包（latest 标签）
+npm install @alanwang-merit/meritdata-platform-skill-package@latest
+
+# 2. 自动 postinstall：把 skills 和 rules 分发到本地 .claude 和 .agents
+node node_modules/@alanwang-merit/meritdata-platform-skill-package/scripts/postinstall.js
+```
+
+postinstall.js 默认分发到：
+- `<用户目录>/.claude/skills/`（本仓库 `.claude/skills/`）
+- `<用户目录>/.agents/skills/`（本仓库 `.agents/skills/`）
+- `<用户目录>/.claude/rules/`（项目级规则）
+- `<用户目录>/.agents/rules/`（镜像规则）
+
+![image-20260914154337064](https://mh-typora-pictures.oss-cn-wulanchabu.aliyuncs.com/img/20260914154337.png)
+
+### 验证安装
+
+```bash
+# 1. 检查 .claude/skills 数量（应该是 27）
+ls .claude/skills/ | grep -c "^meritdata-platform-"
+
+# 2. 检查 .claude/rules 数量（应该是 13）
+ls .claude/rules/ | wc -l
+
+# 3. 检查 .agents 镜像同步
+diff -r .claude/skills/ .agents/skills/ | head -5
+```
+
+### npm 包结构
+
+```
+@alanwang-merit/meritdata-platform-skill-package/
+├── SKILLS/                        # 27 个 meritdata-platform-* skill
+│   ├── meritdata-platform-playbook/
+│   ├── meritdata-platform-cloud-dev/
+│   ├── ... (25 个其他)
+├── RULES/                         # 13 个项目级规则
+│   ├── code-dev-rules.md
+│   ├── coding-standards-rules.md
+│   ├── ... (11 个其他)
+└── scripts/
+    └── postinstall.js             # 自动分发脚本
+```
+
+### 更新到最新版
+
+```bash
+# 升级 skill 包到 latest
+npm update @alanwang-merit/meritdata-platform-skill-package
+
+# 重新执行 postinstall 覆盖本地 skills 和 rules
+node node_modules/@alanwang-merit/meritdata-platform-skill-package/scripts/postinstall.js
+```
+
+### 卸载
+
+```bash
+npm uninstall @alanwang-merit/meritdata-platform-skill-package
+# 手动清理 .claude/skills/ 和 .agents/skills/ 下的 meritdata-platform-* 目录
+```
+
+### 常见问题
+
+| 问题 | 解决 |
+|---|---|
+| `npm install` 报权限错 | 加 `--prefix ~/.npm-global` 或用 `sudo` |
+| `node postinstall.js` 找不到 | 检查 `node_modules/@alanwang-merit/meritdata-platform-skill-package/scripts/postinstall.js` 是否存在 |
+| .claude 和 .agents 不一致 | 手动重跑 `node postinstall.js`（脚本会同时写两边）|
+| skill 加载不到 | 检查 `.claude/skills/<skill>/SKILL.md` 是否存在 |
+
+---
+
+> **快速链接**：
+> - 加新模块 → `meritdata-platform-cloud-dev`（**核心层**综合入口）
+> - 整体编排 → `meritdata-platform-playbook`（核心层编排入口）
+> - 开始前体检 → `meritdata-platform-2nd-dev-check`（扩展层）
+> - 后端部署 → `meritdata-platform-deploy`（扩展层）
+> - 前端组件 → `meritdata-platform-ui-components`（主题层）
+> - 找文档 → `meritdata-platform-playbook`（含路由表）
+> - 代码审查 → `meritdata-platform-code-review-by-rules`（扩展层）

package/rules/api-design-rules.md

@@ -1,10 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
-
 # REST API 设计规范
 
 **触发条件**：设计REST API、编写接口文档、创建Controller时

package/rules/code-dev-rules.md

@@ -1,10 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
-
 # 代码开发指南
 
 **触发条件**：编写Java代码、开发功能模块时
@@ -96,72 +89,9 @@
 
 ---
 
-## 八、方法论铁律（双轨制：rules 摘要 + skill 详细）
-
-> **双轨制原则**：本节是"铁律摘要"，自动随 rules 加载生效；完整文档、反模式对比、根因分析、回归用例 见对应 skill 的 references/。详情见 `meritdata-platform-code-spec`、`meritdata-platform-data-boundary`、`meritdata-platform-domain-model` 三个 L2 方法论 skill。
-
-### 8.1 数据访问边界（data-boundary）
-
-**铁律 4 条**（完整版见 [`meritdata-platform-data-boundary.md`](./meritdata-platform-data-boundary.md)）：
-
-- 🔴 **不映射 `PF_` 前缀平台表**：二开库禁止 `@TableName("PF_*")` / 跨库 JOIN / 直连平台数据库
-- 🔴 **不分页循环逐条 Feign**：必须一次 Feign 批量装配 + 内存 join，禁止 `for + userClient.getById`
-- 🔴 **不复制平台 Entity/Repository**：独立部署场景下禁止 `import com.meritdata.cloud.platform.entity.*`
-- 🔴 **不掩盖平台故障**：禁止 `catch (Exception) { return Collections.emptyList(); }`，必须显式上抛
-
-### 8.2 业务建模规则（domain-model）
-
-**铁律 4 条**（完整版见 [`meritdata-platform-domain-model-rules.md`](./meritdata-platform-domain-model-rules.md)）：
-
-- 🔴 **二开业务表/字段必须小写蛇形**：`t_purchase_order`、`order_no`；实体类大驼峰 + `@Column` 显式映射
-- 🔴 **不得把人员/组织名称作为唯一关联键**：必须用稳定 `*_user_id` / `*_dept_id`，名称仅作冗余快照
-- 🔴 **跨服务禁止数据库外键**：通过应用层维护一致性，禁止 `FOREIGN KEY REFERENCES other_service.t_*`
-- 🔴 **唯一性校验必须穿透软删除**（见 §8.3）：`nativeQuery + findXxxIncludingDeleted` 穿透 `@Where`
-
-### 8.3 code-spec 补充铁律（编码层）
-
-**软删除实体**（核心反模式，根因：DB 唯一约束含软删除记录 + JPQL 受 `@Where` 过滤 → INSERT 500）：
-
-- ✅ 唯一性校验 `findXxxNo` 必须用 `findXxxIncludingDeleted`（`nativeQuery = true`）
-- ✅ 编号生成器"查已用编号"必须用 `findAllNosStartingWithIncludingDeleted`
-- ✅ 业务查询 / 全量查询必须**成对出现**（业务查询无后缀、全量查询 `IncludingDeleted` 后缀）
-
-**循环与外部资源**（重复 §四，再强调）：
-
-- 🔴 禁止 `for` 内调用 DB / Redis / HTTP / Feign
-- ✅ 必须批量查询 + 内存 join
-
-**异常处理**（重复 §五，再强调）：
-
-- 🔴 禁止空 catch / 吞异常（`return Collections.emptyList()` 是不掩盖的反例）
-- ✅ 必须 `throw new ServiceException("CODE", "msg", e)` 上抛 + 上下文
-
-**敏感信息**（重复 §六，再强调）：
-
-- 🔴 禁止日志打印 password / token / keytab / principal
-- ✅ 必须脱敏后打印（手机号、身份证、银行卡号）
-
-**架构层**：
-
-- 🔴 Controller / Service / Dao 层禁止有成员变量（除注解和常量）——避免线程安全问题
-- 🔴 Shell 脚本必须使用 Linux 换行符（`\n`，非 `\r\n`）——避免 Windows 部署脚本执行失败
-
-### 8.4 与 skill 的协作
-
-```
-[自动加载] rules 本节 → 所有 skill 都受硬约束
-    ↓ 开发者问"为什么这样" / "完整例子"
-[触发] 对应 skill（code-spec / data-boundary / domain-model）→ 加载 references/anti-patterns.md
-    ↓ 提交前
-[校验] skill 的 references/validate-rules.md 给出 CI 命令
-```
-
----
-
 ## 重要提醒
 
 - 循环内禁止调用外部资源
 - 任何密码等敏感信息严禁打印到日志
 - Controller/Service/Dao层禁止有成员变量（除注解和常量）
 - Shell脚本必须使用Linux换行符
-- **方法论铁律更新先改本 rules，再同步 skill 的 references/**（保证两边一致）