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

package/skills/meritdata-platform-cache/references/resilience.md

@@ -0,0 +1,181 @@
+# 缓存防穿透 / 击穿 / 雪崩（cache）
+
+> 三大经典缓存异常场景及平台标准解法。
+
+---
+
+## 1. 概念速查
+
+| 问题 | 触发条件 | 后果 |
+|------|---------|------|
+| **穿透** | 查询不存在的 key（DB 也没有）| 每次都打到 DB，DB 压力大 |
+| **击穿** | 热点 key 过期瞬间 + 大量并发 | 同一瞬间全部打到 DB |
+| **雪崩** | 大量 key 同时过期 | DB 被瞬时大量请求打挂 |
+
+## 2. 防穿透（Cache Penetration）
+
+### 2.1 场景
+
+```java
+// 攻击者/爬虫查询不存在的 userId
+getUserById("1000000000000");  // DB 中不存在
+```
+
+每次都打到 DB。
+
+### 2.2 解法 1：缓存空值
+
+```java
+@Cacheable(value = "user", key = "#userId", unless = "#result == null")
+public UserDTO getById(String userId) {
+    return userRepository.findById(userId).orElse(null);
+}
+```
+
+注意：`unless` 让 null 也缓存；但需设置较短 TTL 防止内存泄漏。
+
+### 2.3 解法 2：布隆过滤器（数据量大时）
+
+```java
+@Resource
+private BloomFilter<String> userBloomFilter;
+
+public UserDTO getById(String userId) {
+    // 1. 先查布隆过滤器（不存在 → 直接返回）
+    if (!userBloomFilter.mightContain(userId)) {
+        return null;
+    }
+    // 2. 查缓存
+    UserDTO user = redis.get("user:info:" + userId);
+    if (user != null) return user;
+    // 3. 查 DB
+    user = userRepository.findById(userId).orElse(null);
+    if (user != null) {
+        redis.setex("user:info:" + userId, 600, JSON.toJSONString(user));
+    }
+    return user;
+}
+```
+
+## 3. 防击穿（Cache Breakdown）
+
+### 3.1 场景
+
+热点 key（如明星产品 SKU）过期瞬间 + 1 万并发 → 全部打到 DB。
+
+### 3.2 解法：分布式锁 + 单线程回源
+
+```java
+public UserDTO getById(String userId) {
+    String key = "user:info:" + userId;
+    UserDTO user = redis.get(key);
+    if (user != null) return user;
+
+    // 加分布式锁，只让一个线程回源
+    String lockKey = "lock:user:" + userId;
+    if (redisLock.tryLock(lockKey, 5, 30)) {  // 等待 5s，锁 30s 自动释放
+        try {
+            // 双重检查（已上锁后再查一次）
+            user = redis.get(key);
+            if (user != null) return user;
+
+            user = userRepository.findById(userId).orElse(null);
+            if (user != null) {
+                redis.setex(key, 600, JSON.toJSONString(user));
+            }
+            return user;
+        } finally {
+            redisLock.unlock(lockKey);
+        }
+    } else {
+        // 没拿到锁 → 等一会再查缓存
+        try { Thread.sleep(50); } catch (InterruptedException e) {}
+        return redis.get(key);
+    }
+}
+```
+
+详见 [distributed-lock.md](distributed-lock.md)。
+
+### 3.3 解法：逻辑过期（异步刷新，不阻塞）
+
+```java
+@Data
+public class CacheWrapper<T> {
+    private T data;
+    private long expireTime;   // 逻辑过期时间
+}
+
+// 读缓存
+public UserDTO getById(String userId) {
+    String key = "user:info:" + userId;
+    CacheWrapper<UserDTO> wrapper = redis.get(key);
+    if (wrapper == null) {
+        // 缓存中没有 → 同步回源
+        return loadFromDb(userId);
+    }
+    if (wrapper.getExpireTime() < System.currentTimeMillis()) {
+        // 逻辑过期 → 异步刷新（不等）
+        asyncExecutor.execute(() -> refreshCache(userId));
+    }
+    return wrapper.getData();
+}
+```
+
+## 4. 防雪崩（Cache Avalanche）
+
+### 4.1 场景
+
+某天 0 点批量缓存统一过期（如 100 万 key），0:00:00 → 0:00:01 全部打到 DB。
+
+### 4.2 解法 1：TTL 加随机值
+
+```java
+int baseTtl = 600;  // 10 分钟
+int jitter = RandomUtils.nextInt(0, 60);  // 0 ~ 60 秒随机
+int actualTtl = baseTtl + jitter;
+redisTemplate.opsForValue().set(key, value, Duration.ofSeconds(actualTtl));
+```
+
+### 4.3 解法 2：多级缓存
+
+```
+L1: Caffeine（本地，1s ~ 10s TTL）
+   ↓ 未命中
+L2: Redis（远程，10 分钟 TTL）
+   ↓ 未命中
+L3: DB
+```
+
+详见 [Caffeine 集成](https://github.com/ben-manes/caffeine)。
+
+### 4.4 解法 3：熔断降级
+
+```java
+public UserDTO getById(String userId) {
+    try {
+        return queryWithCache(userId);
+    } catch (RedisConnectionFailureException e) {
+        log.warn("Redis 不可用，降级到 DB 直查", e);
+        // 熔断：直接走 DB
+        return userRepository.findById(userId).orElse(null);
+    }
+}
+```
+
+详见 Sentinel/Hystrix 集成。
+
+## 5. 三种问题速查
+
+| 问题 | 关键点 | 关键解法 |
+|------|--------|---------|
+| 穿透 | key 不存在 | 空值缓存 / 布隆过滤器 |
+| 击穿 | 单 key 热点过期 | 分布式锁 / 逻辑过期 |
+| 雪崩 | 批量 key 同时过期 | TTL 抖动 / 多级缓存 |
+
+## 6. 关联阅读
+
+- [guide.md](guide.md) — 缓存基础
+- [key-design.md](key-design.md) — 缓存 key 设计
+- [distributed-lock.md](distributed-lock.md) — 分布式锁
+- [SKILL.md](../SKILL.md)

package/skills/meritdata-platform-cloud-dev/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: meritdata-platform-cloud-dev
+description: |
+  MeritData Cloud 二开综合执行入口（L2-C / java）。当用户描述"加一个新功能 / 加一个新模块 / 二开整体流程 / 怎么开始 / 第一次做二开 / 跨模块需求 / 新建工程 / 平台能力查询 / 方案设计 / 现有项目新增模块字段接口页面流程"等需求时使用。
+  本入口的 references/modules-mapping.md 是唯一内部知识源，列出 22 个内部模块及其在当前整合包中的对应 skill。
+  与 playbook 分工：playbook 是路由器（告诉用户"用哪个 skill"）；本 skill 是执行引擎（按用户需求"动手生成代码"）。
+  何时不用：用户明确说要查铁律 / 单点平台 API → 走 playbook 路由到对应 L2/L3 skill；纯前端样式调整 → meritdata-platform-frontend。
+metadata:
+  version: "1.0.0"
+  author: rd（执行引擎源于研发 skills/meritdata-cloud-dev v3.1.0，模块映射由本整合包重新组织）
+  source: rd
+  date_added: "2026-09-07"
+  last_modified: "2026-09-07"
+  risk: low
+  layer: L2
+  sub-layer: L2-C
+  stack: java
+allowed-tools: Read, Grep, Glob, AskUserQuestion
+---
+
+# MeritData Cloud 二开综合执行入口（L2-C）
+
+## 触发
+- 用户描述"我要做XX / 怎么开始 / 跨模块需求"且需要**动手生成代码**（不是查 skill 名）
+- 新二开项目冷启动，从需求到上线的完整路径（含代码生成）
+- 复合需求如"现有项目新增一个采购申请模块，保留原工程配置"（生成模块补丁 + DDL + Controller + 前端）
+- 用户问"平台有什么能力 / 跨模块方案设计"
+
+## 不触发
+- 用户明确说要查 skill 名 → 走 `meritdata-platform-playbook`（L1 路由器）
+- 用户明确说"我只想知道用哪个 skill" → 走 `meritdata-platform-playbook`
+- 纯查铁律 / 命名规范 → 直接读 `../../rules/`
+- 单点平台 API（如 cache / nacos-config / lookup-api）→ 走 playbook 路由到 L3
+- 纯前端样式调整 → `meritdata-platform-frontend`
+
+## 与 playbook 的分工
+
+| 维度 | playbook（L1） | 本 skill（L2-C）|
+|------|--------------|--------------|
+| 角色 | 路由器 | 执行引擎 |
+| 用户风格 | "我应该看哪个 skill" | "我来做这个需求" |
+| 输出 | 路由建议 + skill 引用 | 模块代码、DDL、SQL migration、验证结果 |
+| 复合需求 | 多 skill 串联（典型流程）| 主入口 + 补充 modules（强契约）|
+
+**强契约**：一个请求只能有一个主入口；复合需求由本 skill 内部加载补充 modules，不让用户逐个选择。
+
+## 路由
+
+### 路径 A：识别用户意图
+- **新工程 / 存量新增模块** → `references/modules-mapping.md §模块 4: merit-cloud-gen`
+- **跨模块方案设计** → `references/modules-mapping.md §模块 1: merit-cloud-platform`（能力图谱入口）
+- **多表关系 / 聚合建模** → `references/modules-mapping.md §模块 5: merit-cloud-domain-model`
+- **数据边界 / Feign / 跨服务契约** → `§模块 6: merit-cloud-data-boundary` / `§模块 7: merit-cloud-feign-api`
+- **接入平台能力**（cache / config / bpm / msg-job / ...）→ 对应模块路由到当前 L2/L3 skill
+
+### 路径 B：识别项目模式
+- `project_mode: new` — 新工程，生成 scaffold
+- `project_mode: existing` — 存量项目，读取 POM + 源码 + 包结构 + 前端依赖，**不生成 scaffold**，做符号级最小变更
+
+### 路径 C：确认平台版本
+- 优先读取项目真实版本；用户未指定且无法读取时，提示默认 `6.13.2`，也允许填写其他已支持版本
+
+### 路径 D：执行场景契约
+- 读取 [references/scenario-contract.md](references/scenario-contract.md) 选择动作（能力查询 / 集成查询 / 方案设计 / 新工程 / 存量新增 / 已有模块扩展 / 项目验证）
+- 按 [references/skill-suite.json](references/skill-suite.json) 的 `route_scenarios` 选择主入口 + 补充 modules
+
+## 前置约束
+- 所有目标 skill 的铁律都在 `../../rules/code-dev-rules.md §八`，必须先读
+- 二开业务库不得连接或映射 cloud 平台表（4 铁律之一）；人员/组织/角色/字典等只保存稳定 ID/code，通过已核验 Feign/API 批量装配
+- 模块映射详情见 [references/modules-mapping.md](references/modules-mapping.md)（22 个内部模块 → 当前 14 个整合包 skill 的路由映射）
+
+## 输出契约
+- 输出"场景路径 → 能力选择 → 调用边界 → 版本证据 → 风险 → 验证"
+- 必给"能力路径 / 新增修改文件 / SQL migration / 验证结果 / 剩余 GAP / 人工联调项"
+- 不生成 AI 开发 Journal，不执行 Git/SVN 提交（提交由用户手动完成）
+
+## 相关资源
+- [modules-mapping.md](references/modules-mapping.md) — 22 modules → 当前 L2/L3 路由映射
+- [scenario-contract.md](references/scenario-contract.md) — 7 个动作的路由契约
+- [skill-suite.json](references/skill-suite.json) — 22 modules 元数据 + 12 路由场景
+- [skill-suite.schema.json](references/skill-suite.schema.json) — skill-suite.json 的 schema

package/skills/meritdata-platform-cloud-dev/references/modules-mapping.md

@@ -0,0 +1,162 @@
+# 22 个内部模块 → 当前整合包 skill 路由映射
+
+> **目的**：把研发版 `meritdata-cloud-dev` v3.1.0 的 22 个内部模块（`modules/<name>/module.md`）映射到当前 `meritdata-platform-suite/` v2.1.0 的 L2/L3 skill。
+> **来源**：研发 skills/meritdata-cloud-dev/modules/（22 个 subdirectory）
+> **重组原则**：modules 内容大部分已被当前 L2/L3 skill 吸收或拆分；本文件是**路由索引**，不是内容复制。
+
+---
+
+## 1. 处置类型图例
+
+| 标记 | 含义 | 数量 |
+|:----:|------|:----:|
+| ✅ **直接复用** | 当前已有同名/同名 skill | 14 |
+| 🔄 **合并入** | 当前多个 L2/L3 skill 合并覆盖 | 0（独立计数）|
+| ⚠️ **疑似合并** | 当前某 skill 部分覆盖，**待复核** | 0（独立计数）|
+| ❌ **缺失（待补）**| 当前无对应 skill，需新增 | 6 |
+| 🔀 **已拆分** | 1 个模块 → 当前多个 L2/L3 | 2（core / msg-job / http-client）|
+
+> **数字校验**：22 = 14 直接 + 8 缺口相关（6 缺失 + 2 拆分）
+
+---
+
+## 2. 22 个模块完整映射表
+
+| # | 模块 ID | 主题 | 处置 | 当前对应 skill | 差距 / 待补 |
+|:-:|--------|------|:----:|-------------|-----------|
+| 1 | `merit-cloud-platform` | 平台能力图谱入口 | 🔀 **自身**| `meritdata-platform-cloud-dev`（自身）| ✅ 本 skill 就是该能力的载体 |
+| 2 | `merit-cloud-gen` | 工程生成（新工程 + 存量增量）| ✅ 直接复用 | `meritdata-bootstrap-2nd-dev` + `meritdata-platform-2nd-dev-check` | ✅ 已有 L4 工具对应 |
+| 3 | `merit-code-spec` | 代码规范与质量 | ✅ 直接复用 | `meritdata-platform-code-spec` + `meritdata-platform-code-review` | ✅ 已有 L2-M 对应 |
+| 4 | `merit-skill-governance` | skill 治理（自动校验）| ✅ 直接复用 | `tools/skill-vetter` + `tools/skill-stocktake` + `tools/skill-authoring-workflow` | ✅ 已有 L0 治理工具对应 |
+| 5 | `merit-cloud-domain-model` | 多表 / 聚合建模 | ✅ 直接复用 | `meritdata-platform-domain-model` | ✅ 已有 L2-M 对应 |
+| 6 | `merit-cloud-data-boundary` | cloud/业务库隔离 | ✅ 直接复用 | `meritdata-platform-data-boundary` | ✅ 已有 L2-M 对应 |
+| 7 | `merit-cloud-feign-api` | Feign + 跨服务契约 | 🔀 **合并入**| `meritdata-platform-data-access`（§Feign 装配）| ✅ 内容已合并，无独立 skill 必要 |
+| 8 | `merit-cloud-cache` | 多级缓存 | ✅ 直接复用 | `meritdata-platform-cache` | ✅ 已有 L3-C 对应 |
+| 9 | `merit-cloud-config` | Nacos 配置中心 | ✅ 直接复用 | `meritdata-platform-nacos-config` + `meritdata-platform-platform-config` | ✅ 已有 L3-C 对应 |
+| 10 | `merit-cloud-datasource` | 数据源（动态连接池 + 元数据）| ❌ **缺失**| — | ⚠️ 建议 v2.2.0 P1：在 `meritdata-platform-data-access` 加 references/datasource.md |
+| 11 | `merit-cloud-utils` | 工具类（日期 / ID / 加解密）| 🔀 **已拆分** | `meritdata-platform-session` + `meritdata-platform-sm-crypto` | ✅ 内容分散到 L3 |
+| 12 | `merit-cloud-logging` | 操作审计日志 | ✅ 直接复用 | `meritdata-platform-operation-log` | ✅ 已有 L3-C 对应 |
+| 13 | `meritdata-platform-bpm` | BPM 流程引擎 | ✅ 直接复用 | `meritdata-platform-bpm` | ✅ 已有 L2-C 对应 |
+| 14 | `merit-cloud-msg-job` | 消息 + 调度 | 🔀 **已拆分** | `meritdata-platform-job` + `meritdata-platform-message-center` | ✅ 内容已拆分 |
+| 15 | `meritdata-platform-impexp` | Excel 导入导出 | ✅ 直接复用 | `meritdata-platform-impexp` | ✅ 已有 L2-C 对应 |
+| 16 | `merit-cloud-file` | 业务附件（上传/下载/清理）| ❌ **缺失**| — | ⚠️ 建议 v2.2.0 P1：新建 `meritdata-platform-file`（L3-C）|
+| 17 | `meritdata-platform-org-user-api` | 同 JVM 组织/人员/权限 | 🔀 **已合并**| `meritdata-platform-org-user-api` + `meritdata-platform-lookup-api` + `meritdata-platform-permission` | ✅ 3 个 L3 覆盖 |
+| 18 | `meritdata-platform-data-access` | 同 JVM 平台实体 + QueryDSL | ✅ 直接复用 | `meritdata-platform-data-access` | ✅ 已有 L2-C 对应 |
+| 19 | `meritdata-platform-frontend` | 前端组件库 | ✅ 直接复用 | `meritdata-platform-frontend` + `meritdata-platform-ui-components` | ✅ 已有 L2-F + L3-F 对应 |
+| 20 | `merit-cloud-http-client` | 前端 HTTP 客户端 + 服务注册 | ❌ **缺失**| — | ⚠️ 建议 v2.2.0 P2：并入 `meritdata-platform-frontend` references/http-client.md |
+| 21 | `merit-cloud-webapi` | 对外 WebAPI（App-Key/Token）| ❌ **缺失**| — | ⚠️ 建议 v2.2.0 P2：并入 `meritdata-platform-data-access` references/webapi.md |
+| 22 | `merit-cloud-masterdata-sync` | 主数据同步（HR / 组织增量）| ❌ **缺失**| — | ⚠️ 建议 v2.2.0 P2：并入 `meritdata-platform-org-user-api` references/masterdata-sync.md |
+
+---
+
+## 3. 已落地映射（14 个，✅ + 🔀 已合并/拆分）
+
+| 处置 | 模块数 | 模块列表 |
+|------|:----:|---------|
+| ✅ 直接复用（同名/同义）| 11 | platform / gen / spec / governance / domain-model / data-boundary / cache / config / logging / bpm / impexp / data-access（11+1）|
+| 🔀 合并入 L2-C 已有 skill | 2 | feign-api → data-access；platform-entities → data-access |
+| 🔀 已拆分到 L3 多 skill | 3 | utils → session + sm-crypto；msg-job → job + message-center；org-user-api → org-user-api + lookup-api + permission |
+
+**14 个已落地** = 11 直接复用 + 3 拆分/合并
+
+---
+
+## 4. 缺失模块详细说明（6 个，待 v2.2.0+ 补齐）
+
+### 4.1 `merit-cloud-file`（业务附件）
+
+| 项 | 内容 |
+|----|------|
+| 主题 | 业务附件上传、回显、下载、删除、孤儿清理 |
+| 触发关键词 | 上传附件 / 下载文件 / 附件预览 / 孤儿文件清理 |
+| 涉及接口 | `FileUploadController` / `IFileService` / `BizFileController` |
+| 优先级 | **P1**（高频但当前缺失）|
+| 建议 | 新建 `meritdata-platform-file`（L3-C / java），SKILL.md + references/upload.md + references/orphan-cleanup.md |
+
+### 4.2 `merit-cloud-datasource`（数据源元数据）
+
+| 项 | 内容 |
+|----|------|
+| 主题 | 数据源连通性 + schema/table/column 元数据 + 动态连接池 |
+| 触发关键词 | 数据源配置 / 多数据源 / 动态连接池 / 元数据查询 |
+| 优先级 | **P1**（存量项目接入常用）|
+| 建议 | 不独立 skill，在 `meritdata-platform-data-access/references/datasource.md` 加子文档 |
+
+### 4.3 `merit-cloud-http-client`（前端 HTTP 客户端）
+
+| 项 | 内容 |
+|----|------|
+| 主题 | 前端跨服务调用 + 服务注册 + 网关签名 |
+| 触发关键词 | 前端跨服务 / Axios 拦截器 / 网关签名 |
+| 优先级 | **P2**（前端主 skill 已覆盖大部分）|
+| 建议 | 并入 `meritdata-platform-frontend/references/http-client.md` |
+
+### 4.4 `merit-cloud-webapi`（对外 WebAPI）
+
+| 项 | 内容 |
+|----|------|
+| 主题 | 对外发布 WebAPI（App-Key / App-Token / 签名校验）|
+| 触发关键词 | 对外接口 / App-Key / App-Token / 第三方接入 |
+| 优先级 | **P2**（特定业务才用）|
+| 建议 | 并入 `meritdata-platform-data-access/references/webapi.md` |
+
+### 4.5 `merit-cloud-masterdata-sync`（主数据同步）
+
+| 项 | 内容 |
+|----|------|
+| 主题 | HR / 组织 / 人员 / 角色 / 资源增量同步 + 失败重放 |
+| 触发关键词 | HR 同步 / 组织同步 / 增量同步 / 失败重放 |
+| 优先级 | **P2**（仅跨系统集成场景用）|
+| 建议 | 并入 `meritdata-platform-org-user-api/references/masterdata-sync.md` |
+
+### 4.6 `merit-cloud-utils`（工具类）
+
+| 项 | 内容 |
+|----|------|
+| 主题 | 日期工具 / ID 生成 / 加解密工具 |
+| 触发关键词 | 日期工具 / ID 生成器 / 加解密工具类 |
+| 优先级 | —（**已拆分**，无需独立 skill）|
+| 建议 | 已并入 `session` + `sm-crypto`，无需新增 |
+
+> 实际缺失数 = 5（不算已拆分的 utils）
+
+---
+
+## 5. 处置统计
+
+```
+22 个模块
+  ├─ ✅ 直接复用          11（50%）
+  ├─ 🔀 合并入 / 已拆分    5（23%）
+  ├─ ❌ 缺失待补          6（27%）
+       ├─ 待独立 skill    1（file）
+       ├─ 待并入 references 4（datasource / http-client / webapi / masterdata-sync）
+       └─ 已拆分但保留引用 1（utils）
+  └─ 合计                22（100%）
+```
+
+---
+
+## 6. v2.2.0 补齐行动表
+
+| 优先级 | 行动 | 触及模块 | 估算 |
+|:------:|------|---------|------|
+| **P1** | 新建 `meritdata-platform-file`（L3-C / java）| `merit-cloud-file` | 1 天 |
+| **P1** | 在 `data-access/references/` 加 `datasource.md` | `merit-cloud-datasource` | 半天 |
+| P2 | 在 `frontend/references/` 加 `http-client.md` | `merit-cloud-http-client` | 半天 |
+| P2 | 在 `data-access/references/` 加 `webapi.md` | `merit-cloud-webapi` | 半天 |
+| P2 | 在 `org-user-api/references/` 加 `masterdata-sync.md` | `merit-cloud-masterdata-sync` | 半天 |
+| **P0** | **新建 `meritdata-platform-cloud-dev`（本 skill）**| **全部** | **已完成**（v2.2.0）|
+
+---
+
+## 7. 关联资源
+
+| 资源 | 路径 |
+|------|------|
+| 研发版源 modules | `研发skills/skills/meritdata-cloud-dev/modules/`（22 个 module.md）|
+| 研发版 skill-suite.json | `研发skills/skills/meritdata-cloud-dev/references/skill-suite.json` |
+| 研发版 scenario-contract.md | `研发skills/skills/meritdata-cloud-dev/references/scenario-contract.md` |
+| 当前整合包 4 层架构 | `meritdata-platform-suite/README.md §三` |
+| 三方映射清单 | `meritdata-platform-suite/docs/三方skill映射关系清单_20260907.md` |
+| 框架提取文档 | `meritdata-platform-suite/docs/二开12阶段开发流程文档框架提取_20260907.md` |

package/skills/meritdata-platform-cloud-dev/references/scenario-contract.md

@@ -0,0 +1,75 @@
+# 场景契约
+
+> 本文件定义 `meritdata-platform-cloud-dev` 处理的 7 类动作及其路由契约。
+> 来源：研发版 `meritdata-cloud-dev/references/scenario-contract.md` v3.1.0，本文件做了**精简**（移除内部模块细节，保留动作骨架）。
+
+---
+
+## 1. 动作路由（7 类）
+
+| 动作 | 典型输入 | 主要输出 | 内部模块 | 当前整合包对应 skill |
+|------|---------|---------|---------|-------------------|
+| **能力查询** | 平台有什么人员/流程/缓存/附件能力 | 能力路径 + 证据 + 版本 + 边界 | `merit-cloud-platform` | `meritdata-platform-playbook`（L1 路由）+ 本 skill |
+| **集成查询** | 如何接 Feign / 认证 / 流程 / 消息 / 业务审计 | 契约候选 + 依赖 + GAP + 联调清单 | `merit-cloud-feign-api` / `meritdata-platform-bpm` / `merit-cloud-msg-job` / `merit-cloud-logging` | `meritdata-platform-data-access` / `meritdata-platform-bpm` / `meritdata-platform-job` / `meritdata-platform-operation-log` |
+| **方案设计** | 新系统 / 模块关系 / 数据边界 / 接口方案 | 服务 + 数据模型 + 接口 + 验证方案 | `merit-cloud-domain-model` / `merit-cloud-data-boundary` / `meritdata-platform-frontend` | `meritdata-platform-domain-model` / `meritdata-platform-data-boundary` |
+| **新工程** | scaffold + 模块 manifest | 完整前后端工程 + SQL + 文档 + 验证 | `merit-cloud-gen` + `merit-code-spec` + 相关平台模块 | `meritdata-bootstrap-2nd-dev`（L4 工具）+ `meritdata-platform-2nd-dev-check` |
+| **存量新增模块** | project_context + create_module | 模块补丁 + SQL migration + 接入清单 | `merit-cloud-gen` + `merit-cloud-domain-model` + `merit-code-spec` | `meritdata-platform-domain-model` + `meritdata-platform-code-spec` |
+| **已有模块扩展** | 真实源码 + 字段/API/页面/流程需求 | 符号级最小修改 + 迁移 + 回归结果 | `merit-cloud-gen` + `merit-code-spec` + 命中的专项模块 | 各 L2/L3 skill + `meritdata-platform-code-review` |
+| **项目验证** | manifest / 源码目录 / 工程 ZIP | 强制违规 + 建议 + 哈希 + 编译边界 | `merit-code-spec` + `merit-cloud-data-boundary` + 治理工具 | `meritdata-platform-2nd-dev-check`（L4）+ `tools/skill-vetter` + `tools/skill-stocktake` |
+
+---
+
+## 2. 平台版本
+
+- **默认版本**：`6.13.2`
+- **不得静默使用**：必须显式声明用户项目使用的版本
+- **存量项目**：优先从 POM 和真实依赖读取版本
+- **路径/签名/返回包装/依赖**：不可跨版本照搬
+
+---
+
+## 3. 输出状态（5 档）
+
+| 状态 | 含义 | 处置 |
+|------|------|------|
+| `PASS` | 适用门禁通过且无声明缺口 | 可交付 |
+| `PASS_WITH_SERVICE_REQUIREMENTS` | 平台语义存在，远程契约尚未接入 | 需联调 |
+| `PASS_WITH_DECLARED_GAPS` | 结构可用，但存在明确待联调或待取证能力 | 需补 GAP |
+| `NOT_RUN_REQUIRES_MERGE` | 存量模块补丁必须合入原项目后构建 | 不宣称编译通过 |
+| `FAIL` | 触发规范 / 数据边界 / manifest / 构建强制规则 | 阻断 |
+
+---
+
+## 4. 强契约（与 playbook 的关键差异）
+
+| 维度 | playbook | 本 skill |
+|------|---------|---------|
+| 主入口 | 单 skill 路由 | **一个请求只能有一个主入口** |
+| 复合需求 | 多 skill 串联（flows.md）| **主入口 + 补充 modules 内部加载**，不让用户逐个选择 |
+| 模块来源 | references/intent-routing.md | `references/modules-mapping.md`（22 modules）|
+| 角色 | 路由器 | 执行引擎 |
+
+---
+
+## 5. 决策约束（与 rules/code-dev-rules.md §八 联动）
+
+- 二开业务库**不得**连接或映射 cloud 平台表（`PF_` 前缀）
+- 平台 Entity 与 Q 类**只在同 JVM 且已验证依赖时使用**；独立二开服务**必须**转 Feign/API
+- 平台接口、Swagger/HTTP、Feign、本地 Bean、DTO、版本差异等**只使用随 Skill 发布的离线知识库与已登记证据**；**不得**在生成代码时要求用户提供平台源码、解压/反编译 Jar、访问维护人员本机目录或重新取证
+- 人员、部门、角色、字典、附件、富文本和流程字段**自动联动**对应公共能力（org-user-api / lookup-api / permission / file / bpm）
+- 业务表默认小写蛇形且**不使用** `PF_`；实体使用大驼峰
+- Git/SVN 状态和差异**只读**，提交**始终**由用户手动完成
+- 不生成 AI 开发 Journal；`merit-cloud-logging` 只处理生成后业务系统的运行审计（不处理 AI 自身）
+
+---
+
+## 6. 相关资源
+
+| 资源 | 路径 |
+|------|------|
+| 22 modules 映射 | [modules-mapping.md](modules-mapping.md) |
+| skill 元数据 + 路由场景 | [skill-suite.json](skill-suite.json) |
+| schema | [skill-suite.schema.json](skill-suite.schema.json) |
+| 铁律前置约束 | `meritdata-platform-suite/rules/code-dev-rules.md §八` |
+| 顶层路由器 | `meritdata-platform-suite/skills/meritdata-platform-playbook/SKILL.md` |
+| 研发版源文件 | `研发skills/skills/meritdata-cloud-dev/references/scenario-contract.md` |

package/skills/meritdata-platform-cloud-dev/references/skill-suite.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "./skill-suite.schema.json",
+  "schema_version": "1.0.0",
+  "suite_version": "1.0.0",
+  "platform_profiles_ref": "../references/modules-mapping.md",
+  "policies": {
+    "unknown_skill": "fail",
+    "unknown_platform_version": "fail",
+    "incubating_implicit_route": false,
+    "one_primary_per_route": true
+  },
+  "skills": [
+    {"id":"meritdata-platform-bpm","path":"meritdata-platform-bpm","lifecycle":"stable","kind":"integration","owner":"workflow","primary_capabilities":["workflow.runtime"],"excludes":["file.lifecycle","message.delivery"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-bpm"]},
+    {"id":"merit-cloud-config","path":"merit-cloud-config","lifecycle":"stable","kind":"knowledge","owner":"platform-config","primary_capabilities":["config.runtime","security.policy"],"excludes":["auth.code-generation"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-nacos-config","meritdata-platform-platform-config"]},
+    {"id":"merit-cloud-domain-model","path":"merit-cloud-domain-model","lifecycle":"stable","kind":"design","owner":"architecture","primary_capabilities":["domain.relationship-modeling"],"excludes":["code.rendering"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-domain-model"]},
+    {"id":"merit-cloud-data-boundary","path":"merit-cloud-data-boundary","lifecycle":"stable","kind":"governance","owner":"data-architecture","primary_capabilities":["data.platform-business-isolation"],"excludes":["datasource.metadata","integration.masterdata-sync"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-data-boundary"]},
+    {"id":"merit-cloud-feign-api","path":"merit-cloud-feign-api","lifecycle":"stable","kind":"integration","owner":"service-contract","primary_capabilities":["service.internal-feign"],"excludes":["integration.external-publishing"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-data-access"]},
+    {"id":"merit-cloud-gen","path":"merit-cloud-gen","lifecycle":"stable","kind":"generator","owner":"code-generation","primary_capabilities":["code.rendering","auth.code-generation"],"excludes":["service.fact-ownership"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-bootstrap-2nd-dev","meritdata-platform-2nd-dev-check"]},
+    {"id":"meritdata-platform-impexp","path":"meritdata-platform-impexp","lifecycle":"stable","kind":"integration","owner":"data-exchange","primary_capabilities":["data.excel-import-export"],"excludes":["file.lifecycle"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-impexp"]},
+    {"id":"merit-cloud-logging","path":"merit-cloud-logging","lifecycle":"stable","kind":"integration","owner":"audit","primary_capabilities":["audit.business-operation"],"excludes":[],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-operation-log"]},
+    {"id":"merit-cloud-msg-job","path":"merit-cloud-msg-job","lifecycle":"stable","kind":"integration","owner":"message-schedule","primary_capabilities":["message.delivery","schedule.job"],"excludes":["cache.pubsub"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-job","meritdata-platform-message-center"]},
+    {"id":"merit-cloud-platform","path":"merit-cloud-platform","lifecycle":"stable","kind":"router","owner":"platform-architecture","primary_capabilities":["knowledge.capability-graph"],"excludes":["domain.implementation"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-cloud-dev"]},
+    {"id":"meritdata-platform-org-user-api","path":"meritdata-platform-org-user-api","lifecycle":"stable","kind":"integration","owner":"platform-services","primary_capabilities":["service.organization-directory","service.authorization"],"excludes":["service.internal-feign","integration.masterdata-sync"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-org-user-api","meritdata-platform-lookup-api","meritdata-platform-permission"]},
+    {"id":"meritdata-platform-data-access","path":"meritdata-platform-data-access","lifecycle":"beta","kind":"knowledge","owner":"platform-entity-contract","primary_capabilities":["entity.platform-querydsl-index"],"excludes":["data.platform-business-isolation","service.internal-feign"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-data-access"]},
+    {"id":"meritdata-platform-frontend","path":"meritdata-platform-frontend","lifecycle":"stable","kind":"integration","owner":"frontend-platform","primary_capabilities":["ui.platform-components"],"excludes":["http.transport","code.rendering"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-frontend","meritdata-platform-ui-components"]},
+    {"id":"merit-cloud-utils","path":"merit-cloud-utils","lifecycle":"stable","kind":"knowledge","owner":"backend-runtime","primary_capabilities":["runtime.utility-session","runtime.date-id-crypto"],"excludes":["config.runtime"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-session","meritdata-platform-sm-crypto"]},
+    {"id":"merit-code-spec","path":"merit-code-spec","lifecycle":"stable","kind":"governance","owner":"quality","primary_capabilities":["quality.code-policy"],"excludes":["code.rendering"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-code-spec","meritdata-platform-code-review"]},
+    {"id":"merit-skill-governance","path":"merit-skill-governance","lifecycle":"stable","kind":"governance","owner":"skill-governance","primary_capabilities":["governance.skill-suite"],"excludes":["domain.implementation"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["tools/skill-vetter","tools/skill-stocktake","tools/skill-authoring-workflow"]},
+    {"id":"merit-cloud-cache","path":"merit-cloud-cache","lifecycle":"stable","kind":"integration","owner":"platform-runtime","primary_capabilities":["cache.kv","cache.hash","cache.queue","cache.counter","cache.pubsub"],"excludes":["message.delivery","lock.reliable-distributed"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-cache"]},
+    {"id":"merit-cloud-file","path":"merit-cloud-file","lifecycle":"beta","kind":"integration","owner":"file-lifecycle","primary_capabilities":["file.lifecycle","file.security"],"excludes":["data.excel-import-export","workflow.runtime"],"supported_profiles":{"6.12.1":"compatible","6.13.2":"verified"},"maps_to":[],"gap":"待补：附件上传/下载/孤儿清理独立 references"},
+    {"id":"merit-cloud-datasource","path":"merit-cloud-datasource","lifecycle":"beta","kind":"integration","owner":"data-platform","primary_capabilities":["datasource.metadata","datasource.dynamic-pool","datasource.safe-sql"],"excludes":["domain.repository","data.etl"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified-distribution"},"maps_to":[],"gap":"待补：数据源元数据 + 动态连接池 references"},
+    {"id":"merit-cloud-webapi","path":"merit-cloud-webapi","lifecycle":"beta","kind":"integration","owner":"external-api","primary_capabilities":["webapi.catalog","webapi.app-auth"],"excludes":["service.internal-feign","integration.masterdata-sync"],"supported_profiles":{"6.12.1":"compatible","6.13.2":"verified"},"maps_to":[],"gap":"待补：对外 WebAPI（App-Key/Token）references"},
+    {"id":"merit-cloud-masterdata-sync","path":"merit-cloud-masterdata-sync","lifecycle":"beta","kind":"integration","owner":"masterdata-integration","primary_capabilities":["integration.masterdata-sync"],"excludes":["service.organization-directory","data.etl"],"supported_profiles":{"6.12.1":"compatible","6.13.2":"verified"},"maps_to":[],"gap":"待补：HR/组织人员同步（增量同步 + 失败重放）references"},
+    {"id":"merit-cloud-http-client","path":"merit-cloud-http-client","lifecycle":"beta","kind":"integration","owner":"frontend-transport","primary_capabilities":["http.transport","http.service-registry"],"excludes":["ui.platform-components","service.internal-feign","webapi.app-auth"],"supported_profiles":{"6.12.1":"compatible","6.13.2":"verified"},"maps_to":[],"gap":"待补：前端 HTTP 客户端 + 服务注册 references"}
+  ],
+  "route_scenarios": [
+    {"id":"route.existing-add-module","prompt":"在现有项目新增采购申请模块，保留原工程配置","expected_primary":"merit-cloud-gen","allowed_supplemental":["merit-cloud-domain-model","merit-code-spec","meritdata-platform-impexp"]},
+    {"id":"route.existing-add-workflow","prompt":"给现有报销模块增加审批流程、人员选择和消息通知","expected_primary":"merit-cloud-gen","allowed_supplemental":["meritdata-platform-bpm","meritdata-platform-org-user-api","merit-cloud-msg-job","merit-code-spec"]},
+    {"id":"route.person-selector","prompt":"业务表单选择人员并回填名称","expected_primary":"meritdata-platform-org-user-api","allowed_supplemental":["meritdata-platform-frontend","merit-cloud-gen"]},
+    {"id":"route.workflow-attachment","prompt":"审批表上传附件并随流程归档","expected_primary":"meritdata-platform-bpm","allowed_supplemental":["merit-cloud-file"]},
+    {"id":"route.excel-import","prompt":"批量导入 Excel 并导出错误明细","expected_primary":"meritdata-platform-impexp","allowed_supplemental":["merit-cloud-logging"]},
+    {"id":"route.cache-ttl","prompt":"用平台 Redis 做租户隔离的 TTL 缓存和原子计数","expected_primary":"merit-cloud-cache","allowed_supplemental":["merit-cloud-config","merit-code-spec"]},
+    {"id":"route.business-file","prompt":"普通业务附件上传、回显、下载、删除和孤儿清理","expected_primary":"merit-cloud-file","allowed_supplemental":["meritdata-platform-frontend","merit-cloud-config"],"gap":"需先补 merit-cloud-file references"},
+    {"id":"route.datasource-metadata","prompt":"检查数据源连通性并读取 schema table column 元数据","expected_primary":"merit-cloud-datasource","allowed_supplemental":["merit-cloud-config"],"gap":"需先补 merit-cloud-datasource references"},
+    {"id":"route.cloud-data-boundary","prompt":"二开项目查询 cloud 库人员组织数据并设计多表查询","expected_primary":"merit-cloud-data-boundary","allowed_supplemental":["merit-cloud-domain-model","merit-cloud-feign-api","merit-cloud-gen"]},
+    {"id":"route.publish-webapi","prompt":"向外部 ERP 发布一个带 App-Key 和 App-Token 的接口","expected_primary":"merit-cloud-webapi","allowed_supplemental":["merit-cloud-logging"],"gap":"需先补 merit-cloud-webapi references"},
+    {"id":"route.sync-masterdata","prompt":"把外部组织人员角色增量同步到平台并支持失败重放","expected_primary":"merit-cloud-masterdata-sync","allowed_supplemental":["merit-cloud-webapi","merit-cloud-logging"],"gap":"需先补 merit-cloud-masterdata-sync references"},
+    {"id":"route.frontend-multi-service","prompt":"前端同时调用业务、system-manager 和 bpm-engine 并保留平台签名","expected_primary":"merit-cloud-http-client","allowed_supplemental":["meritdata-platform-frontend","merit-cloud-gen"],"gap":"需先补 merit-cloud-http-client references"},
+    {"id":"route.platform-entity-qclass","prompt":"同 JVM 项目核对平台人员实体字段并用 QueryDSL Q 类查询","expected_primary":"meritdata-platform-data-access","allowed_supplemental":["meritdata-platform-org-user-api","merit-cloud-config"]}
+  ],
+  "aliases": []
+}

package/skills/meritdata-platform-cloud-dev/references/skill-suite.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://meritdata.example/schemas/skill-suite.schema.json",
+  "type": "object",
+  "required": ["schema_version", "suite_version", "platform_profiles_ref", "policies", "skills", "route_scenarios", "aliases"],
+  "properties": {
+    "skills": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "path", "lifecycle", "kind", "owner", "primary_capabilities", "excludes", "supported_profiles"],
+        "properties": {
+          "id": {"type": "string", "pattern": "^[a-z0-9-]+$"},
+          "path": {"type": "string"},
+          "lifecycle": {"enum": ["incubating", "beta", "stable", "deprecated", "retired"]},
+          "primary_capabilities": {"type": "array", "minItems": 1, "items": {"type": "string"}, "uniqueItems": true},
+          "excludes": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
+          "supported_profiles": {"type": "object", "minProperties": 1}
+        }
+      }
+    }
+  }
+}

package/skills/meritdata-platform-code-review/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: meritdata-platform-code-review
+description: |
+  代码审查。Java 代码审查清单；性能/安全/可维护性维度；code-spec 规则的实施场景。
+  触发场景：二开代码 PR review / Java 编码规范检查 / 性能问题排查 / 安全漏洞扫描。
+  何时不用：数据访问专项 → 用 data-access-review；测试用例 → 用 test-case。
+metadata:
+  version: "1.0.0"
+  author: petroleum+rd
+  source: petroleum+rd
+  date_added: "2026-09-07"
+  last_modified: "2026-09-07"
+  risk: medium
+  layer: L2
+  sub-layer: L2-M
+  stack: methodology
+allowed-tools: Read, Grep, Glob, Bash
+---
+
+# 代码审查（code-review）
+
+## 触发
+- 二开 Java 代码 PR review
+- 性能问题代码定位（SQL/N+1/缓存）
+- 安全漏洞代码扫描（注入/越权/敏感）
+- 可维护性评估（命名/复杂度/重复）
+
+## 不触发
+- 数据访问专项（PF_/Feign/Entity）→ 用 `meritdata-platform-data-access-review`
+- 测试用例设计 → 用 `meritdata-platform-test-case`
+- 业务模型设计 → 用 `meritdata-platform-domain-model`
+
+## 前置约束
+- 审查**必须**涵盖 4 维度：正确性 / 性能 / 安全 / 可维护性
+- 严重问题（数据泄露/事务错误）**零容忍**
+- 审查结论**必须**有依据（具体行号 + 反例 + 修复建议）
+
+## 路由
+- 4 维度审查清单 → [references/guide.md](references/guide.md)
+- 性能审查（N+1/缓存/SQL）→ [references/performance.md](references/performance.md)
+- 安全审查（注入/越权/敏感）→ [references/security.md](references/security.md)
+- [SKILL.md](../SKILL.md)