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

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

@@ -0,0 +1,174 @@
+---
+name: meritdata-platform-code-review-by-rules
+description: 基于 .claude/rules 目录规范的代码审查 skill | 触发条件：代码审查 / code review / 规范检查 / 体检 / 检查命名规范 / 检查 SQL 规范 / 检查安全规范 / 检查性能规范 / 按规则审查 | 自动加载 .claude/rules/ 下 **11 个项目级代码规范**进行代码审查（不含 git-workflow-rules / nacos-rules 这 2 个非代码规范）| 不适用：纯前端 UI 样式审查（用前端组件规则）/ 纯需求文档审查（用 requirement-review）/ Git 工作流审查（用 git-workflow）/ Nacos 配置审查（用 nacos-rules）| 与已有 backend-code-review / development-code-review 区别：本 skill 严格按 .claude/rules/ 代码规范审查，不依赖通用 AI 标准
+metadata:
+  version: "1.0.0"
+  author: 技术平台部门架构组
+  source: company
+  date_added: "2026-09-12"
+  last_updated: "2026-09-12"
+  risk: low
+  allowed-tools: Read, Grep, Glob, Bash
+---
+
+# meritdata-platform-code-review-by-rules
+
+> **本 skill 严格按 `.claude/rules/` 项目级规则审查代码，不依赖通用 AI 标准**。
+> 与已有 `code-review` / `backend-code-review` / `development-code-review` 区别：本 skill **强制加载** `.claude/rules/` 下 **11 个代码规范** 作为审查依据（不含 git-workflow / nacos-rules 等非代码规范）。
+>
+> 📌 **`.claude/rules/` 共 13 个规则，其中 11 个是代码规范**（本 skill 范围），2 个是非代码规范（`git-workflow-rules.md` / `nacos-rules.md`，由其他 skill 负责）。
+
+---
+
+## ⭐ MUST DO
+
+**加载 `.claude/rules/` 下 13 个项目级规则文件**作为代码审查依据，不引用任何通用 AI 标准。
+
+## 触发条件 / 不适用
+
+**适用**：
+- 代码审查 / code review / 规范检查 / 体检
+- 检查命名规范 / SQL 规范 / 安全规范 / 性能规范
+- 按规则审查 / 改 PR 前自查
+
+**不适用**：
+- 纯前端 UI 样式审查 → 用前端组件规则（`.claude/rules/frontend-component-rules.md`）
+- 纯需求文档审查 → 用 `requirement-review`
+- 通用代码评审 → 用已有 `code-review`
+
+---
+
+## 自动加载的 11 个项目级**代码规范**（13 个中筛出）
+
+| # | 规则文件 | 审查维度 |
+|---|---------|---------|
+| 1 | `.claude/rules/code-dev-rules.md` | 后端 Java 开发通用规范 |
+| 2 | `.claude/rules/coding-standards-rules.md` | Java 编码标准（资源/集合/字符串/异常）|
+| 3 | `.claude/rules/naming-conventions-rules.md` | 类/方法/常量/变量/包命名 |
+| 4 | `.claude/rules/sql-naming-rules.md` | 表/字段/索引/约束命名 |
+| 5 | `.claude/rules/frontend-coding-rules.md` | Vue 2 + Element UI 规范 |
+| 6 | `.claude/rules/frontend-component-rules.md` | 前端组件交互规范 |
+| 7 | `.claude/rules/api-design-rules.md` | REST API 设计 |
+| 8 | `.claude/rules/sql-script-rules.md` | DDL/DML 脚本规范 |
+| 9 | `.claude/rules/performance-rules.md` | DB/缓存/并发/内存性能 |
+| 10 | `.claude/rules/security-rules.md` | 注入防护/认证/敏感信息 |
+| 11 | `.claude/rules/data-boundary-rules.md` | 平台二开数据边界铁律 |
+
+### 不在本 skill 范围的 2 个非代码规范
+
+| 规则文件 | 范围 | 适用 skill |
+|---|------|---------|
+| `.claude/rules/git-workflow-rules.md` | 分支/提交规范 | `git-workflow` 通用 skill（提交前自查）|
+| `.claude/rules/nacos-rules.md` | Nacos 配置中心规范 | 配置变更时由二开工程师自查 |
+
+> ⚠️ **本 skill 不修改 .claude/rules/ 内容**，只作为代码审查依据参考。
+
+---
+
+## 工作方式（Step 1/2/3/4）
+
+### Step 1：识别审查目标
+
+| 目标类型 | 触发规则 |
+|---------|---------|
+| 后端 Java 文件（.java）| code-dev-rules + coding-standards-rules + naming-conventions-rules |
+| SQL 脚本（.sql）| sql-naming-rules + sql-script-rules |
+| REST API Controller | api-design-rules + security-rules |
+| 前端 Vue 文件（.vue）| frontend-coding-rules + frontend-component-rules |
+| 性能敏感代码（DB / 缓存 / 并发）| performance-rules |
+| 安全敏感代码（认证 / SQL / 敏感字段）| security-rules |
+| Nacos 配置变更 | nacos-rules |
+| 数据访问代码（涉及平台库）| data-boundary-rules |
+| Git 操作 | git-workflow-rules |
+
+### Step 2：加载对应规则
+
+> **强制从 `.claude/rules/` 加载规则文件**，不读本 skill 内的速查表（速查表只用于规则文件加载失败时的回退）。
+
+```bash
+# 示例：审查 Java 后端代码
+read .claude/rules/code-dev-rules.md
+read .claude/rules/coding-standards-rules.md
+read .claude/rules/naming-conventions-rules.md
+```
+
+### Step 3：执行审查
+
+按规则文件中的"必须执行" / "禁止执行" 列表逐项核对代码：
+- ❌ 列出违规项（文件 + 行号 + 规则引用 + 修复建议）
+- ✅ 列出符合项（确认遵守的规则）
+- ⚠️ 列出建议项（不属于强制违反，但能改进）
+
+### Step 4：输出审查报告
+
+```text
+代码审查报告（基于 .claude/rules/ 13 个项目级规则）
+================================================
+审查文件：src/main/java/com/example/UserService.java
+审查依据：code-dev-rules.md + coding-standards-rules.md + naming-conventions-rules.md
+
+❌ [强制违反] UserService.java:42
+   规则：code-dev-rules.md §资源管理 - 必须使用 try-with-resources
+   修复：使用 try-with-resources 关闭流
+
+❌ [强制违反] UserService.java:58
+   规则：coding-standards-rules.md §异常处理 - 禁止空 catch 块
+   修复：添加日志或重新抛出
+
+✅ [符合] UserService.java:30
+   规则：naming-conventions-rules.md §类命名 - PascalCase
+   说明：UserService 符合 PascalCase 规范
+
+强制违反：2 项，建议：0 项
+审查结论：❌ 不通过（必须修复 2 项后才能合并）
+```
+
+---
+
+## 审查维度优先级
+
+| 优先级 | 维度 | 强制规则数 |
+|--------|------|----------|
+| 🔴 P0 | 资源管理 / 异常处理 / SQL 注入 | 7 类 |
+| 🟠 P1 | 命名规范 / SQL 命名 / 性能 | 12 类 |
+| 🟡 P2 | API 设计 / 安全 / 缓存 | 15 类 |
+| 🟢 P3 | 注释 / 测试 / 文档 | 8 类 |
+| 🔵 P4 | git / nacos / 部署 | 6 类 |
+
+---
+
+## 与已有 code-review skill 的关系
+
+| Skill | 审查依据 | 适用场景 |
+|-------|---------|---------|
+| **`meritdata-platform-code-review-by-rules`**（本 skill） | **`.claude/rules/` 13 个项目级规则** | **严格按项目规范审查** |
+| `code-review` | 通用代码评审标准 | 通用代码审查 |
+| `backend-code-review` | 后端质量/安全/可维护性 | 后端专项审查 |
+| `development-code-review` | 开发视角 | 开发视角审查 |
+
+> 📌 **本 skill 的核心价值**：100% 按项目自维护的 `.claude/rules/` 规则审查，不混用通用 AI 标准。
+
+---
+
+## 边界
+
+- **本 skill 范围的**：按 `.claude/rules/` **11 个代码规范**审查代码
+- **不在本 skill 范围的**：
+  - Git 工作流规范 → 用 `git-workflow-rules.md` 自查（不通过本 skill）
+  - Nacos 配置规范 → 用 `nacos-rules.md` 自查（不通过本 skill）
+  - 需求文档审查 → `requirement-review`
+  - 设计文档审查 → `design-review`
+  - 通用代码评审 → `code-review`
+  - 二开项目就绪度 → `meritdata-platform-2nd-dev-check`
+- **强制要求**：**严格从 `.claude/rules/` 读取代码规范**，不引用其他标准
+
+---
+
+## 🚨 常见错误
+
+| 错误 | 后果 | 正确做法 |
+| --- | --- | --- |
+| 只看本 skill 内的速查表 | 错过项目实际规则 | **必须 Read `.claude/rules/` 实际文件** |
+| 引用通用 AI 标准（Google / Oracle / Alibaba Java Guide）| 与项目规范不一致 | 只用 `.claude/rules/` |
+| 跳过强制项检查 | 漏掉 P0 错误 | 按 Step 3 逐项核对 |
+| 报告用 AI 风格（"完美！🎉"）| 违反 AI 输出规范 | 数据 + 状态 + 文件:行号 |

