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

package/skills/java-testing/evals/evals.json

@@ -1,46 +0,0 @@
-{
-  "skill_name": "java-testing",
-  "evals": [
-    {
-      "id": 1,
-      "prompt": "How do I write a JUnit 5 test for my UserService that uses a Repository dependency?",
-      "expected_output": "Use @ExtendWith(MockitoExtension.class). Annotate the repo field with @Mock, the service with @InjectMocks. Use AssertJ assertThat for assertions. Name test with @DisplayName.",
-      "assertions": [
-        { "id": "a1", "description": "Uses @ExtendWith(MockitoExtension.class)", "type": "contains", "value": "MockitoExtension" },
-        { "id": "a2", "description": "Uses AssertJ assertThat", "type": "contains", "value": "assertThat" },
-        { "id": "a3", "description": "Uses @Mock or @InjectMocks", "type": "contains", "value": "@Mock" }
-      ]
-    },
-    {
-      "id": 2,
-      "prompt": "I want to test my Java code with 5 different input values. How do I avoid writing 5 identical test methods?",
-      "expected_output": "Use @ParameterizedTest with @ValueSource, @CsvSource, or @MethodSource. JUnit 5 runs the test once per input. Add @DisplayName to the parameterized test for clarity.",
-      "assertions": [
-        { "id": "a1", "description": "Uses @ParameterizedTest", "type": "contains", "value": "@ParameterizedTest" },
-        { "id": "a2", "description": "Mentions input source annotation", "type": "contains", "value": "Source" }
-      ]
-    },
-    {
-      "id": 3,
-      "prompt": "My Java integration tests need a real PostgreSQL database. How do I set that up without a real server?",
-      "expected_output": "Use Testcontainers — spin up a real Postgres container per test class. Annotate with @Testcontainers and @Container. Name integration tests with *IT.java suffix.",
-      "assertions": [
-        { "id": "a1", "description": "Recommends Testcontainers", "type": "contains", "value": "Testcontainers" },
-        { "id": "a2", "description": "Uses @Container annotation", "type": "contains", "value": "@Container" },
-        { "id": "a3", "description": "Uses *IT.java naming", "type": "contains", "value": "IT.java" }
-      ]
-    }
-  ],
-  "should_not_trigger": [
-    "Configure Spotless to format Java code on every commit",
-    "Set up SpotBugs to catch null dereferences in CI",
-    "How do I use Virtual Threads to parallelize my test setup?",
-    "Write a Kotlin unit test using MockK and Truth assertions",
-    "Set up ktlint and Detekt for a Kotlin project",
-    "Use AssertJ for fluent Kotlin assertions in my JUnit tests",
-    "How do I use Cucumber with Java for BDD-style acceptance tests?",
-    "Run tests in parallel using JUnit 5 @Execution(CONCURRENT)",
-    "Set up a test coverage report with JaCoCo in Maven",
-    "Write a Spring Boot integration test with @SpringBootTest"
-  ]
-}

package/skills/java-testing/references/junit-template.md

@@ -1,58 +0,0 @@
-# JUnit 5 Test Template
-
-## Standard Test Class
-
-```java
-package com.example.domain;
-
-import org.junit.jupiter.api.DisplayName;
-import org.junit.jupiter.api.Test;
-import org.junit.jupiter.api.extension.ExtendWith;
-import org.mockito.Mock;
-import org.mockito.junit.jupiter.MockitoExtension;
-import static org.assertj.core.api.Assertions.assertThat;
-import static org.mockito.BDDMockito.given;
-
-@ExtendWith(MockitoExtension.class)
-@DisplayName("UserService Unit Tests")
-class UserServiceTest {
-
-    @Mock
-    private UserRepository repository;
-
-    @InjectMocks
-    private UserService service;
-
-    @Test
-    @DisplayName("Should return active user when ID exists")
-    void shouldReturnActiveUser() {
-        // Arrange
-        var userId = "123";
-        var expectedUser = new User(userId, "Active");
-        given(repository.findById(userId)).willReturn(Optional.of(expectedUser));
-
-        // Act
-        var result = service.getUser(userId);
-
-        // Assert
-        assertThat(result)
-            .isPresent()
-            .get()
-            .extracting(User::status)
-            .isEqualTo("Active");
-    }
-
-    @Test
-    @DisplayName("Should throw exception when user not found")
-    void shouldThrowWhenNotFound() {
-        // Arrange
-        var userId = "999";
-        given(repository.findById(userId)).willReturn(Optional.empty());
-
-        // Act & Assert
-        assertThatThrownBy(() -> service.getUser(userId))
-            .isInstanceOf(UserNotFoundException.class)
-            .hasMessageContaining(userId);
-    }
-}
-```

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

@@ -1,37 +0,0 @@
----
-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

@@ -1,245 +0,0 @@
-# 脚手架指南（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)

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

