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

package/skills/README.md

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

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