package/skills/meritdata-platform-code-review-by-rules/agents/openai.yaml

@@ -0,0 +1,13 @@
+display_name: "MeritData 按规则代码审查"
+short_description: "基于 .claude/rules 的代码审查"
+default_prompt: |
+  meritdata-platform-code-review-by-rules 基于 .claude/rules 目录规范进行代码审查。
+
+  适用场景：
+  - 代码审查 / 规范检查
+  - 按项目规则审查（不依赖通用 AI 标准）
+  - 改 PR 前自查
+
+  不适用：
+  - 通用代码评审（用 code-review）
+  - 后端专项审查（用 backend-code-review）

package/skills/meritdata-platform-config-item/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: meritdata-platform-config-item
+description: MeritData 配置项管理。用于系统参数（sys_config）、租户配置、动态配置中心、业务开关管理。
+metadata:
+  version: "1.0.0"
+  author: 技术平台部门架构组
+  source: company
+  date_added: "2026-09-01"
+  last_updated: "2026-09-01"
+  risk: low
+  allowed-tools: Read, Grep, Glob
+---
+
+## ⭐ MUST DO
+
+**配置项修改必须审计；高敏感配置（密钥、密码）禁止存于配置中心；租户级配置与全局配置分离。**
+
+## 触发条件 / 不适用
+
+**适用**：
+- 业务开关（feature flag）
+- 系统参数
+- 租户配置
+
+**不适用**：
+- Nacos 配置中心 → `meritdata-platform-core/references/nacos.md`
+
+## 主题路由
+
+### 公司级研发攻略（dev-docs 整合）
+
+| 攻略 | 内容 | 入口 |
+|------|------|------|
+| **攻略11：配置项（4 章）** | 应用配置项、配置中心配置项说明、配置项使用 | [`references/nacos-config/攻略-11-配置项-00_总览.md`](references/nacos-config/攻略-11-配置项-00_总览.md) |
+
+## 工作方式
+
+1. 配置项定义（key、value、scope、tenantId）
+2. 配置变更审计（修改人、时间、原因）
+3. 配置热更新（基于 Nacos）
+4. 租户级配置覆盖全局
+
+## 🚨 常见错误
+
+| 错误 | 后果 | 正确做法 |
+| --- | --- | --- |
+| 密钥存配置中心 | 安全风险 | KMS 管理 |
+| 配置无审计 | 无法追溯 | 强制审计 |
+
+## 边界
+
+- **不在本 skill 范围的**：
+  - Nacos 配置中心 → `meritdata-platform-core`
+  - 国密密钥 → `meritdata-platform-crypto-gm`
+- **强制要求**：高敏感配置走 KMS

