@alanwang-merit/meritdata-platform-skill-package

v1.0.15

Published

4 days ago

``` ┌─────────────────────────────────────────────────────────────┐ │ 📘 核心层 (core) 2 个 skill │ │ ─ meritdata-platform-playbook（唯一编排入口路由） │ │ ─ meritdat

0High
0Medium
0Low

alanwang-merit

        ┌─────────────────────────────────────────────────────────────┐
        │  📘 核心层 (core)             2 个 skill                     │
        │  ─ meritdata-platform-playbook（唯一编排入口 路由）                                │
        │  ─ meritdata-platform-cloud-dev（MeritData Cloud 综合开发入口）        │
        └──────────────┬──────────────────────────────────────────────┘
                       ↓                                              
        ┌─────────────────────────────────────────────────────────────┐
        │  📗 主题层 (themes)           9 个 skill                     │
        │                                                         │
        │  【业务运行时 4】                                         │
        │  ─ meritdata-platform-bpm（BPM 工作流 业务流审批）                       │
        │  ─ meritdata-platform-job（XXL-JOB 任务调度）                        │
        │  ─ meritdata-platform-impexp（Excel 导入导出 + 文件附件）                │
        │  ─ meritdata-platform-org-sync（组织人员同步 HR/ERP 集成）                      │
        │  【平台基础 3】                                              │
        │  ─ meritdata-platform-core（平台后端基础 SDK 工具集）                     │
        │  ─ meritdata-platform-entities（同 JVM 60+ 实体类）                  │
        │  ─ meritdata-platform-integration（平台外部 API 接口 49+ 端点）          │
        │  【前端 2】                                                │
        │  ─ meritdata-platform-frontend（平台 Vue 2 页面、组件）                 │
        │  ─ meritdata-platform-ui-components（14 个 Vue 公共组件库）            │
        └──────────────┬───────────────────────────────────────────────┘
                       ↓                                              
        ┌──────────────────────────────────────────────────────────────┐
        │  📙 扩展层 (extensions)     16 个 skill                         │
        │                                                          │
        │  【用户与认证 3】                                               │
        │  ─ meritdata-platform-sso（SSO/CAS 单点登录 IPortalSSOApi）          │
        │  ─ meritdata-platform-session（用户会话 SessionUtils 21 方法）         │
        │  ─ meritdata-platform-resource-auth（资源码 URL/按钮 权限）             │
        │  【数据与安全 3】                                              │
        │  ─ meritdata-platform-data-secret（数据密级 行级权限）                   │
        │  ─ meritdata-platform-crypto-gm（国密算法 SM2/SM3/SM4）              │
        │  ─ meritdata-platform-logging（操作日志 @LogDesc）                   │
        │  【性能与通讯 2】                                               │
        │  ─ meritdata-platform-cache（Redis 缓存 SysCacheServiceFacade）    │
        │  ─ meritdata-platform-messaging（消息通知 站内信/邮件/短信）                    │
        │  【配置 1】                                                │
        │  ─ meritdata-platform-config-item（Nacos 配置中心 业务参数）             │
        │  【工程辅助 5】                                                  │
        │  ─ meritdata-platform-2nd-dev-check（二开项目就绪度体检）                 │
        │  ─ meritdata-platform-deploy（后端+前端 打包部署）                       │
        │  ─ meritdata-platform-portal-customization（portal 首页定制 HomeFrame/Theme）│
        │  ─ meritdata-platform-code-review-by-rules（按 .claude/rules/ 11 个代码规范审查）│
        │  ─ meritdata-platform-bootstrap-2nd-dev（自包含新二开项目生成）            │
        │  【联调测试 2】                                                  │
        │  ─ meritdata-platform-menu-config（菜单挂载 SQL on pf_resource）     │
        │  ─ meritdata-platform-nacos-importer（Nacos 配置批量导入）             │
        └──────────────────────────────────────────────────────────────┘

MeritData Platform 27 Skill 三层架构

梳理时间：2026-09-12 覆盖范围：27 个 meritdata-platform-* 二开 skill 目的：明确每个 skill 在体系中的定位（做什么用、归谁管、和谁组合用），帮助开发者精准路由

🏛️ 三层架构总览（27 个 skill）

        ┌────────────────────────────────────────────────────────────────────────────┐
        │  📘 核心层 (core)             2 个 skill					                │
        │  ─ meritdata-platform-playbook（技能路由）                                  │
        │  ─ meritdata-platform-cloud-dev（MeritData Cloud 综合开发入口）              │
        └──────────────┬──────────────────────────────────────────────────────────────┘
                       ↓                                              
        ┌─────────────────────────────────────────────────────────────────────────────┐
        │  📗 主题层 (themes)           9 个 skill					                 │
        │														                 │
        │  【业务运行时 4】										                 │
        │  ─ meritdata-platform-bpm（BPM 工作流 业务流审批）                             │
        │  ─ meritdata-platform-job（XXL-JOB 任务调度）                                 │
        │  ─ meritdata-platform-impexp（Excel 导入导出 + 文件附件）                      │
        │  ─ meritdata-platform-org-sync（组织人员同步 HR/ERP 集成）                     │
        │                                              			                      │ 
        │  【平台基础 3】                                 			                 │
        │  ─ meritdata-platform-core（平台后端基础 SDK 工具集）                          │
        │  ─ meritdata-platform-entities（同 JVM 60+ 实体类）                           │
        │  ─ meritdata-platform-integration（平台外部 API 接口 49+ 端点）                │
        │                                              			                      │
        │  【前端 2】											                    │
        │  ─ meritdata-platform-frontend（平台 Vue 2 页面、组件）                        │
        │  ─ meritdata-platform-ui-components（14 个 Vue 公共组件库）                    │
        └──────────────────────────────────────┬────────────────────────────────────────┘
                                               ↓                     
        ┌───────────────────────────────────────────────────────────────────────────────┐
        │  📙 扩展层 (extensions)     16 个 skill      			                        │
        │														                   │
        │  【用户与认证 3】                              			                      │
        │  ─ meritdata-platform-sso（SSO/CAS 单点登录 IPortalSSOApi）                     │
        │  ─ meritdata-platform-session（用户会话 SessionUtils 21 方法）                  │
        │  ─ meritdata-platform-resource-auth（资源码 URL/按钮 权限）                     │
        │                                            			                        │
        │  【数据与安全 3】                             			                      │
        │  ─ meritdata-platform-data-secret（数据密级 行级权限）                           │
        │  ─ meritdata-platform-crypto-gm（国密算法 SM2/SM3/SM4）                         │
        │  ─ meritdata-platform-logging（操作日志 @LogDesc）                              │
        │                                             			                        │
        │  【性能与通讯 2】                              			                       │
        │  ─ meritdata-platform-cache（Redis 缓存 SysCacheServiceFacade）                 │
        │  ─ meritdata-platform-messaging（消息通知 站内信/邮件/短信）                      │
        │														                     │
        │  【配置 1】												                  │
        │  ─ meritdata-platform-config-item（Nacos 配置中心 业务参数）                      │
        │                                             			                         │
        │  【工程辅助 5】                                			                        │
        │  ─ meritdata-platform-2nd-dev-check（二开项目就绪度体检）                         │
        │  ─ meritdata-platform-deploy（后端+前端 打包部署）                                │
        │  ─ meritdata-platform-portal-customization（portal 首页定制 HomeFrame/Theme）    │
        │  ─ meritdata-platform-code-review-by-rules（按 .claude/rules/ 11 个代码规范审查） │
        │  ─ meritdata-platform-bootstrap-2nd-dev（自包含新二开项目生成）                   │
        │                                                                                 │
        │  【联调测试 2】                                			                        │
        │  ─ meritdata-platform-menu-config（菜单挂载 SQL on pf_resource）                 │
        │  ─ meritdata-platform-nacos-importer（Nacos 配置批量导入）                       │
        └─────────────────────────────────────────────────────────────────────────────────┘

| 层级 | 数量 | 定位 | |------|:---:|------| | 📘 核心层 (core) | 2 | 编排/综合入口 | | 📗 主题层 (themes) | 9 | 平台能力（业务核心）| | 📙 扩展层 (extensions) | 16 | 业务增强（10）+ 代码审查（1）+ 工程辅助（4）+ 联调测试（2） | | 合计 | 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 | 关键能力 | 触发场景 | |-------|---------|---------| | 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 | 关键能力 | 触发场景 | |-------|---------|---------| | 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 | 关键能力 | 触发场景 | |-------|---------|---------| | 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 | 关键能力 | 触发场景 | |-------|---------|---------| | meritdata-platform-sso | IPortalSSOApi 单点登录 | SSO/CAS 认证 | | meritdata-platform-session | SessionUtils 21 方法 | 用户会话管理 | | meritdata-platform-resource-auth | 20+ 资源授权 / @PreAuthorize | URL/按钮权限 |

B. 数据与安全（3 个）

关键能力与触发场景：

| Skill | 关键能力 | 触发场景 | |-------|---------|---------| | meritdata-platform-data-secret | @EnableDataSecretFilter / Hibernate Filter | 数据密级 / 行级权限 | | meritdata-platform-crypto-gm | SM2/SM3/SM4 国密算法 | 电子签章 / 加密 | | meritdata-platform-logging | ILogPostService + @LogDesc / @LogOperation | 操作审计 / 脱敏 |

C. 性能与通讯（2 个）

关键能力与触发场景：

| Skill | 关键能力 | 触发场景 | |-------|---------|---------| | meritdata-platform-cache | SysCacheServiceFacade 23 方法 / Redis 分布式锁 | 性能优化 | | meritdata-platform-messaging | CloudFeignMessageClient 5 消息方法 | 站内信 / 邮件 / 短信 |

D. 配置（1 个）

关键能力与触发场景：

| Skill | 关键能力 | 触发场景 | |-------|---------|---------| | meritdata-platform-config-item | MeritdataCloudProperties 业务配置 | 业务开关 / 业务参数 |

E. 工程辅助（5个）

关键能力与触发场景：

| 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 | | meritdata-platform-bootstrap-2nd-dev | 自包含新二开项目生成（41 bundled 文件） | 从零生成新工程到 generated-projects/ |

F. 联调测试（2 个）

关键能力与触发场景：

| Skill | 关键能力 | 触发场景 | |-------|---------|---------| | 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/）
  └─ 输出 ❌ 违规 / ✅ 符合 / ⚠️ 建议 三类

📊 三层架构统计

| 维度 | 核心层 | 主题层 | 扩展层（10 公司级） | 扩展层（6 团队）| 合计 | |------|:---:|:---:|:---:|:---:|:---:| | 总 skill 数 | 2 | 9 | 10 | 6 | 27 | | 其中公司级 | 2 | 9 | 10 | 0 | 21 | | 其中团队私有 | 0 | 0 | 0 | 6 | 6 | | 调用方式 | | | | | | | 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 | 27 skill 按研发阶段 + 业务场景 + skill 类型三维度汇总 | | 基于研发流程微服务二开.md | 12 Phase 研发流程对应 skill 矩阵 | | 通用技能总览.md | 通用 skill 速查（与 meritdata 互补）| | 研发流程常用技能与规范统计.md | 通用 skill 实战统计 | | D:\A_meritdata\AI\AI赋能专项工作\meritdata-platform-suite\core\|themes\|extensions\ | 原始三层目录（公司级 21 个）|

💡 三层架构使用建议

项目开始时：先查核心层（playbook 编排 + cloud-dev 综合入口）
接手样例/新工程前：看扩展层 2nd-dev-check（体检 7 大类 60+ 项）
做具体业务开发：看主题层（9 个核心 skill，按 3 类细分）
加业务增强功能：看扩展层（10 个横切关注点，按 6 类细分）
代码审查 / 部署 / 联调：看扩展层 E 类（code-review-by-rules / deploy / portal-customization / 2nd-dev-check）
项目初始化/收尾：看扩展层 F 类（bootstrap / nacos-importer / menu-config）
避免误用：
- ❌ 不用 playbook 直接写代码（应交给 cloud-dev）
- ❌ 不用 cloud-dev 做整体编排（应交给 playbook）
- ❌ 不用扩展层 skill 写业务逻辑（它们是业务增强）
- ❌ 不用 2nd-dev-check 在收尾时（应在开始前使用）
- ❌ 不用团队私有 skill 写日常开发（它们是工程辅助）

📦 安装与分发（npm 一键安装）

skill 已发布到 npm 仓库，可一键下载 + 自动分发到本地 .claude 和 .agents 目录。来源：@alanwang-merit/meritdata-platform-skill-package

一键安装（推荐）

# 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/（镜像规则）

验证安装

# 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             # 自动分发脚本

更新到最新版

# 升级 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

卸载

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（扩展层）

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

MeritData Platform 27 Skill 三层架构

🏛️ 三层架构总览（27 个 skill）

📘 核心层 (core) — 2 个（一行 2 个布局）

索引表

详情表（一行 2 个 skill）

📗 主题层 (themes) — 9 个（按 3 类细分，一行 2 个布局）

A. 业务运行时（4 个）

B. 平台基础（3 个）

C. 前端（2 个）

📙 扩展层 (extensions) — 16 个（按 6 类细分，一行 2 个布局）

A. 用户与认证（3 个）

B. 数据与安全（3 个）

C. 性能与通讯（2 个）

D. 配置（1 个）

E. 工程辅助（5个）

F. 联调测试（2 个）

🔀 三层典型组合使用场景

场景 1：加新业务模块（最常见）

场景 2：组织人员同步

场景 3：数据密级控制

场景 4：前端页面开发

场景 5：上线流程

场景 6：按规则代码审查（PR 前）

📊 三层架构统计

🔗 与其他文档关系

💡 三层架构使用建议

📦 安装与分发（npm 一键安装）

一键安装（推荐）

验证安装

npm 包结构

更新到最新版

卸载

常见问题