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

package/skills/meritdata-platform-cache/SKILL.md

@@ -1,42 +1,53 @@
 ---
 name: meritdata-platform-cache
-description: |
-  平台缓存（Redis）。CacheManager 配置、@Cacheable 用法、缓存 key 设计（必须包含用户标识）、过期策略、缓存穿透/击穿/雪崩防护、分布式锁。
-  触发场景：需要加缓存提升查询性能；需要分布式锁；需要防缓存雪崩。
-  何时不用：纯业务逻辑 → 用 code-spec；Feign 调用 → 用 data-access。
+description: MeritData Redis 缓存专项。用于缓存键设计、缓存更新策略、分布式锁、计数器、过期时间控制。
 metadata:
   version: "1.0.0"
-  author: petroleum+rd
-  source: petroleum+rd
-  date_added: "2026-09-07"
-  last_modified: "2026-09-07"
-  risk: medium
-  layer: L3
-  sub-layer: L3-C
-  stack: java
-allowed-tools: Read, Grep, Glob, Bash
+  author: 技术平台部门架构组
+  source: company
+  date_added: "2026-09-01"
+  last_updated: "2026-09-01"
+  risk: low
+  allowed-tools: Read, Grep, Glob
 ---
 
-# 平台缓存（cache）
-
-## 触发
-- 列表/详情查询性能差，需要加 Redis 缓存
-- 需要分布式锁防止并发
-- 防止缓存击穿 / 雪崩 / 穿透
-- 需要缓存预热 / 主动刷新
-
-## 不触发
-- 纯业务逻辑 → 用 `meritdata-platform-code-spec`
-- 跨服务数据访问 → 用 `meritdata-platform-data-access`
-- Nacos 配置中心 → 用 `meritdata-platform-nacos-config`
-
-## 前置约束
-- 缓存 key **必须包含用户/租户标识**实现隔离（详见 [rules/performance-rules.md §二](../../rules/performance-rules.md)）
-- 缓存必须有 TTL，防止内存泄漏
-- 敏感数据（密码 / token）**禁止**缓存
-
-## 路由
-- Spring Cache + Redis 接入 → [references/guide.md](references/guide.md)
-- 缓存 key 设计 + 用户隔离 → [references/key-design.md](references/key-design.md)
-- 防穿透 / 击穿 / 雪崩 → [references/resilience.md](references/resilience.md)
-- 分布式锁 → [references/distributed-lock.md](references/distributed-lock.md)
+## ⭐ MUST DO
+
+**缓存 key 必须包含用户/租户标识防止数据混淆；过期时间必须显式设置；缓存更新采用 Cache-Aside 策略。**
+
+## 触发条件 / 不适用
+
+**适用**：
+- 缓存键设计与命名规范
+- 分布式锁
+- 缓存预热 / 失效
+- 计数器与限流
+
+**不适用**：
+- 通用 Redis 使用 → `meritdata-platform-core/references/cache.md`
+
+## 主题路由
+
+| 任务 | 优先读取 |
+| --- | --- |
+
+## 工作方式
+
+1. 缓存 key 命名：`{业务域}:{实体}:{userId|tenantId}:{id}`
+2. 显式设置 TTL，禁止永不过期
+3. Cache-Aside：先读缓存，未命中读 DB 并回写
+4. 更新时先更新 DB，再失效缓存（避免脏数据）
+
+## 🚨 常见错误
+
+| 错误 | 后果 | 正确做法 |
+| --- | --- | --- |
+| 缓存 key 无用户标识 | 数据混淆 | 加 userId |
+| 永不过期 | 内存泄漏 | 显式 TTL |
+| 先失效缓存再更新 DB | 脏数据 | 先 DB 再失效 |
+
+## 边界
+
+- **不在本 skill 范围的**：
+  - 后端基础设施 → `meritdata-platform-core`
+- **强制要求**：缓存 key 必含用户/租户标识

package/skills/meritdata-platform-cache/agents/openai.yaml

@@ -0,0 +1,21 @@
+display_name: "MeritData 缓存"
+short_description: "Redis 缓存键设计、分布式锁、缓存策略"
+default_prompt: |
+  meritdata-platform-cache 处理 Redis 缓存专项场景。
+
+  适用场景：
+  - 缓存键设计
+  - 分布式锁
+  - 计数器与限流
+  - 缓存预热与失效
+
+  使用方式：
+  ```
+  meritdata-platform-cache <缓存需求>
+  ```
+
+  强制约束：
+  - 缓存 key 含 userId/tenantId
+  - 显式 TTL（禁止永不过期）
+  - Cache-Aside 策略
+  - 更新时先 DB 再失效缓存

