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

package/rules/nacos-rules.md

@@ -0,0 +1,154 @@
+<!--
+来源：研发skills/rules v1.0（2026-08 收录）
+抽取到 pfsuite/rules：2026-09-04
+后续治理：合并三方意见后再升级
+-->
+
+# Nacos 配置中心规范（项目级）
+
+**触发条件**：在 cloud_back 项目中使用 Nacos 进行配置管理时
+
+---
+
+## 一、配置架构
+
+**必须执行**：
+- 使用Nacos作为配置中心
+- 按环境划分Namespace
+- 按项目/模块划分Group
+- 配置Data ID格式规范
+- 本地配置仅用于开发
+
+**环境划分**：
+| Namespace | 环境 | 用途 |
+|-----------|------|------|
+| dev | 开发环境 | 本地开发 |
+| test | 测试环境 | 测试验证 |
+| prod | 生产环境 | 正式运行 |
+
+---
+
+## 二、配置组织
+
+**必须执行**：
+- Data ID格式：`{application}-{profile}.yml`
+- Group按环境分组：`DEFAULT_GROUP`、`PROD_GROUP`
+- 配置文件拆分（数据库/Redis/线程池等）
+- 公共配置抽离共享
+- 配置版本化管理
+
+**配置示例**：
+```
+Data ID: cloud-user-prod.yml
+Group: PROD_GROUP
+Namespace: prod
+```
+
+---
+
+## 三、配置项管理
+
+**必须执行**：
+- 敏感配置加密存储
+- 配置变更记录审计
+- 配置发布前验证
+- 灰度发布配置
+- 配置模板化管理
+
+**禁止执行**：
+- 禁止明文存储密码
+- 禁止硬编码敏感信息
+- 禁止未经评审发布配置
+
+---
+
+## 四、配置优先级
+
+**必须执行**：
+- 理解配置加载优先级
+- 本地配置覆盖远程配置
+- Profile配置覆盖默认配置
+- 命名空间隔离生效
+- 配置更新即时生效
+
+**优先级顺序**：
+```
+1. 本地配置
+2. 通用配置
+3. Profile配置
+4. 命名空间配置
+```
+
+---
+
+## 五、配置监听
+
+**必须执行**：
+- 使用@RefreshScope自动刷新
+- 配置变更监听处理
+- 避免配置循环依赖
+- 配置更新日志记录
+- 异常情况降级处理
+
+---
+
+## 六、配置安全
+
+**必须执行**：
+- 敏感配置加密（AES/RSA）
+- 配置访问权限控制
+- 操作日志审计
+- 定期轮换密钥
+- 禁止泄露配置内容
+
+---
+
+## 七、配置规范
+
+**必须执行**：
+- 配置文件使用YAML格式
+- 配置项使用有意义的命名
+- 配置项添加注释说明
+- 合理设置配置项默认值
+- 统一配置项单位
+
+**配置命名**：
+```yaml
+# 数据库配置
+spring:
+  datasource:
+    url: ${DB_URL}
+    username: ${DB_USERNAME}
+    password: ${DB_PASSWORD}
+
+# 线程池配置
+thread:
+  pool:
+    core-size: ${THREAD_POOL_CORE_SIZE:10}
+    max-size: ${THREAD_POOL_MAX_SIZE:50}
+```
+
+---
+
+## 八、Spring Cloud集成
+
+**必须执行**：
+- 引入spring-cloud-starter-alibaba-nacos-config
+- bootstrap.yml配置Nacos地址
+- 使用@Value注入配置
+- 使用@ConfigurationProperties绑定配置
+- 配置自动刷新注解@RefreshScope
+
+**禁止执行**：
+- 禁止在@RefreshScope中使用static变量
+- 禁止在监听器中执行耗时操作
+- 禁止配置循环依赖
+
+---
+
+## 重要提醒
+
+- 配置中心是系统配置的统一入口，必须规范管理
+- 敏感配置必须加密，不能明文存储
+- 配置变更必须经过评审和测试
+- 配置优先级要理解清楚，避免混乱