package/skills/meritdata-platform-config-item/agents/openai.yaml

@@ -0,0 +1,14 @@
+display_name: "MeritData 配置项"
+short_description: "业务开关、系统参数、租户配置"
+default_prompt: |
+  meritdata-platform-config-item 处理配置项管理场景。
+
+  适用场景：
+  - 业务开关（feature flag）
+  - 系统参数
+  - 租户级配置
+
+  强制约束：
+  - 配置变更审计
+  - 高敏感配置走 KMS（密钥、密码不进配置中心）
+  - 租户级配置覆盖全局

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-config-item/references/nacos-config}//346/224/273/347/225/245-11-/351/205/215/347/275/256/351/241/271-00_/346/200/273/350/247/210.md

@@ -3,7 +3,7 @@ name: 攻略-11-配置项-00_总览
 description: 美林平台系统配置项管理（命名空间 + 9 个配置文件 + 全量配置项说明）
 keywords: [配置项, nacos, 命名空间, common.properties, datasource, cache, gateway, cas, bpm, 多租户]
 use-cases: [nacos 配置查询, 配置项修改, 新增配置, 配置项文件说明]
-related: [nacos_config_export / cloud-service-common]
+related: [Nacos 导出目录 / cloud-service-common]
 source: 应用开发平台-基础平台-使用攻略（二）：系统配置项管理.md
 ---
 