package/skills/meritdata-platform-cache/references/api-quick-ref.md

@@ -0,0 +1,69 @@
+# SysCacheServiceFacade + StringCacheFacade API 速查
+
+## SysCacheServiceFacade（23 方法）
+
+### KV 操作（5）
+
+| 方法 | 签名 |
+|------|------|
+| `put` | `void put(String key, Object value)` |
+| `putExpire` | `void putExpire(String key, Object value, long seconds)` |
+| `get` | `Object get(String key)` |
+| `remove` | `void remove(String key)` |
+| `exists` | `boolean exists(String key)` |
+
+### Hash 操作（3）
+
+| 方法 | 签名 |
+|------|------|
+| `hset` | `void hset(String key, String field, Object value)` |
+| `hget` | `Object hget(String key, String field)` |
+| `hdel` | `void hdel(String key, String field)` |
+
+### 队列（4）
+
+| 方法 | 签名 |
+|------|------|
+| `queuePush` | `void queuePush(String queue, Object item)` |
+| `queuePop` | `Object queuePop(String queue)` |
+| `queueSize` | `long queueSize(String queue)` |
+| `queueRange` | `List<Object> queueRange(String queue, long start, long end)` |
+
+### 集合 / Set（3）
+
+| 方法 | 签名 |
+|------|------|
+| `sadd` | `void sadd(String key, Object... members)` |
+| `smembers` | `Set<Object> smembers(String key)` |
+| `srem` | `void srem(String key, Object... members)` |
+
+### 自增（2）
+
+| 方法 | 签名 |
+|------|------|
+| `incr` | `Long incr(String key, long delta)` |
+| `decr` | `Long decr(String key, long delta)` |
+
+### 发布/订阅（3）
+
+| 方法 | 签名 |
+|------|------|
+| `publish` | `void publish(String channel, Object message)` |
+| `subscribe` | `void subscribe(String channel, MessageHandler handler)` |
+| `unsubscribe` | `void unsubscribe(String channel)` |
+
+### 其他（3）
+
+| 方法 | 签名 |
+|------|------|
+| `expire` | `void expire(String key, long seconds)` |
+| `ttl` | `Long ttl(String key)` |
+| `keys` | `Set<String> keys(String pattern)` |
+
+## StringCacheFacade（3 方法）
+
+| 方法 | 签名 |
+|------|------|
+| `put` | `void put(String key, String value, long seconds)` |
+| `get` | `String get(String key)` |
+| `multiGet` | `List<String> multiGet(List<String> keys)` |

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

