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

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

@@ -1,141 +0,0 @@
-# 平台缓存指南（cache）
-
-> **核心约束**：缓存 key **必须包含用户/租户标识**；敏感数据禁止缓存；必须有 TTL。
-
----
-
-## 1. 引入依赖
-
-```xml
-<dependency>
-    <groupId>org.springframework.boot</groupId>
-    <artifactId>spring-boot-starter-data-redis</artifactId>
-</dependency>
-<dependency>
-    <groupId>org.springframework.boot</groupId>
-    <artifactId>spring-boot-starter-cache</artifactId>
-</dependency>
-```
-
-## 2. application.yml
-
-```yaml
-spring:
-  redis:
-    host: ${REDIS_HOST:localhost}
-    port: ${REDIS_PORT:6379}
-    password: ${REDIS_PASSWORD:}
-    database: 0
-    timeout: 3000
-    lettuce:
-      pool:
-        max-active: 20
-        max-idle: 10
-        min-idle: 5
-        max-wait: 2000
-
-  cache:
-    type: redis
-    redis:
-      time-to-live: 600000      # 默认 TTL 10 分钟
-      cache-null-values: false   # 不缓存 null
-```
-
-## 3. @Cacheable 用法
-
-### 3.1 基本用法
-
-```java
-@Cacheable(value = "user", key = "#userId")
-public UserDTO getById(String userId) {
-    return userRepository.findById(userId).orElse(null);
-}
-```
-
-### 3.2 ✅ 正确：缓存 key 带用户/租户标识
-
-```java
-// ✅ 正确：缓存 key 包含 userId 和 tenantId 实现隔离
-@Cacheable(value = "user", key = "#userId + ':' + T(SecurityUtils).getCurrentTenantId()")
-public UserDTO getById(String userId) { ... }
-
-// ✅ 正确：缓存 key 包含 orgId 实现组织隔离
-@Cacheable(value = "orderList", key = "T(SecurityUtils).getCurrentOrgId() + ':' + #status")
-public List<Order> listByStatus(String status) { ... }
-```
-
-### 3.3 ❌ 反例：缓存 key 全局共享
-
-```java
-// ❌ 错：key 只有 userId → 不同租户的数据混淆
-@Cacheable(value = "user", key = "#userId")
-public UserDTO getById(String userId) { ... }
-
-// ❌ 错：常量 key → 所有人都共享同一份
-@Cacheable(value = "globalConfig", key = "'config'")
-public Config getConfig() { ... }
-```
-
-## 4. 缓存注解
-
-| 注解 | 用途 |
-|------|------|
-| `@Cacheable` | 查：先查缓存，没有再调方法 |
-| `@CachePut` | 改：每次都执行方法，并更新缓存 |
-| `@CacheEvict` | 删：清除缓存 |
-| `@Caching` | 组合多个缓存操作 |
-
-```java
-@Caching(
-    put = @CachePut(value = "user", key = "#user.id"),
-    evict = @CacheEvict(value = "userList", allEntries = true)
-)
-public UserDTO update(UserDTO user) { ... }
-```
-
-## 5. RedisTemplate 用法（精细控制）
-
-```java
-@Autowired
-private StringRedisTemplate redisTemplate;
-
-public void demo() {
-    // 设置（带 TTL）
-    redisTemplate.opsForValue().set("key", "value", Duration.ofMinutes(10));
-
-    // 获取
-    String value = redisTemplate.opsForValue().get("key");
-
-    // 删除
-    redisTemplate.delete("key");
-
-    // 批量删除（按前缀）
-    Set<String> keys = redisTemplate.keys("user:10001:*");
-    redisTemplate.delete(keys);
-}
-```
-
-## 6. 缓存穿透 / 击穿 / 雪崩
-
-详见 [resilience.md](resilience.md)。
-
-## 7. 分布式锁
-
-详见 [distributed-lock.md](distributed-lock.md)。
-
-## 8. ❌ 反模式汇总
-
-| 反模式 | 后果 |
-|--------|------|
-| 缓存 key 无用户标识 | 数据泄露 / 跨租户串数据 |
-| 缓存无 TTL | 内存泄漏 |
-| 缓存敏感数据（密码/token）| 安全风险 |
-| 用 @Cacheable 缓存 null | 缓存穿透 |
-| 缓存更新不及时 | 数据不一致 |
-
-## 9. 关联阅读
-
-- [key-design.md](key-design.md) — 缓存 key 设计
-- [resilience.md](resilience.md) — 防穿透 / 击穿 / 雪崩
-- [distributed-lock.md](distributed-lock.md) — 分布式锁
-- [SKILL.md](../SKILL.md)

package/skills/meritdata-platform-cache/references/key-design.md