@@ -11,7 +11,7 @@ source: 应用开发平台-基础平台-使用攻略（二）：系统配置项
 
 **摘要**：美林平台系统配置项管理（命名空间 + 9 个配置文件 + 全量配置项说明）
 
-**关联**：nacos_config_export / cloud-service-common
+**关联**：Nacos 导出目录（默认 `<项目根>/nacos_config_export/`，可自定义）/ cloud-service-common
 
 ## 章节索引
 

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-config-item/references/nacos-config}//346/224/273/347/225/245-11-/351/205/215/347/275/256/351/241/271-/347/253/240/350/212/20202_/351/205/215/347/275/256/344/270/255/345/277/203/351/205/215/347/275/256/351/241/271/350/257/264/346/230/216.md

@@ -12,12 +12,12 @@ source-file: 应用开发平台-基础平台-使用攻略（二）：系统配
 ### 2.1 命名空间维护
 
 访问 nacos，在命名空间中可维护多个命名空间
-![image](/imgs/系统配置项管理（二）/1-1.jpg)
+[IMG: image]
 
 ### 2.2 配置项文件说明
 
 访问 naocs,系统配置项位于配置列表页面
-![image](/imgs/系统配置项管理（二）/1-2.png)
+[IMG: image]
 
 | 文件名                                                     | 说明             |
 | ---------------------------------------------------------- | ---------------- |
@@ -147,7 +147,7 @@ meritdata.cloud.mail.sendNick=
 
 ##################  freemarker配置 （easy-ui使用） ##################
 ## freemarker 文件路径 ，jar包下存在页面需要在resources目录下新建目录/META-INF/resources
-spring.freemarker.template-loader-path=classpath:/templates/,classpath:/META-INF/resources/
+spring.freemarker.template-loader-path=classpath:/内置模板/,classpath:/META-INF/resources/
 spring.freemarker.request-context-attribute=request
 spring.freemarker.expose-request-attributes=true
 spring.freemarker.expose-session-attributes=true

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-config-item/references/nacos-config}//346/224/273/347/225/245-11-/351/205/215/347/275/256/351/241/271-/347/253/240/350/212/20203_/351/205/215/347/275/256/351/241/271/347/232/204/344/275/277/347/224/250.md

@@ -42,4 +42,4 @@ private String applicationName;
 如 meritdata.cloud.xx-xx 转为实体属性后为 xxXx;
 
 在 config 文件中通过@EnableConfigurationProperties({MeritdataCloudProperties.class})进行引入
-![image](/imgs/系统配置项管理（二）/1-3.jpg)
+[IMG: image]

package/skills/meritdata-platform-config-item/references/nacos-utils-api.md