package/rules/naming-conventions-rules.md

@@ -0,0 +1,98 @@
+<!--
+来源：研发skills/rules v1.0（2026-08 收录）
+抽取到 pfsuite/rules：2026-09-04
+后续治理：合并三方意见后再升级
+-->
+
+# 命名规范
+
+---
+
+## 一、类命名
+
+| 类型 | 规则 | 示例 |
+|------|------|------|
+| Controller | `XxxController` | `YarnLogController` |
+| Service 接口 | `IXxxService` | `IYarnLogService` |
+| Service 实现 | `XxxServiceImpl` | `YarnLogServiceImpl` |
+| Operator 接口 | `IXxxOperator` | `IHadoopDatasourceOperator` |
+| Operator 实现 | `XxxOperator` | `HadoopDatasourceOperator` |
+| Model/Entity | `XxxModel` / `XxxEntity` | `YarnLogResult` |
+| 参数类 | `XxxParam` | `YarnLogParam` |
+| 异常类 | `XxxException` / `XxxErrorCode` | `YarnLogException` |
+| 工具类 | `XxxUtils` / `XxxHelper` | `HadoopOperatorUtils` |
+
+---
+
+## 二、方法命名
+
+| 类型 | 规则 | 示例 |
+|------|------|------|
+| 获取单个 | `getXxx()` | `getApplicationId()` |
+| 获取列表 | `listXxx()` / `getXxxList()` | `listApplications()` |
+| 判断 | `isXxx()` / `hasXxx()` / `canXxx()` | `isKerberosEnabled()` |
+| 保存/更新 | `saveXxx()` / `updateXxx()` | `saveApplication()` |
+| 删除 | `removeXxx()` / `deleteXxx()` | `deleteApplication()` |
+
+---
+
+## 三、常量命名
+
+**规则**：全大写下划线分隔
+
+```java
+MAX_RETRY_COUNT
+DEFAULT_TIMEOUT_MS
+CHECK_INTERVAL_MS
+RATE_LIMITER_QPS
+```
+
+---
+
+## 四、变量命名
+
+| 类型 | 规则 | 示例 |
+|------|------|------|
+| 普通变量 | 驼峰，简洁有意义 | `applicationId`、`status` |
+| 集合变量 | 复数或加 List/Map 后缀 | `users`、`userList`、`userMap` |
+| 布尔变量 | is/has/can 前缀 | `isRunning`、`hasError` |
+| 缓存变量 | 以 `CACHE_` 开头 | `CACHE_STATUS`、`CACHE_LOG` |
+
+---
+
+## 五、包命名
+
+**规则**：全小写，机构域名倒写
+
+```
+com.meritdata.cloud.datasource.server
+├── controller      # REST接口
+├── service         # 服务接口
+│   └── impl        # 服务实现
+├── operator        # 操作器接口
+├── param           # 参数类
+├── model           # 数据模型
+├── exception       # 异常和错误码
+├── util            # 工具类
+└── common          # 公共组件
+```
+
+---
+
+## 六、配置命名
+
+| 类型 | 规则 | 示例 |
+|------|------|------|
+| 配置属性 | 驼峰或烤串 | `yarn.rm.url` / `yarnRmUrl` |
+| 环境变量 | 全大写下划线 | `CLOUD_HOME` |
+| 常量值 | 全大写 | `YARN_LOG_STATUS_RUNNING` |
+
+---
+
+## 七、文件命名
+
+| 类型 | 规则 | 示例 |
+|------|------|------|
+| Java源文件 | 与类名相同 | `YarnLogController.java` |
+| 测试类 | `XxxTest` / `XxxIT` | `YarnLogControllerTest.java` |
+| SPI注册文件 | 接口全路径 | `com.meritdata.xxx.IXxxOperator` |

package/rules/performance-rules.md

