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

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-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

@@ -0,0 +1,49 @@
+---
+name: 攻略-11-配置项-00_总览
+description: 美林平台系统配置项管理（命名空间 + 9 个配置文件 + 全量配置项说明）
+keywords: [配置项, nacos, 命名空间, common.properties, datasource, cache, gateway, cas, bpm, 多租户]
+use-cases: [nacos 配置查询, 配置项修改, 新增配置, 配置项文件说明]
+related: [Nacos 导出目录 / cloud-service-common]
+source: 应用开发平台-基础平台-使用攻略（二）：系统配置项管理.md
+---
+
+# 应用开发平台使用攻略（二）：系统配置项管理 — 总览
+
+**摘要**：美林平台系统配置项管理（命名空间 + 9 个配置文件 + 全量配置项说明）
+
+**关联**：Nacos 导出目录（默认 `<项目根>/nacos_config_export/`，可自定义）/ cloud-service-common
+
+## 章节索引
+
+01. [应用配置项相关](攻略-11-配置项-章节01_应用配置项相关.md) (原 1)
+02. [配置中心配置项说明](攻略-11-配置项-章节02_配置中心配置项说明.md) (原 2)
+03. [配置项的使用](攻略-11-配置项-章节03_配置项的使用.md) (原 3)
+
+## 引言
+
+系统配置项交由统一的配置中心(Nacos)进行管理，在程序启动时，从配置中心中根据应用配置文件配置获取相关配置项后进行启动。
+
+
+## 📑 API 速查
+
+本攻略共 **1 个 API**（按章节排序）：
+
+| 章节 | API | 方法 | 路径/签名 | 类型 | 描述 |
+|------|------|------|----------|------|------|
+| 章节03_配置项的使用 | `MeritdataCloudProperties` | - | `class MeritdataCloudProperties` | class | 配置实体类（@ConfigurationProperties 绑定） |
+
+### JSON Schema 完整索引
+
+```json
+[
+  {
+    "chapter": "章节03_配置项的使用",
+    "apiName": "MeritdataCloudProperties",
+    "method": "",
+    "urlPattern": "",
+    "type": "class",
+    "signature": "class MeritdataCloudProperties",
+    "functionDesc": "配置实体类（@ConfigurationProperties 绑定）"
+  }
+]
+```

package/skills/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/20201_/345/272/224/347/224/250/351/205/215/347/275/256/351/241/271/347/233/270/345/205/263.md

@@ -0,0 +1,28 @@
+---
+name: 攻略-11-配置项-章节01_应用配置项相关
+description: 应用配置项相关 — 美林平台系统配置项管理（命名空间 + 9 个配置文件 + 全量配置项说明）
+keywords: [配置项, nacos, 命名空间, common.properties, datasource, cache, gateway, cas, bpm, 多租户, 应用配置项相关]
+use-cases: [nacos 配置查询, 配置项修改, 新增配置, 配置项文件说明]
+source-section: 1. 应用配置项相关
+source-file: 应用开发平台-基础平台-使用攻略（二）：系统配置项管理.md
+---
+
+# 1 应用配置项相关
+
+配置中心的地址配置在应用的 bootstrap.properties 中
+
+```properties
+#nacos的启动地址，在nacos的启动日志中查看
+meritdata.cloud.nacos-addr=127.0.0.1:8848
+spring.cloud.nacos.config.server-addr=${meritdata.cloud.nacos-addr}
+spring.cloud.nacos.discovery.server-addr=${meritdata.cloud.nacos-addr}
+#程序加载的配置文件
+spring.profiles.include=server,cache,freemarker,datasource,sentinel,cloud-system-cas,oauth2,cloud-system-job,@project.artifactId@
+#服务启动的时候会读取 prefix.properties 和 prefix-profiles.properties 文件下的配置项
+spring.cloud.nacos.config.prefix=common
+#nacos的配置的命名空间，默认为空
+#在nacos中配置命名空间后，此处的配置值是namespace的id值
+spring.cloud.nacos.config.namespace=
+#系统的程序名，在创建工程的时候确定，挂载到nacos中的名称
+spring.application.name=@project.artifactId@
+```