@@ -0,0 +1,76 @@
+# NacosUtils 10 方法速查
+
+## 接口定义
+
+```java
+public class NacosUtils {
+    public static String getConfigValue(String dataId, String group);
+    public static List<ConfigInfo> getConfigList(String group);
+    public static boolean updateConfig(String dataId, String group, String content);
+    public static boolean addConfig(String dataId, String group, String content);
+    public static boolean deleteConfig(String dataId, String group);
+    public static boolean publishConfig(String dataId, String group, String content);
+    public static List<ConfigInfo> getConfigListByPrefix(String prefix);
+    public static String getConfigValue(String dataId, String group, long timeoutMs);
+    public static boolean watchConfig(String dataId, String group, ConfigWatcher watcher);
+    public static void stopWatch(String dataId, String group);
+}
+```
+
+## 10 方法速查
+
+| 方法 | 用途 |
+|------|------|
+| `getConfigValue` | 读单个配置 |
+| `getConfigValue (3参)` | 读配置（带超时） |
+| `getConfigList` | 读 group 下所有配置 |
+| `getConfigListByPrefix` | 按前缀查询 |
+| `addConfig` | 新增配置 |
+| `updateConfig` | 更新配置 |
+| `deleteConfig` | 删除配置 |
+| `publishConfig` | 发布配置 |
+| `watchConfig` | 监听配置变更 |
+| `stopWatch` | 停止监听 |
+
+## 典型用法
+
+### 动态读配置
+
+```java
+String value = NacosUtils.getConfigValue("common-${APP_NAME}.properties", "DEFAULT_GROUP");
+// 应用运行时配置变更 → 自动生效（需 @RefreshScope）
+```
+
+### 监听配置变更
+
+```java
+NacosUtils.watchConfig("common-business.properties", "DEFAULT_GROUP", new ConfigWatcher() {
+    public void receiveConfigInfo(String configInfo) {
+        // 收到变更通知
+        log.info("配置已更新: {}", configInfo);
+    }
+});
+```
+
+### 运行时动态改配置
+
+```java
+NacosUtils.updateConfig(
+    "common-business.properties",
+    "DEFAULT_GROUP",
+    "meritdata.cloud.yourapp.pool-size=30"
+);
+// 配合 @RefreshScope，依赖此配置的 Bean 自动刷新
+```
+
+## 配合 @ConfigurationProperties
+
+```java
+@Data
+@Configuration
+@ConfigurationProperties(prefix = "meritdata.cloud.yourapp")
+@RefreshScope  // 关键：Nacos 改了生效
+public class YourAppProperties {
+    private Integer poolSize;
+}
+```

package/skills/meritdata-platform-config-item/references/nacos.md