@@ -0,0 +1,102 @@
+<!--
+来源：研发skills/rules v1.0（2026-08 收录）
+抽取到 pfsuite/rules：2026-09-04
+后续治理：合并三方意见后再升级
+-->
+
+# 性能规范
+
+**触发条件**：涉及数据库查询、缓存使用、并发处理、大数据量处理时
+
+---
+
+## 一、数据库性能
+
+**必须执行**：
+- SQL查询必须走索引
+- 避免 `SELECT *`，只查询需要的字段
+- 使用分页查询处理大数据量
+- 批量操作使用批量语句而非循环单条
+- 关闭自动提交，使用显式事务
+- 禁止在循环内执行SQL
+
+**禁止执行**：
+- 禁止N+1查询问题
+- 禁止在大数据表上使用全表扫描
+- 禁止在事务内执行远程调用
+
+---
+
+## 二、缓存使用
+
+**必须执行**：
+- 缓存key必须包含用户标识实现隔离
+- 缓存要有过期时间，防止内存泄漏
+- 缓存要控制大小，防止OOM
+- 缓存更新时使用正确策略（CacheAside/WriteThrough等）
+
+**禁止执行**：
+- 禁止缓存无限增长
+- 禁止缓存key冲突（不同用户数据混淆）
+- 禁止缓存非常量的大对象
+
+---
+
+## 三、并发处理
+
+**必须执行**：
+- 使用线程池替代手动创建线程
+- 线程池必须指定队列大小
+- 并发访问共享资源要加锁
+- 使用不可变对象减少锁竞争
+- 合理设置超时时间
+
+**禁止执行**：
+- 禁止使用 `Executors.newFixedThreadPool()` 不带队列
+- 禁止在锁内执行耗时操作
+- 禁止无限等待锁
+
+---
+
+## 四、内存管理
+
+**必须执行**：
+- 及时关闭资源（流、连接、Channel）
+- 使用try-with-resources自动关闭
+- 避免创建不必要的对象
+- 大字符串使用StringBuilder
+- 合理设置JVM堆大小
+
+**禁止执行**：
+- 禁止在循环内创建大对象
+- 禁止缓存无限增长导致OOM
+- 禁止关闭连接后继续使用
+
+---
+
+## 五、响应时间
+
+**必须执行**：
+- API响应时间要满足SLA要求
+- 复杂计算使用异步处理
+- 前端请求要支持取消和超时
+- 合理使用懒加载
+
+---
+
+## 六、日志性能
+
+**必须执行**：
+- 使用异步日志避免阻塞
+- 禁止在日志中打印大对象
+- 使用合适的日志级别
+- 生产环境关闭debug日志
+
+---
+
+## 重要提醒
+
+- 数据库连接是稀缺资源，必须及时释放
+- 缓存是双刃剑，使用不当会导致数据不一致
+- 并发不是万能药，过度并发反而降低性能
+- 性能问题80%来自数据库，优先优化SQL

package/rules/requirement-dev-rules.md