@@ -1,167 +0,0 @@
-# 缓存 key 设计规范（cache）
-
-> 缓存 key 是缓存的"身份证"。设计不当 → 数据泄露 / 跨租户串数据 / 缓存失效。
-
----
-
-## 1. key 命名格式
-
-### 1.1 三段式命名
-
-```
-{业务域}:{资源名}:{业务标识[:扩展标识]}
-```
-
-| 段 | 含义 | 示例 |
-|----|------|------|
-| 业务域 | 模块名（防止不同模块 key 冲突）| `order`、`user`、`config` |
-| 资源名 | 缓存的对象类型 | `info`、`list`、`count` |
-| 业务标识 | 缓存对象的唯一 ID | `userId`、`orderNo` |
-| 扩展标识 | 可选，用于二级隔离 | `tenantId`、`orgId` |
-
-### 1.2 ✅ 正确示例
-
-```java
-// 用户信息（单对象）
-"user:info:" + userId + ":" + tenantId
-
-// 订单列表（按用户 + 状态）
-"order:list:user:" + userId + ":status:" + status + ":" + tenantId
-
-// 字典项（全局但按租户）
-"dict:items:type:" + dictType + ":tenant:" + tenantId
-
-// 配置项（全局共享）
-"config:global:feature_flags"
-```
-
-### 1.3 ❌ 反例
-
-```java
-// ❌ 无业务域前缀（key 冲突风险）
-userId + "_info"
-
-// ❌ 无租户标识（跨租户串数据）
-"user:info:" + userId
-
-// ❌ 把敏感数据放 key
-"user:info:" + userId + ":" + phone  // phone 进 key 可能被日志泄露
-
-// ❌ key 太长（>200 字符）
-"order:list:" + a + ":" + b + ":" + c + ":" + d + ":" + e + ":" + f + ...
-```
-
-## 2. 必须包含的标识
-
-### 2.1 用户级隔离（个人数据）
-
-```java
-// ✅ 正确：key 包含 userId
-"user:info:" + userId
-```
-
-### 2.2 租户/组织级隔离（多租户系统）
-
-```java
-// ✅ 正确：key 包含 tenantId
-"order:list:tenant:" + tenantId + ":user:" + userId
-```
-
-### 2.3 全局共享（无隔离需求）
-
-```java
-// ✅ 正确：配置项等全局数据
-"config:global:datasource"
-```
-
-## 3. TTL 设计
-
-| 数据类型 | 推荐 TTL | 理由 |
-|----------|---------|------|
-| 用户信息 | 10 ~ 30 分钟 | 中等频次更新 |
-| 配置项 | 5 ~ 30 分钟 | 配合 @NacosValue 自动刷新 |
-| 字典项 | 1 ~ 24 小时 | 很少变 |
-| 会话/token | 跟随 token 过期 | 严格匹配 |
-| 临时计算结果 | 1 ~ 5 分钟 | 高频过期 |
-| 列表查询 | 30 秒 ~ 5 分钟 | 频繁变更 |
-
-```java
-// RedisTemplate 设置 TTL
-redisTemplate.opsForValue().set(key, value, Duration.ofMinutes(10));
-
-// @Cacheable 设置 TTL
-@Cacheable(value = "user", key = "#userId", cacheManager = "tenMinutesCacheManager")
-```
-
-## 4. 删除策略
-
-### 4.1 精确删除
-
-```java
-// 删除单个 key
-redisTemplate.delete("user:info:" + userId);
-
-// 删除同前缀的多个 key（慎用 KEYS，性能差）
-Set<String> keys = redisTemplate.keys("user:info:10001:*");
-redisTemplate.delete(keys);
-
-// 推荐：用 SCAN 代替 KEYS
-ScanOptions options = ScanOptions.scanOptions().match("user:info:10001:*").count(100);
-Cursor<byte[]> cursor = redisTemplate.executeWithStickyConnection(
-    connection -> connection.scan(options)
-);
-```
-
-### 4.2 模糊删除（按模式）
-
-```java
-public void evictByPrefix(String prefix) {
-    Set<String> keys = redisTemplate.keys(prefix + "*");
-    if (keys != null && !keys.isEmpty()) {
-        redisTemplate.delete(keys);
-    }
-}
-```
-
-## 5. 序列化
-
-### 5.1 JSON 序列化（推荐）
-
-```java
-@Bean
-public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
-    RedisTemplate<String, Object> template = new RedisTemplate<>();
-    template.setConnectionFactory(factory);
-
-    ObjectMapper mapper = new ObjectMapper();
-    mapper.activateDefaultTyping(
-        mapper.getPolymorphicTypeValidator(),
-        ObjectMapper.DefaultTyping.NON_FINAL,
-        JsonTypeInfo.As.PROPERTY
-    );
-
-    Jackson2JsonRedisSerializer<Object> serializer =
-        new Jackson2JsonRedisSerializer<>(mapper, Object.class);
-
-    template.setKeySerializer(new StringRedisSerializer());
-    template.setValueSerializer(serializer);
-    return template;
-}
-```
-
-### 5.2 序列化选型
-
-| 序列化方式 | 优点 | 缺点 |
-|-----------|------|------|
-| JSON | 可读、跨语言、通用 | 体积较大、性能一般 |
-| Protobuf | 高性能、小体积 | 不可读、需 schema |
-| JDK | 默认 | 体积大、不可读、版本敏感 |
-
-**推荐**：调试阶段用 JSON；性能敏感用 Protobuf。
-
-## 6. 关联阅读
-
-- [guide.md](guide.md) — 缓存基础用法
-- [resilience.md](resilience.md) — 防穿透/击穿/雪崩
-- [distributed-lock.md](distributed-lock.md) — 分布式锁
-- [SKILL.md](../SKILL.md)

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

@@ -1,181 +0,0 @@
-# 缓存防穿透 / 击穿 / 雪崩（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/references/modules-mapping.md

@@ -1,162 +0,0 @@
-# 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` |