@@ -0,0 +1,140 @@
+## 前置条件
+
+Maven 依赖已包含在 `cloud-starter-core` 基础包中，二开项目继承平台脚手架后自动引入，无需额外配置。
+
+## 重要：注入方式
+
+**`NacosUtils` 不是静态工具类**，它是 Spring Bean，必须通过 `@Autowired` 注入：
+
+```java
+@Autowired
+private NacosUtils nacosUtils;
+```
+
+**完整包路径**: `com.meritdata.cloud.utils.NacosUtils`
+
+---
+
+## 写入安全要求
+
+默认只读。修改、重置或清空配置前，必须确认目标环境、namespace/group、dataId、调用权限和回滚方式；先读取并保存原内容，再比较差异，写入后回读验证。
+
+不得生成用于清空整份配置的默认代码。令牌只可在运行时受管使用，不得输出到日志、文档或提交物。
+
+---
+
+## API 参考
+
+### 读取配置
+
+#### getConfigList(dataId) → Map
+
+获取指定配置文件的所有配置项。
+
+```java
+Map configMap = nacosUtils.getConfigList("common-cloud-system-manage.properties");
+```
+
+#### getConfigFile(dataId) → String
+
+获取指定配置文件的完整内容。
+
+```java
+String content = nacosUtils.getConfigFile("application.properties");
+```
+
+#### getConfigValue(dataId, configKey) → String
+
+获取单个配置项的值。
+
+```java
+String value = nacosUtils.getConfigValue(
+    "common-cloud-system-manage.properties",
+    "meritdata.cloud.security-label-show"
+);
+```
+
+#### getAllConfigFile() → Map\<String, String\>
+
+获取所有配置文件的键值对。
+
+```java
+Map<String, String> all = nacosUtils.getAllConfigFile();
+```
+
+### 修改配置
+
+#### updateConfig(dataId, configKey, configValue) → boolean
+
+修改单个配置项。
+
+```java
+boolean ok = nacosUtils.updateConfig(
+    "common-cloud-system-manage.properties",
+    "meritdata.cloud.security-label-show",
+    "true"
+);
+```
+
+#### updateConfigFile(dataId, content) → boolean
+
+更新整个配置文件内容。
+
+仅在完成快照、差异检查和显式确认后调用。
+
+### 新增配置
+
+#### addConfig(dataId, configKey, configValue) → boolean
+
+```java
+nacosUtils.addConfig("custom.properties", "custom.key", "value");
+```
+
+### 重置/清除
+
+#### reSetConfigFile(dataId, content) → boolean
+
+重置配置文件内容。
+
+#### clearConfigFile(dataId) → boolean
+
+清除配置文件的所有内容。
+
+这是破坏性操作，仅在明确授权、已备份且有回滚方案时执行。
+
+### Token
+
+#### getNacosToken() → String
+
+获取 Nacos 访问令牌。
+
+```java
+String token = nacosUtils.getNacosToken();
+```
+
+---
+
+## Nacos 方法速查表
+
+| 方法 | 入参 | 返回 | 说明 |
+|------|------|------|------|
+| `getConfigList` | dataId | Map | 获取配置项列表 |
+| `getConfigFile` | dataId | String | 获取完整文件内容 |
+| `getConfigValue` | dataId, configKey | String | 获取单个配置值 |
+| `getAllConfigFile` | 无 | Map\<String, String\> | 获取所有配置 |
+| `updateConfig` | dataId, key, value | boolean | 修改配置项 |
+| `updateConfigFile` | dataId, content | boolean | 更新整个文件 |
+| `addConfig` | dataId, key, value | boolean | 新增配置项 |
+| `reSetConfigFile` | dataId, content | boolean | 重置文件 |
+| `clearConfigFile` | dataId | boolean | 清除文件 |
+| `getNacosToken` | 无 | String | 获取 Token |
+
+---
+
+## Nacos 注意事项
+
+1. **必须通过 @Autowired 注入**，不能直接 `NacosUtils.xxx()` 静态调用
+2. 所有修改类方法返回 boolean 表示操作是否成功；写入后仍需回读验证
+3. dataId 为 Nacos 上的配置文件标识，通常是 `.properties` 文件名
+
+---

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