@@ -0,0 +1,226 @@
+## 前置条件
+
+Maven 依赖已包含在 `cloud-starter-core` 基础包中，二开项目继承平台脚手架后自动引入，无需额外配置。
+
+## 快速开始
+
+```java
+// 写入缓存（永不过期）
+SysCacheServiceFacade.put("key", value);
+
+// 写入缓存（带过期时间，秒）
+SysCacheServiceFacade.putExpire("key", value, 3600);
+
+// 读取缓存
+Object value = SysCacheServiceFacade.get("key");
+
+// 判断是否存在
+boolean exists = SysCacheServiceFacade.isExist("key");
+
+// 删除缓存
+SysCacheServiceFacade.remove("key");
+```
+
+---
+
+## SysCacheServiceFacade — 通用缓存操作
+
+**完整包路径**: `com.meritdata.tempo.syscache.service.SysCacheServiceFacade`
+
+所有方法均为静态方法，可直接调用。存储 Object 类型。
+
+### 基本操作
+
+#### put(key, value)
+
+写入缓存，**永不过期**。适用于高频访问且不刷新的静态数据。
+
+```java
+SysCacheServiceFacade.put("user:session:" + userId, userSession);
+SysCacheServiceFacade.put("EXCEPTION_EVENT_SESSION" + username, allSessions);
+```
+
+#### putExpire(key, value, seconds)
+
+写入缓存并设置过期时间（秒）。适用于 token、临时数据。
+
+```java
+SysCacheServiceFacade.putExpire("nacosToken", accessToken, 14400);
+SysCacheServiceFacade.putExpire("temp:data:" + id, value, 3600);
+```
+
+#### putExpireAt(key, value, unixTime)
+
+在指定时间点过期，unixTime 为毫秒时间戳。**注意：底层会自动 +3000ms**。
+
+```java
+SysCacheServiceFacade.putExpireAt("event:expire", value, System.currentTimeMillis() + 3600000);
+```
+
+#### get(key) → Object
+
+```java
+Object session = SysCacheServiceFacade.get("user:session:" + userId);
+```
+
+#### isExist(key) → Boolean
+
+```java
+if (SysCacheServiceFacade.isExist("nacosToken")) { /* 刷新或使用 */ }
+```
+
+#### remove(key)
+
+```java
+SysCacheServiceFacade.remove("user:session:" + userId);
+```
+
+### Hash 操作
+
+#### hset(h, hkey, hvalue)
+
+将数据以 Hash 结构存储，常用于用户会话。
+
+```java
+SysCacheServiceFacade.hset("CACHE_SESSION_LIST_KEY", user.getUsername(), user);
+```
+
+#### hget(h, hkey) → Object
+
+```java
+User user = (User) SysCacheServiceFacade.hget("CACHE_SESSION_LIST_KEY", loginName);
+```
+
+#### hgetAll(key) → Map<String, Object>
+
+```java
+Map<String, Object> allUsers = SysCacheServiceFacade.hgetAll("CACHE_SESSION_LIST_KEY");
+```
+
+#### hkeys(h) → Set<String>
+
+```java
+Set<String> fields = SysCacheServiceFacade.hkeys("CACHE_SESSION_LIST_KEY");
+```
+
+#### hvalues(h) → List<Object>
+
+```java
+List<Object> values = SysCacheServiceFacade.hvalues("CACHE_SESSION_LIST_KEY");
+```
+
+#### hdel(h, hkey) → Long
+
+```java
+SysCacheServiceFacade.hdel("CACHE_SESSION_LIST_KEY", loginName);
+```
+
+### 批量操作
+
+#### multiGet(keys) → List<Object>
+
+```java
+List<Object> values = SysCacheServiceFacade.multiGet(Arrays.asList("k1", "k2", "k3"));
+```
+
+### 队列操作
+
+#### enqueue(key, value) → Long — 入队
+
+```java
+SysCacheServiceFacade.enqueue("task_queue", taskData);
+```
+
+#### dequeue(key) → Object — 出队
+
+```java
+Object data = SysCacheServiceFacade.dequeue("task_queue");
+```
+
+#### dequeueList(key) → List<Object> — 批量出队
+
+```java
+List<Object> batch = SysCacheServiceFacade.dequeueList("task_queue");
+```
+
+#### queueSize(key) → Long — 队列长度
+
+```java
+if (SysCacheServiceFacade.queueSize("task_queue") > 100) { /* 告警 */ }
+```
+
+### 计数器
+
+#### increment(k) / increment(k, delta) → Long
+
+```java
+SysCacheServiceFacade.increment("page:views");
+SysCacheServiceFacade.increment("request:count", 1);
+```
+
+#### decrement(k) / decrement(k, delta) → Long
+
+```java
+SysCacheServiceFacade.decrement("stock:count");
+```
+
+### 幂等与分布式锁
+
+`setIfAbsent` 的存在不代表它满足生产分布式锁要求。本资料未证明该 API 具有过期时间、持有者标识和 compare-and-delete 解锁语义，因此不要把它单独用作分布式锁。
+
+优先使用业务唯一约束或幂等键。确需锁时，先确认目标版本提供的原子 API，并同时满足过期时间、持有者 token、`finally` 释放和非持有者不可释放。
+
+#### getAndSet(k, v) → Object
+
+原子性获取旧值并设置新值。
+
+```java
+Object oldToken = SysCacheServiceFacade.getAndSet("user:token:" + userId, newToken);
+```
+
+### 发布订阅
+
+#### publish(channel, message)
+
+```java
+SysCacheServiceFacade.publish("channel:notify", JSON.toJSONString(event));
+```
+
+#### subscribe(channel, ICacheSubscribeListener)
+
+**注意参数顺序**:
+- 对外 API: `subscribe(channel, listener)` — channel 在前
+- 底层调用: `subscribe(listener, channel)` — listener 在前（内部自动调换）
+- 回调接口 `ICacheSubscribeListener.onMessage(msg)` **只接收一个参数 msg**
+
+```java
+SysCacheServiceFacade.subscribe("channel:notify", (msg) -> {
+    System.out.println("收到消息: " + msg);
+});
+```
+
+---
+
+## StringCacheFacade — String 专用缓存
+
+**完整包路径**: `com.meritdata.tempo.syscache.service.StringCacheFacade`
+
+与 SysCacheServiceFacade 用法一致，但键值均为 String 类型。
+
+```java
+StringCacheFacade.put("config:version", "1.0.0");
+String version = StringCacheFacade.get("config:version");
+List<String> values = StringCacheFacade.multiGet(Arrays.asList("k1", "k2"));
+```
+
+---
+
+## 缓存注意事项
+
+1. `SysCacheServiceFacade` 存储 Object，取出时需要强制类型转换
+2. `StringCacheFacade` 只支持 String，无需类型转换
+3. `putExpireAt` 内部会自动 +3000ms
+4. `subscribe` 对外参数顺序和底层不一致，使用时注意
+5. 缓存键避免包含密码、令牌、身份证号或完整会话对象
+
+---

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

