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

package/rules/test-case-dev-rules.md

@@ -0,0 +1,96 @@
+<!--
+来源：全局 ~/.claude/rules/test-case-dev-rules.md v1.0（2026-04 起累计）
+下放到套件：2026-09-09（v2.6.3）
+后续治理：套件内自包含权威版本；全局版可作为兜底但优先以本文件为准
+-->
+
+# 测试用例开发指南
+
+**触发条件**：编写单元测试、集成测试、开发者测试用例时
+
+---
+
+## 一、测试用例基本要求
+
+**必须执行**：
+- 测试用例命名规范，描述清晰功能点
+- 测试用例前置条件与需求相符
+- 说明不同用户角色的测试场景
+- 定义通过/失败的可验证标准
+
+---
+
+## 二、边界值测试
+
+**必须执行**：
+- 参数数据类型取值范围内正常验证
+- 参数数据类型取值范围外正常验证
+- 参数限制输入数据全值范围边界内验证
+- 参数限制输入数据全值范围边界外验证
+
+**数字字段必须测试**：
+- 超出范围的值
+- 负数
+- 小数
+- 零
+
+**字符字段必须测试**：
+- 空格
+- 非文字字符
+- 数字
+- 特殊符号
+
+**日期字段必须测试**：
+- 空格
+- 文字字符
+- 时间格式
+- 不合理日期值
+- 特殊符号
+
+---
+
+## 三、空值 & 特殊值测试
+
+**必须执行**：
+- 参数值为空时验证
+- 参数值包含特殊字符时验证
+- 不提供任何输入数据时验证（空包、空数据）
+
+---
+
+## 四、安全测试
+
+**必须执行**：
+- 包含重复提交的场景测试
+- 包含SQL注入测试（使用特殊字符 `'`, `"`, `;`, `--`）
+- 包含XSS攻击测试（使用 `<script>`, `javascript:`）
+- 验证敏感数据不能明文显示
+- 考虑越权场景测试
+
+---
+
+## 五、并发 & 重复测试
+
+**必须执行**：
+- 设计连续两次相同数据的测试
+- 多线程同时请求同一资源的测试
+- 验证并发场景下数据一致性
+
+---
+
+## 六、性能测试
+
+**必须执行**：
+- 考虑系统响应时间
+- 考虑不同规模数据下的响应时间
+- 考虑最大并发数
+- 考虑系统资源使用率
+
+---
+
+## 重要提醒
+
+- 每个测试用例必须有明确的通过/失败标准
+- 测试步骤必须可执行并可验证结果
+- 必须覆盖所有必选参数
+- 必须组合可选参数进行测试

package/skills/README.md