@@ -0,0 +1,77 @@
+<!--
+来源：全局 ~/.claude/rules/requirement-dev-rules.md v1.0（2026-04 起累计）
+下放到套件：2026-09-09（v2.6.3）
+后续治理：套件内自包含权威版本；全局版可作为兜底但优先以本文件为准
+-->
+
+# 需求开发指南
+
+**触发条件**：进行需求分析、需求设计、编写PRD时
+
+---
+
+## 一、需求结构
+
+**必须执行**：
+- 包含版本更新记录（版本、类型、提交人、日期、更新内容）
+- 描述业务背景，说明为什么要做这个需求
+- 定义功能范围：影响范围、业务角色、业务主流程
+- 明确业务约束、技术约束、平台约束
+
+---
+
+## 二、功能定义
+
+**必须执行**：
+- 每个功能必须有明确的功能点描述
+- 说明功能的前置条件和后置条件
+- 描述输入如何转换为输出
+- 说明正常流程和异常流程
+
+---
+
+## 三、非功能需求
+
+**必须执行**：
+- 定义性能需求（响应时间、并发数）
+- 定义安全性需求（认证、授权、数据加密）
+- 定义可靠性需求（可用性、故障恢复）
+- 定义扩展性需求
+
+---
+
+## 四、接口设计
+
+**必须执行**：
+- 说明接口主要用途、关键输入参数、接口类型
+- 说明接口设计约束
+- 说明接口安全性需求
+- 提供调用示例
+
+---
+
+## 五、兼容性 & 边界
+
+**必须执行**：
+- 说明浏览器兼容性要求
+- 说明数据库字符集要求
+- 说明JDK版本要求
+- 说明对历史功能的影响
+
+---
+
+## 六、验证条件
+
+**必须执行**：
+- 每个功能必须有可测试性说明
+- 说明如何验证需求是否完成
+- 定义通过/失败的标准
+- 列出不可测试的需求并说明原因
+
+---
+
+## 重要提醒
+
+- 需求必须通过技术研究验证后方可进入开发
+- 需求描述要清晰无歧义，避免"满足需求"这类模糊表述
+- 功能模块关系图要及时维护

package/rules/security-rules.md

@@ -0,0 +1,91 @@
+<!--
+来源：研发skills/rules v1.0（2026-08 收录）
+抽取到 pfsuite/rules：2026-09-04
+后续治理：合并三方意见后再升级
+-->
+
+# 安全编码规范
+
+**触发条件**：涉及用户认证、数据传输、权限控制、敏感信息处理时
+
+---
+
+## 一、注入防护
+
+**必须执行**：
+- SQL参数必须使用预编译语句（PreparedStatement）
+- SQL拼接时对用户输入进行严格校验
+- SQL的like过滤时对 `_%` 进行特殊处理
+- 用户输入的HTML/JS进行转义，防止XSS
+- 命令行参数要进行严格校验，防止注入
+
+**禁止执行**：
+- 禁止字符串拼接SQL
+- 禁止直接执行用户输入的SQL
+
+---
+
+## 二、认证 & 授权
+
+**必须执行**：
+- 认证失败提示信息不能过于详细（不能提示"密码错误"vs"用户不存在"）
+- 会话ID要足够随机，不可预测
+- 会话超时要合理设置
+- 权限验证在服务端执行，不能依赖客户端
+
+**禁止执行**：
+- 禁止在URL中传递认证token
+- 禁止使用GET请求处理敏感操作
+
+---
+
+## 三、敏感信息保护
+
+**必须执行**：
+- 密码加密存储（bcrypt/scrypt/argon2）
+- 敏感信息在日志中必须脱敏（手机号、身份证、银行卡号）
+- 敏感配置加密存储（数据库密码、API密钥）
+- 内存中的敏感信息使用后立即清理
+
+**禁止执行**：
+- 禁止在日志中打印密码、token、keytab
+- 禁止在代码中硬编码密码或密钥
+- 禁止在URL中传递敏感参数
+
+---
+
+## 四、数据传输
+
+**必须执行**：
+- HTTPS传输敏感数据
+- 敏感数据在客户端存储要加密
+- 请求头中的敏感信息要保密
+
+---
+
+## 五、文件操作
+
+**必须执行**：
+- 上传文件要验证类型、大小、内容
+- 读取文件前检查是文件而非目录
+- 文件路径要防止路径遍历攻击
+- 下载文件权限要严格控制
+
+---
+
+## 六、安全配置
+
+**必须执行**：
+- 错误信息统一处理，不泄露内部信息
+- 关闭不必要的HTTP头（X-Powered-By等）
+- CORS配置要严格限制来源
+- 请求超时要合理设置
+
+---
+
+## 重要提醒
+
+- 安全验证必须在服务端执行
+- 用户输入永远不可信，必须校验
+- 敏感信息最小化原则：只收集必要的信息
+- 敏感信息要加密存储、加密传输、脱敏展示