@@ -1,81 +1,199 @@
 ---
 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。
+description: MeritData Cloud 6.x 综合开发入口。用于平台能力查询、方案设计、新建工程、存量增量开发、平台知识图谱查询；内部包含 22 个能力模块平铺到 references/modules/，按 references/modules/ 自动路由。
 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"
+  author: 技术平台部门架构组
+  source: company
+  date_added: "2026-09-01"
+  last_updated: "2026-09-01"
   risk: low
-  layer: L2
-  sub-layer: L2-C
-  stack: java
-allowed-tools: Read, Grep, Glob, AskUserQuestion
+  allowed-tools: Read, Grep, Glob, Bash
 ---
 
-# 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
+## ⭐ MUST DO
+
+**作为综合开发入口（领域入口而非编排入口），按 references/modules/ 加载最窄内部模块组合，不暴露模块选择给用户。**
+
+## 触发条件 / 不适用
+
+**适用**：
+- 用户说 `meritdata-platform-cloud-dev`
+- 平台能力查询（"平台有哪些缓存接口？"）
+- 方案设计（"如何设计一个采购模块？"）
+- 新建工程（`project_mode: new`）
+- 存量增量（`project_mode: existing` 的具体开发任务）
+
+**不适用**：
+- 跨 skill 综合需求 → `meritdata-platform-playbook`（编排入口）
+- 单一 skill 的领域问题 → 直接触发对应 skill
+
+## 主题路由
+
+| 任务 | 优先读取 |
+| --- | --- |
+| 能力图谱（22 模块） | [`references/modules/platform.md`](references/modules/platform.md) |
+| 新建工程代码生成 | [`references/modules/gen.md`](references/modules/gen.md) |
+| 平台能力发现 | [`references/modules/platform.md`](references/modules/platform.md) |
+| 领域建模 | [`references/modules/domain-model.md`](references/modules/domain-model.md) |
+| 数据边界 | [`references/modules/data-boundary.md`](references/modules/data-boundary.md) |
+| Feign 与跨服务契约 | [`references/modules/feign-api.md`](references/modules/feign-api.md) |
+| 同 JVM 平台实体 | [`references/modules/platform-entities.md`](references/modules/platform-entities.md) |
+| 前端语义组件 | [`references/modules/ui.md`](references/modules/ui.md) |
+| 代码规范 | [`references/modules/spec.md`](references/modules/spec.md) |
+
+## 工作方式（Step 1/2/3/4/5/6/7/8/9）
+
+### Step 1：识别动作
+
+| 动作 | 路由 |
+|------|------|
+| 能力查询 | 读 `references/modules/platform.md` + 领域 modules |
+| 方案设计 | 读 `domain-model.md` + 领域 modules |
+| 新建工程 | `project_mode: new` → 触发 `gen.md` |
+| 存量增量 | `project_mode: existing` → 基于真实源码做最小修改 |
+| 集成查询 | 读 `feign-api.md` + `integration/references/` |
+| 项目验证 | 触发 `2nd-dev-check` |
+
+### Step 2：识别项目模式
+
+```yaml
+project_mode:
+  new:
+    - 全新工程，无 src/ 目录
+    - 触发 gen.md 生成 scaffold
+  existing:
+    - 已有 pom.xml + src/，核心路径
+    - 读取真实 POM、源码、包结构、前端依赖
+    - 不生成 scaffold
+  existing-legacy:
+    - 5.x 旧版 / 缺平台指纹
+    - 强制先走 2nd-dev-check 体检
+```
+
+### Step 3：确认平台版本
+
+- 优先读取项目真实版本（从 pom.xml 解析）
+- 用户未指定且无法读取时，提示默认 `6.13.2`
+- 也允许填写其他已支持版本（6.12.1 / 6.10.1）
+
+### Step 4：读取内部模块
+
+- 读取 `references/modules/` 下的 22 个内部模块
+- 按能力图谱（`platform.md`）选择最小内部模块组合
+
+### Step 5：执行平台约束
+
+- 平台接口、Swagger/HTTP、Feign、本地 Bean、DTO、版本差异等只使用随 Skill 发布的离线知识库与已登记证据
+- 不得在生成代码时要求用户提供平台源码、解压/反编译 Jar、访问维护人员本机目录
+
+### Step 6：二开库隔离（强制）
+
+- 二开业务库不得连接或映射 cloud 平台表
+- 人员、组织、角色、字典等只保存稳定 ID/code
+- 通过已核验 Feign/API 批量装配（详见 `data-boundary.md`）
+
+### Step 7：代码生成
+
+- **新工程**：生成完整项目（含 pom.xml、application.yml、Controller/Service/Mapper、Vue 页面骨架）
+- **存量新增模块**：生成最小模块补丁
+- **已有模块修改**：基于真实源码做符号级最小变更，不用模板覆盖完整文件
+
+### Step 8：执行门禁
+
+- 代码规范、数据边界、确定性、构建门禁
+- 存量补丁必须合入原项目后才能宣称编译通过
+
+### Step 9：输出
+
+```
+- 能力路径
+- 新增/修改文件清单
+- SQL migration（如有）
+- 验证结果
+- 剩余 GAP 项
+- 人工联调项
+```
+
+**不输出 AI 开发 Journal，不执行 Git/SVN 提交。**
+
+## 代码示例
+
+### 用户输入
+
+```text
+meritdata-platform-cloud-dev 在项目 X 加一个请假模块的 Controller
+```
+
+### 输出（existing 模式）
+
+```yaml
+project_mode: existing
+platform_version: 6.13.2
+
+modules_loaded:
+  - gen           # 最小修改
+  - feign-api     # 不涉及跨服务
+  - code-spec     # 命名规范
+
+files_to_modify:
+  - src/main/java/com/example/leave/LeaveController.java
+  - src/main/java/com/example/leave/LeaveService.java
+  - src/main/java/com/example/leave/LeaveRepository.java
+
+code_snippet:
+  - path: LeaveController.java
+    content: |
+      @RestController
+      @RequestMapping("/api/leave")
+      public class LeaveController {
+          // 基于项目已有 Controller 风格生成
+      }
+
+gates_passed:
+  - data-boundary  # 二开库不连平台库
+  - code-spec      # 命名规范
+
+verification:
+  - 编译通过
+  - 单元测试覆盖率 ≥ 80%
+```
+
+## 📚 详细文档
+
+### 内部模块（平铺到 `references/modules/`）
+
+| 模块 | 文件 | 用途 |
+|------|------|------|
+| gen | [`modules/gen.md`](references/modules/gen.md) | 代码生成（new/existing） |
+| platform | [`modules/platform.md`](references/modules/platform.md) | 平台能力图谱 |
+| domain-model | [`modules/domain-model.md`](references/modules/domain-model.md) | 多表聚合建模 |
+| data-boundary | [`modules/data-boundary.md`](references/modules/data-boundary.md) | 数据边界（与 core skill 同源） |
+| feign-api | [`modules/feign-api.md`](references/modules/feign-api.md) | Feign 跨服务契约 |
+| platform-entities | [`modules/platform-entities.md`](references/modules/platform-entities.md) | 同 JVM 平台实体 |
+| ui | [`modules/ui.md`](references/modules/ui.md) | 前端语义组件 |
+| spec | [`modules/spec.md`](references/modules/spec.md) | 代码规范 |
+
+### 其他引用
+
+无（本 skill 内部模块全部位于 `references/modules/`）
+
+## 🚨 常见错误
+
+| 错误 | 后果 | 正确做法 |
+| --- | --- | --- |
+| 在 existing 模式生成 scaffold | 覆盖现有项目 | 不生成 scaffold |
+| 用模板覆盖已有文件 | 丢失已有修改 | 符号级最小变更 |
+| 要求用户提供平台源码 | 违反运行时只读门禁 | 仅基于已发布证据 |
+| 让用户选模块 | 违反"不暴露模块"门禁 | 自动路由 |
+| 在循环内 Feign | N+1 问题 | 批量装配 |
+
+## 边界
+
+- **不在本 skill 范围的**：
+  - 跨 skill 综合需求 → `meritdata-platform-playbook`
+  - BPM → `meritdata-platform-bpm`
+  - 缓存/Nacos → `meritdata-platform-core`
+  - 调度 → `meritdata-platform-job`
+  - 前端 → `meritdata-platform-frontend`
+- **强制要求**：本 skill 仅做领域入口，不做编排