@@ -0,0 +1,77 @@
+---
+name: meritdata-platform-core
+description: MeritData 平台后端基础设施（缓存、Nacos 配置、SM2/SM3/SM4、审计日志、会话访问、数据密级过滤）。用于需要 NacosUtils、SessionUtils、SysCacheServiceFacade、Sm2Utils、EnableDataSecretFilter 等平台 API 的 MeritData 项目。
+metadata:
+  version: "1.0.0"
+  author: 技术平台部门架构组
+  source: company
+  date_added: "2026-09-01"
+  last_updated: "2026-09-01"
+  risk: medium
+  allowed-tools: Read, Grep, Glob
+---
+
+## ⭐ MUST DO
+
+**先确认目标项目属于 MeritData 平台，仅使用已发布的 API 签名，禁止在生成代码时要求用户提供平台源码或反编译 Jar。**
+
+## 触发条件 / 不适用
+
+**适用**：
+- 使用 NacosUtils / SessionUtils / SysCacheServiceFacade / Sm2Utils
+- 配置 `EnableDataSecretFilter` 行级权限
+- 接入 `@LogOperation` 审计日志
+
+**不适用**：
+- 同 JVM 限定场景 → `meritdata-platform-entities`
+- 跨 JVM 业务服务的数据访问 → `.claude/rules/data-boundary-rules.md`
+
+## 主题路由
+
+| 任务 | 优先读取 |
+| --- | --- |
+| 缓存、队列、计数器、发布订阅、幂等 | [`references/cache.md`](references/cache.md) |
+| Nacos 读取或受控修改 | [`references/nacos.md`](references/nacos.md) |
+| SM2、SM3、SM4、密码解密 | [`references/crypto.md`](references/crypto.md) |
+| 操作日志、字段变更日志、`@LogOperation` | [`references/logging.md`](references/logging.md) |
+| 数据密级过滤与行级权限 | [`references/data-secret.md`](references/data-secret.md) |
+| 当前用户、租户、IP、在线用户 | [`references/session.md`](references/session.md) |
+
+## 工作方式（Step 1/2/3/4）
+
+### Step 1：兼容性检查
+
+- 检查目标项目的依赖、已有 import 和配置
+- 本 skill 不保证任意平台版本都提供同名 API
+
+### Step 2：安全边界
+
+- 不输出密钥、令牌、密码或默认加密的
+- 加密材料必须来自已批准的配置或密钥服务
+- Nacos 写入、踢出用户、缓存清理和密级特权访问均为高影响操作
+
+### Step 3：读取 reference
+
+按主题路由读取对应 md 文件。状态修改补最小验证：缓存过期或幂等、Nacos 回读、密级正反用例、会话操作审计。
+
+### Step 4：跨 skill 协作
+
+- 需要实体字段 → `meritdata-platform-entities`
+- 需要外部接口 → `meritdata-platform-integration`
+- 需要调度 → `meritdata-platform-job`
+
+## 🚨 常见错误
+
+| 错误 | 后果 | 正确做法 |
+| --- | --- | --- |
+| 假定租户或密级 Filter 已启用 | 跨环境行为不一致 | 先在目标项目验证 |
+| 使用未发布 API | 平台升级后失效 | 仅使用随 Skill 发布的证据 |
+| 加密材料硬编码 | 安全风险 | 通过配置中心注入 |
+
+## 边界
+
+- **不在本 skill 范围的**：
+  - 平台实体字段 → `meritdata-platform-entities`
+  - 平台开放接口 → `meritdata-platform-integration`
+  - 数据边界强制门禁 → `.claude/rules/data-boundary-rules.md`
+- **强制要求**：高影响操作（写 Nacos / 缓存清理 / 密级特权）前必须先确认环境、权限、范围和回滚方式

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

@@ -0,0 +1,37 @@
+display_name: "MeritData 平台 Core"
+short_description: "MeritData 后端基础设施（缓存/Nacos/国密/日志/会话/密级）"
+default_prompt: |
+  meritdata-platform-core 处理 MeritData 平台后端基础设施场景。
+
+  适用场景：
+  - 缓存、队列、计数器、发布订阅（SysCacheServiceFacade）
+  - Nacos 配置读写（NacosUtils）
+  - 国密 SM2/SM3/SM4（Sm2Utils）
+  - 操作日志、字段变更日志（@LogOperation）
+  - 数据密级过滤（EnableDataSecretFilter）
+  - 当前用户、租户、IP、在线用户（SessionUtils）
+
+  使用方式：
+  ```
+  meritdata-platform-core <需求>
+  ```
+
+  工作方式：
+  1. 确认目标项目属于 MeritData 平台
+  2. 仅使用随 Skill 发布的 API 签名
+  3. 按主题路由读取 references/ 中的专题 md
+  4. 状态修改补最小验证：缓存过期或幂等、Nacos 回读、密级正反用例
+  5. 高影响操作前先确认环境、权限、范围和回滚方式
+
+  6 个 references：
+  - cache.md（缓存/队列/计数器/幂等）
+  - nacos.md（Nacos 读写）
+  - crypto.md（SM2/SM3/SM4）
+  - logging.md（@LogOperation）
+  - data-secret.md（数据密级过滤）
+  - session.md（当前用户/租户/IP）
+
+  强制约束：
+  - 不输出密钥、令牌、密码
+  - 不假定租户或密级 Filter 已启用
+  - 高影响操作必须有回滚方案