@@ -0,0 +1,118 @@
+# pfsuite skills 索引
+
+> **抽取日期**：2026-09-07  
+> **目标**：三方整合 44 → **31 个 skill**，按 4 层架构分层（详见 `MeritData_Skill整合重构方案_20260904.md`）
+
+---
+
+## 一、双轨制原则（skill ↔ rules 边界）
+
+| 角色 | 内容 | 文件 | 加载方式 |
+|------|------|------|---------|
+| **rules** | 铁律摘要（一句话一段）| `../rules/*.md` | CLAUDE.md 自动注入 |
+| **skill SKILL.md** | 路由器（触发 + 不触发 + 路由）| `skills/<name>/SKILL.md` | Skill 工具按需触发 |
+| **skill references/** | 详细文档（代码对比 + 案例 + CI 命令）| `skills/<name>/references/*.md` | skill 触发后按需加载 |
+
+**关键约束**：
+- SKILL.md **不重复** rules 的铁律正文——只引用章节号
+- references/ **承载** rules 容纳不下的内容：完整代码、真实案例、bash/Python 脚本、YAML
+- 任何铁律变更**先改 rules**，再同步 references（保持两边一致）
+
+---
+
+## 二、当前已建（3 个 — P0 方法论完成）
+
+| skill | layer | 触发 | 路由 |
+|-------|-------|------|------|
+| `meritdata-platform-code-spec` | L2 | 写完二开代码提交前自查 / PR review | [SKILL.md](meritdata-platform-code-spec/SKILL.md) |
+| `meritdata-platform-data-boundary` | L2 | 二开库数据访问代码生成 / PR 提交前 / CI 扫描 | [SKILL.md](meritdata-platform-data-boundary/SKILL.md) |
+| `meritdata-platform-domain-model` | L2 | 新二开业务模块的数据库表设计 / 聚合根设计 | [SKILL.md](meritdata-platform-domain-model/SKILL.md) |
+
+**3 个方法论 skill 与 rules §8 铁律一一对应**：
+
+```
+rules/code-dev-rules.md §8.1 ──┬── data-boundary skill
+rules/code-dev-rules.md §8.2 ──┼── domain-model skill
+rules/code-dev-rules.md §8.3 ──┴── code-spec skill
+```
+
+---
+
+## 三、待建（28 个 — 按 P1/P2/P3/P4 分批）
+
+### P1 L1 入口（1 个）— 3-5 天
+
+- `meritdata-platform-playbook` — 唯一对外入口，识别动作 → 路由到 L2
+
+### P2 L2 领域（8 个）— 1-2 周
+
+- `meritdata-platform-bpm` — 流程引擎
+- `meritdata-platform-entities` — 平台实体与 Q 类
+- `meritdata-platform-services` — 同 JVM 公共服务
+- `meritdata-platform-integration` — 对外接口 / Feign / HR 同步
+- `meritdata-platform-frontend` — 前端组件与工程
+- `meritdata-platform-job` — 任务调度
+- `meritdata-platform-impexp` — 导入导出
+- `meritdata-platform-sso` — 认证
+
+### P3 L3 单点 API（19 个）— 2 周
+
+- 缓存 / Nacos 配置 / 国密 / 密级 / 会话 / 日志 / 消息中心
+- 字典 API / 组织人员 API / 资源授权
+- 菜单配置 / 菜单资源 / 平台基础配置 API
+- UI 组件 / 前端部署 / 后端部署
+- 数据访问 / 代码审查 / 测试用例
+
+### P4 工具 + L0 治理（6 个）— 1 周
+
+- L4：`meritdata-bootstrap-2nd-dev` / `meritdata-nacos-importer` / `meritdata-platform-2nd-dev-check`
+- L0：`skill-authoring-workflow` / `skill-vetter` / `skill-stocktake`
+
+---
+
+## 四、SKILL.md 写法规范（基于3 个方法论精简经验）
+
+### 4.1 必须含
+
+- frontmatter（name / description / metadata.version / layer / risk / source / date_added / last_modified）
+- 触发条件（3-5 条 bullet）
+- 不触发条件（避免误加载，2-4 条 bullet，明确指向替代 skill）
+- 前置约束（引用 rules 章节号，**不重复铁律正文**）
+- 路由（指向 references/ 文件）
+
+### 4.2 禁止写
+
+- ❌ 铁律正文（已存在于 rules）
+- ❌ 完整代码示例（放 references/anti-patterns.md）
+- ❌ CI 命令（放 references/validate-rules.md）
+- ❌ 适用范围（与 rules 重复）
+- ❌ 安全边界（与 rules 重复）
+- ❌ 引用与依赖（路由信息已在 references 头部）
+
+### 4.3 行数控制
+
+- 目标：**15-40 行**（不含 frontmatter）
+- 已精简样本：code-spec 33 行 / data-boundary 38 行 / domain-model 38 行
+
+---
+
+## 五、与三方源目录的关系
+
+```
+工业互联codex/  石油skills/  研发skills/    ← 三方源，待归档
+                              ↓ 阶段 2 合稿
+                     skills/meritdata-platform-*/
+                              ↓ 路由
+                     ../rules/code-dev-rules.md §八  ← 铁律摘要
+```
+
+**三方源归档时机**：阶段 2 合稿完成后；归档前加 `LEGACY.md` 标记只读。
+
+---
+
+## 六、变更记录
+
+| 日期 | 变更 |
+|------|------|
+| 2026-09-07 | 新建 3 个方法论 skill（code-spec / data-boundary / domain-model），含 SKILL.md + anti-patterns.md + validate-rules.md |
+| 2026-09-07 | 精简 SKILL.md 顶层从 88-111 行到 33-38 行（-65%），删除与 rules 重复内容 |

package/skills/meritdata-bootstrap-2nd-dev/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: meritdata-bootstrap-2nd-dev
+description: 生成二开 Maven 项目脚手架。当用户说"新建二开项目 / 初始化项目 / 脚手架 / bootstrap / 拉模板"时使用。
+metadata:
+  version: "1.0.0"
+  risk: medium
+  layer: L4
+  sub-layer: L4-T
+  stack: tool
+---
+
+# meritdata-bootstrap-2nd-dev
+
+## 触发
+
+- 用户说"新建二开项目 / 初始化项目 / 脚手架"
+- 用户提供 groupId + artifactId 请求生成项目骨架
+- CI 流水线需要拉取最新二开模板
+
+## 不触发
+
+- 已有项目结构调整（→ `meritdata-platform-playbook`）
+- Maven 依赖问题（→ `meritdata-platform-code-spec`）
+- 数据库 schema 生成（→ `meritdata-platform-domain-model`）
+
+## 前置约束
+
+- 必须已安装 Maven 3.6+ 与 JDK 8+
+- 二开项目必须遵守 [`rules/code-dev-rules.md`](../../rules/code-dev-rules.md)
+- 表/字段命名遵守 [`rules/naming-conventions-rules.md`](../../rules/naming-conventions-rules.md)
+- 二开库**不得映射 PF_ 平台表**（[`rules/meritdata-platform-data-boundary.md`](../../rules/meritdata-platform-data-boundary.md)）
+
+## 路由
+
+- [guide.md](references/guide.md) — 脚手架命令 + 项目结构
+- [template.md](references/template.md) — 二开项目模板说明
+- [verify.md](references/verify.md) — 生成后的校验清单

package/skills/meritdata-bootstrap-2nd-dev/references/guide.md

@@ -0,0 +1,245 @@
+# 脚手架指南（bootstrap-2nd-dev）
+
+> 二开 Maven 项目脚手架：从模板生成新项目。
+
+---
+
+## 1. 命令
+
+### 1.1 从模板仓库生成
+
+```bash
+# 1. 下载模板
+curl -L https://git.meritdata.com/templates/2nd-dev-template/archive/main.tar.gz \
+  -o /tmp/template.tar.gz
+tar -xzf /tmp/template.tar.gz -C /tmp/
+
+# 2. 用 archetype 生成
+mvn archetype:generate \
+  -DarchetypeGroupId=com.meritdata.cloud \
+  -DarchetypeArtifactId=2nd-dev-archetype \
+  -DarchetypeVersion=1.0.0 \
+  -DgroupId=com.example \
+  -DartifactId=my-2nd-service \
+  -Dversion=1.0.0-SNAPSHOT \
+  -DinteractiveMode=false
+```
+
+### 1.2 替换变量
+
+生成后必须替换以下占位符：
+
+| 占位符 | 替换为 |
+|--------|--------|
+| `${groupId}` | 业务 groupId（如 `com.example.order`）|
+| `${artifactId}` | 业务 artifactId |
+| `${rootPackage}` | 根包名（如 `com.example.order.server`）|
+| `${projectName}` | 项目显示名 |
+| `${description}` | 项目描述 |
+
+```bash
+# Linux
+find ./my-2nd-service -type f \( -name '*.java' -o -name '*.xml' -o -name '*.yml' \) \
+  -exec sed -i 's/com\.meritdata\.cloud\.sample/com.example.order/g' {} +
+
+# Windows PowerShell
+Get-ChildItem -Path ./my-2nd-service -Recurse -Include *.java,*.xml,*.yml |
+  ForEach-Object { (Get-Content $_) -replace 'com\.meritdata\.cloud\.sample', 'com.example.order' | Set-Content $_ }
+```
+
+## 2. 项目结构
+
+```
+my-2nd-service/
+├── pom.xml                          ← 父 POM（继承 cloud-parent）
+├── src/
+│   ├── main/
+│   │   ├── java/
+│   │   │   └── com/example/order/
+│   │   │       ├── OrderApplication.java     ← Spring Boot 启动类
+│   │   │       ├── controller/
+│   │   │       │   └── OrderController.java
+│   │   │       ├── service/
+│   │   │       │   ├── IOrderService.java
+│   │   │       │   └── impl/OrderServiceImpl.java
+│   │   │       ├── repository/
+│   │   │       │   └── OrderRepository.java
+│   │   │       ├── entity/
+│   │   │       │   └── Order.java
+│   │   │       ├── dto/
+│   │   │       │   ├── OrderDTO.java
+│   │   │       │   ├── OrderQueryDTO.java
+│   │   │       │   └── OrderVO.java
+│   │   │       ├── param/
+│   │   │       │   └── OrderParam.java
+│   │   │       └── exception/
+│   │   │           └── OrderException.java
+│   │   └── resources/
+│   │       ├── application.yml                ← 通用配置
+│   │       ├── application-dev.yml            ← 开发环境
+│   │       ├── application-test.yml           ← 测试环境
+│   │       ├── application-prod.yml           ← 生产环境
+│   │       ├── bootstrap.yml                  ← Nacos 引导
+│   │       ├── logback-spring.xml
+│   │       └── mapper/                        ← MyBatis XML（如使用）
+│   └── test/
+│       └── java/
+│           └── com/example/order/
+│               ├── controller/
+│               ├── service/
+│               └── repository/
+├── Dockerfile
+├── docker-compose.yml
+├── README.md
+└── .gitignore
+```
+
+## 3. pom.xml 关键依赖
+
+```xml
+<parent>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>cloud-parent</artifactId>
+    <version>5.6.0</version>
+</parent>
+
+<dependencies>
+    <!-- Spring Boot Web -->
+    <dependency>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-web</artifactId>
+    </dependency>
+
+    <!-- 平台核心 -->
+    <dependency>
+        <groupId>com.meritdata.cloud</groupId>
+        <artifactId>cloud-core</artifactId>
+    </dependency>
+
+    <!-- 平台能力 -->
+    <dependency>
+        <groupId>com.meritdata.cloud</groupId>
+        <artifactId>cloud-bpm-spring-boot-starter</artifactId>
+    </dependency>
+    <dependency>
+        <groupId>com.meritdata.cloud</groupId>
+        <artifactId>cloud-job-spring-boot-starter</artifactId>
+    </dependency>
+    <dependency>
+        <groupId>com.meritdata.cloud</groupId>
+        <artifactId>cloud-impexp-spring-boot-starter</artifactId>
+    </dependency>
+
+    <!-- 数据库 -->
+    <dependency>
+        <groupId>com.baomidou</groupId>
+        <artifactId>mybatis-plus-boot-starter</artifactId>
+    </dependency>
+    <dependency>
+        <groupId>mysql</groupId>
+        <artifactId>mysql-connector-java</artifactId>
+    </dependency>
+
+    <!-- 测试 -->
+    <dependency>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-test</artifactId>
+        <scope>test</scope>
+    </dependency>
+</dependencies>
+```
+
+## 4. application.yml 模板
+
+```yaml
+spring:
+  application:
+    name: my-2nd-service
+  profiles:
+    active: dev
+  cloud:
+    nacos:
+      discovery:
+        server-addr: ${NACOS_SERVER:127.0.0.1:8848}
+        namespace: ${NACOS_NAMESPACE:dev}
+      config:
+        server-addr: ${NACOS_SERVER:127.0.0.1:8848}
+        file-extension: yaml
+        namespace: ${NACOS_NAMESPACE:dev}
+  datasource:
+    url: ${DB_URL:jdbc:mysql://127.0.0.1:3306/order_dev}
+    username: ${DB_USER:root}
+    password: ${DB_PASSWORD:root}
+
+server:
+  port: 8080
+  servlet:
+    context-path: /my-2nd-service
+
+# 平台配置
+meritdata:
+  bpm:
+    enabled: true
+  job:
+    enabled: true
+
+logging:
+  level:
+    com.example.order: DEBUG
+    org.springframework: INFO
+```
+
+## 5. 启动类
+
+```java
+package com.example.order;
+
+import org.mybatis.spring.annotation.MapperScan;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
+import org.springframework.scheduling.annotation.EnableAsync;
+
+@SpringBootApplication
+@EnableDiscoveryClient
+@EnableAsync
+@MapperScan("com.example.order.repository")
+public class OrderApplication {
+    public static void main(String[] args) {
+        SpringApplication.run(OrderApplication.class, args);
+    }
+}
+```
+
+## 6. 常见错误
+
+### 6.1 ❌ 占位符未替换
+
+```java
+// ❌ 错：残留 com.meritdata.cloud.sample
+package com.meritdata.cloud.sample;
+```
+
+✅ 用 sed 批量替换。
+
+### 6.2 ❌ namespace 冲突
+
+```
+ERROR: namespace 'public' is reserved
+```
+
+✅ 用专属 namespace：`b8a8-...-dev`。
+
+### 6.3 ❌ 数据库连接失败
+
+```
+Communications link failure
+```
+
+✅ 启动前先建库：`CREATE DATABASE order_dev DEFAULT CHARACTER SET utf8mb4;`
+
+## 7. 关联阅读
+
+- [template.md](template.md) — 模板说明
+- [verify.md](verify.md) — 校验清单
+- [SKILL.md](../SKILL.md)