@@ -1,229 +0,0 @@
-# 二开项目模板说明（bootstrap-2nd-dev）
-
-> 二开项目模板仓库 `2nd-dev-template` 的字段含义和定制方法。
-
----
-
-## 1. 模板仓库
-
-```
-git@git.meritdata.com:templates/2nd-dev-template.git
-```
-
-版本：`main`（稳定）/ `feat/*`（新功能预发）
-
-```bash
-git clone git@git.meritdata.com:templates/2nd-dev-template.git
-cd 2nd-dev-template
-ls -la
-```
-
-## 2. 模板目录结构
-
-```
-2nd-dev-template/
-├── pom.xml                          ← 父 POM 模板
-├── .gitignore
-├── README.md
-├── Dockerfile
-├── docker-compose.yml
-├── .github/workflows/
-│   └── build.yml                    ← CI 模板
-├── src/
-│   ├── main/
-│   │   ├── java/
-│   │   │   └── com/meritdata/cloud/sample/
-│   │   │       ├── SampleApplication.java
-│   │   │       ├── controller/SampleController.java
-│   │   │       ├── service/ISampleService.java
-│   │   │       ├── service/impl/SampleServiceImpl.java
-│   │   │       ├── repository/SampleRepository.java
-│   │   │       ├── entity/Sample.java
-│   │   │       ├── dto/SampleDTO.java
-│   │   │       ├── dto/SampleQueryDTO.java
-│   │   │       ├── dto/SampleVO.java
-│   │   │       ├── param/SampleParam.java
-│   │   │       └── exception/SampleException.java
-│   │   └── resources/
-│   │       ├── application.yml
-│   │       ├── application-dev.yml
-│   │       ├── application-test.yml
-│   │       ├── application-prod.yml
-│   │       ├── bootstrap.yml
-│   │       └── logback-spring.xml
-│   └── test/
-│       └── java/
-│           └── com/meritdata/cloud/sample/
-│               ├── SampleApplicationTests.java
-│               ├── controller/SampleControllerTest.java
-│               └── service/impl/SampleServiceImplTest.java
-└── scripts/
-    ├── start.sh
-    └── stop.sh
-```
-
-## 3. 关键字段说明
-
-### 3.1 pom.xml
-
-| 字段 | 说明 | 默认值 |
-|------|------|--------|
-| `<groupId>` | 业务包名 | `com.example` |
-| `<artifactId>` | 服务名 | `my-2nd-service` |
-| `<version>` | 版本号 | `1.0.0-SNAPSHOT` |
-| `<parent>` | 父 POM | `com.meritdata.cloud:cloud-parent:5.6.0` |
-
-### 3.2 application.yml
-
-| 字段 | 说明 |
-|------|------|
-| `spring.application.name` | **必须改**：Nacos 注册名 |
-| `spring.profiles.active` | 当前激活 profile |
-| `spring.cloud.nacos.server-addr` | Nacos 地址（环境变量覆盖） |
-| `spring.datasource.url` | DB URL（环境变量覆盖） |
-
-### 3.3 README.md
-
-必须包含：
-
-```markdown
-# <项目名>
-
-## 项目简介
-<一句话>
-
-## 快速开始
-- 环境要求：JDK 8+ / Maven 3.6+ / MySQL 8.0
-- 安装步骤：mvn clean install
-- 运行方法：mvn spring-boot:run
-
-## 目录结构
-<树>
-
-## 配置说明
-- application.yml 通用配置
-- application-dev.yml 开发环境
-
-## 常见问题
-- ...
-```
-
-## 4. 常用定制
-
-### 4.1 加 MyBatis-Plus
-
-模板已默认包含。如需自定义：
-
-```xml
-<dependency>
-    <groupId>com.baomidou</groupId>
-    <artifactId>mybatis-plus-boot-starter</artifactId>
-    <version>3.5.5</version>
-</dependency>
-```
-
-```java
-@MapperScan("com.example.order.repository")
-public class OrderApplication { ... }
-```
-
-### 4.2 加 Swagger
-
-```xml
-<dependency>
-    <groupId>io.swagger</groupId>
-    <artifactId>swagger-models</artifactId>
-    <version>1.6.11</version>
-</dependency>
-```
-
-### 4.3 加 Nacos Config 加密
-
-```xml
-<dependency>
-    <groupId>com.meritdata.cloud</groupId>
-    <artifactId>cloud-config-encryption</artifactId>
-</dependency>
-```
-
-### 4.4 加 Knife4j（API 文档）
-
-```xml
-<dependency>
-    <groupId>com.github.xiaoymin</groupId>
-    <artifactId>knife4j-openapi2-jakarta-spring-boot-starter</artifactId>
-    <version>4.5.0</version>
-</dependency>
-```
-
-## 5. CI/CD 集成
-
-### 5.1 GitHub Actions（`.github/workflows/build.yml`）
-
-```yaml
-name: Build
-on: [push, pull_request]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-java@v3
-        with:
-          distribution: 'temurin'
-          java-version: '8'
-      - run: mvn clean verify
-```
-
-### 5.2 GitLab CI（`.gitlab-ci.yml`）
-
-```yaml
-build:
-  stage: build
-  image: maven:3.8-openjdk-8
-  script:
-    - mvn clean verify
-  cache:
-    paths:
-      - .m2/repository
-```
-
-## 6. ❌ 反模式
-
-### 6.1 ❌ 直接复制模板不改 groupId
-
-```xml
-<!-- ❌ 错：所有项目都是 com.meritdata.cloud.sample -->
-<groupId>com.meritdata.cloud.sample</groupId>
-```
-
-✅ 用 sed 替换为业务 groupId。
-
-### 6.2 ❌ 把模板的 sample 数据库当真库
-
-```yaml
-# ❌ 错
-spring:
-  datasource:
-    url: jdbc:mysql://127.0.0.1:3306/sample_db
-```
-
-✅ 改业务库名。
-
-### 6.3 ❌ application.yml 硬编码密码
-
-```yaml
-# ❌ 错
-spring:
-  datasource:
-    password: root123  # 提交到 git
-```
-
-✅ 用环境变量：`${DB_PASSWORD}`。
-
-## 7. 关联阅读
-
-- [guide.md](guide.md) — 脚手架指南
-- [verify.md](verify.md) — 校验清单
-- [SKILL.md](../SKILL.md)