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

package/skills/meritdata-platform-cloud-dev/references/modules-mapping.md

@@ -1,162 +0,0 @@
-# 22 个内部模块 → 当前整合包 skill 路由映射
-
-> **目的**：把研发版 `meritdata-cloud-dev` v3.1.0 的 22 个内部模块（`modules/<name>/module.md`）映射到当前 `meritdata-platform-suite/` v2.1.0 的 L2/L3 skill。
-> **来源**：研发 skills/meritdata-cloud-dev/modules/（22 个 subdirectory）
-> **重组原则**：modules 内容大部分已被当前 L2/L3 skill 吸收或拆分；本文件是**路由索引**，不是内容复制。
-
----
-
-## 1. 处置类型图例
-
-| 标记 | 含义 | 数量 |
-|:----:|------|:----:|
-| ✅ **直接复用** | 当前已有同名/同名 skill | 14 |
-| 🔄 **合并入** | 当前多个 L2/L3 skill 合并覆盖 | 0（独立计数）|
-| ⚠️ **疑似合并** | 当前某 skill 部分覆盖，**待复核** | 0（独立计数）|
-| ❌ **缺失（待补）**| 当前无对应 skill，需新增 | 6 |
-| 🔀 **已拆分** | 1 个模块 → 当前多个 L2/L3 | 2（core / msg-job / http-client）|
-
-> **数字校验**：22 = 14 直接 + 8 缺口相关（6 缺失 + 2 拆分）
-
----
-
-## 2. 22 个模块完整映射表
-
-| # | 模块 ID | 主题 | 处置 | 当前对应 skill | 差距 / 待补 |
-|:-:|--------|------|:----:|-------------|-----------|
-| 1 | `merit-cloud-platform` | 平台能力图谱入口 | 🔀 **自身**| `meritdata-platform-cloud-dev`（自身）| ✅ 本 skill 就是该能力的载体 |
-| 2 | `merit-cloud-gen` | 工程生成（新工程 + 存量增量）| ✅ 直接复用 | `meritdata-bootstrap-2nd-dev` + `meritdata-platform-2nd-dev-check` | ✅ 已有 L4 工具对应 |
-| 3 | `merit-code-spec` | 代码规范与质量 | ✅ 直接复用 | `meritdata-platform-code-spec` + `meritdata-platform-code-review` | ✅ 已有 L2-M 对应 |
-| 4 | `merit-skill-governance` | skill 治理（自动校验）| ✅ 直接复用 | `tools/skill-vetter` + `tools/skill-stocktake` + `tools/skill-authoring-workflow` | ✅ 已有 L0 治理工具对应 |
-| 5 | `merit-cloud-domain-model` | 多表 / 聚合建模 | ✅ 直接复用 | `meritdata-platform-domain-model` | ✅ 已有 L2-M 对应 |
-| 6 | `merit-cloud-data-boundary` | cloud/业务库隔离 | ✅ 直接复用 | `meritdata-platform-data-boundary` | ✅ 已有 L2-M 对应 |
-| 7 | `merit-cloud-feign-api` | Feign + 跨服务契约 | 🔀 **合并入**| `meritdata-platform-data-access`（§Feign 装配）| ✅ 内容已合并，无独立 skill 必要 |
-| 8 | `merit-cloud-cache` | 多级缓存 | ✅ 直接复用 | `meritdata-platform-cache` | ✅ 已有 L3-C 对应 |
-| 9 | `merit-cloud-config` | Nacos 配置中心 | ✅ 直接复用 | `meritdata-platform-nacos-config` + `meritdata-platform-platform-config` | ✅ 已有 L3-C 对应 |
-| 10 | `merit-cloud-datasource` | 数据源（动态连接池 + 元数据）| ❌ **缺失**| — | ⚠️ 建议 v2.2.0 P1：在 `meritdata-platform-data-access` 加 references/datasource.md |
-| 11 | `merit-cloud-utils` | 工具类（日期 / ID / 加解密）| 🔀 **已拆分** | `meritdata-platform-session` + `meritdata-platform-sm-crypto` | ✅ 内容分散到 L3 |
-| 12 | `merit-cloud-logging` | 操作审计日志 | ✅ 直接复用 | `meritdata-platform-operation-log` | ✅ 已有 L3-C 对应 |
-| 13 | `meritdata-platform-bpm` | BPM 流程引擎 | ✅ 直接复用 | `meritdata-platform-bpm` | ✅ 已有 L2-C 对应 |
-| 14 | `merit-cloud-msg-job` | 消息 + 调度 | 🔀 **已拆分** | `meritdata-platform-job` + `meritdata-platform-message-center` | ✅ 内容已拆分 |
-| 15 | `meritdata-platform-impexp` | Excel 导入导出 | ✅ 直接复用 | `meritdata-platform-impexp` | ✅ 已有 L2-C 对应 |
-| 16 | `merit-cloud-file` | 业务附件（上传/下载/清理）| ❌ **缺失**| — | ⚠️ 建议 v2.2.0 P1：新建 `meritdata-platform-file`（L3-C）|
-| 17 | `meritdata-platform-org-user-api` | 同 JVM 组织/人员/权限 | 🔀 **已合并**| `meritdata-platform-org-user-api` + `meritdata-platform-lookup-api` + `meritdata-platform-permission` | ✅ 3 个 L3 覆盖 |
-| 18 | `meritdata-platform-data-access` | 同 JVM 平台实体 + QueryDSL | ✅ 直接复用 | `meritdata-platform-data-access` | ✅ 已有 L2-C 对应 |
-| 19 | `meritdata-platform-frontend` | 前端组件库 | ✅ 直接复用 | `meritdata-platform-frontend` + `meritdata-platform-ui-components` | ✅ 已有 L2-F + L3-F 对应 |
-| 20 | `merit-cloud-http-client` | 前端 HTTP 客户端 + 服务注册 | ❌ **缺失**| — | ⚠️ 建议 v2.2.0 P2：并入 `meritdata-platform-frontend` references/http-client.md |
-| 21 | `merit-cloud-webapi` | 对外 WebAPI（App-Key/Token）| ❌ **缺失**| — | ⚠️ 建议 v2.2.0 P2：并入 `meritdata-platform-data-access` references/webapi.md |
-| 22 | `merit-cloud-masterdata-sync` | 主数据同步（HR / 组织增量）| ❌ **缺失**| — | ⚠️ 建议 v2.2.0 P2：并入 `meritdata-platform-org-user-api` references/masterdata-sync.md |
-
----
-
-## 3. 已落地映射（14 个，✅ + 🔀 已合并/拆分）
-
-| 处置 | 模块数 | 模块列表 |
-|------|:----:|---------|
-| ✅ 直接复用（同名/同义）| 11 | platform / gen / spec / governance / domain-model / data-boundary / cache / config / logging / bpm / impexp / data-access（11+1）|
-| 🔀 合并入 L2-C 已有 skill | 2 | feign-api → data-access；platform-entities → data-access |
-| 🔀 已拆分到 L3 多 skill | 3 | utils → session + sm-crypto；msg-job → job + message-center；org-user-api → org-user-api + lookup-api + permission |
-
-**14 个已落地** = 11 直接复用 + 3 拆分/合并
-
----
-
-## 4. 缺失模块详细说明（6 个，待 v2.2.0+ 补齐）
-
-### 4.1 `merit-cloud-file`（业务附件）
-
-| 项 | 内容 |
-|----|------|
-| 主题 | 业务附件上传、回显、下载、删除、孤儿清理 |
-| 触发关键词 | 上传附件 / 下载文件 / 附件预览 / 孤儿文件清理 |
-| 涉及接口 | `FileUploadController` / `IFileService` / `BizFileController` |
-| 优先级 | **P1**（高频但当前缺失）|
-| 建议 | 新建 `meritdata-platform-file`（L3-C / java），SKILL.md + references/upload.md + references/orphan-cleanup.md |
-
-### 4.2 `merit-cloud-datasource`（数据源元数据）
-
-| 项 | 内容 |
-|----|------|
-| 主题 | 数据源连通性 + schema/table/column 元数据 + 动态连接池 |
-| 触发关键词 | 数据源配置 / 多数据源 / 动态连接池 / 元数据查询 |
-| 优先级 | **P1**（存量项目接入常用）|
-| 建议 | 不独立 skill，在 `meritdata-platform-data-access/references/datasource.md` 加子文档 |
-
-### 4.3 `merit-cloud-http-client`（前端 HTTP 客户端）
-
-| 项 | 内容 |
-|----|------|
-| 主题 | 前端跨服务调用 + 服务注册 + 网关签名 |
-| 触发关键词 | 前端跨服务 / Axios 拦截器 / 网关签名 |
-| 优先级 | **P2**（前端主 skill 已覆盖大部分）|
-| 建议 | 并入 `meritdata-platform-frontend/references/http-client.md` |
-
-### 4.4 `merit-cloud-webapi`（对外 WebAPI）
-
-| 项 | 内容 |
-|----|------|
-| 主题 | 对外发布 WebAPI（App-Key / App-Token / 签名校验）|
-| 触发关键词 | 对外接口 / App-Key / App-Token / 第三方接入 |
-| 优先级 | **P2**（特定业务才用）|
-| 建议 | 并入 `meritdata-platform-data-access/references/webapi.md` |
-
-### 4.5 `merit-cloud-masterdata-sync`（主数据同步）
-
-| 项 | 内容 |
-|----|------|
-| 主题 | HR / 组织 / 人员 / 角色 / 资源增量同步 + 失败重放 |
-| 触发关键词 | HR 同步 / 组织同步 / 增量同步 / 失败重放 |
-| 优先级 | **P2**（仅跨系统集成场景用）|
-| 建议 | 并入 `meritdata-platform-org-user-api/references/masterdata-sync.md` |
-
-### 4.6 `merit-cloud-utils`（工具类）
-
-| 项 | 内容 |
-|----|------|
-| 主题 | 日期工具 / ID 生成 / 加解密工具 |
-| 触发关键词 | 日期工具 / ID 生成器 / 加解密工具类 |
-| 优先级 | —（**已拆分**，无需独立 skill）|
-| 建议 | 已并入 `session` + `sm-crypto`，无需新增 |
-
-> 实际缺失数 = 5（不算已拆分的 utils）
-
----
-
-## 5. 处置统计
-
-```
-22 个模块
-  ├─ ✅ 直接复用          11（50%）
-  ├─ 🔀 合并入 / 已拆分    5（23%）
-  ├─ ❌ 缺失待补          6（27%）
-       ├─ 待独立 skill    1（file）
-       ├─ 待并入 references 4（datasource / http-client / webapi / masterdata-sync）
-       └─ 已拆分但保留引用 1（utils）
-  └─ 合计                22（100%）
-```
-
----
-
-## 6. v2.2.0 补齐行动表
-
-| 优先级 | 行动 | 触及模块 | 估算 |
-|:------:|------|---------|------|
-| **P1** | 新建 `meritdata-platform-file`（L3-C / java）| `merit-cloud-file` | 1 天 |
-| **P1** | 在 `data-access/references/` 加 `datasource.md` | `merit-cloud-datasource` | 半天 |
-| P2 | 在 `frontend/references/` 加 `http-client.md` | `merit-cloud-http-client` | 半天 |
-| P2 | 在 `data-access/references/` 加 `webapi.md` | `merit-cloud-webapi` | 半天 |
-| P2 | 在 `org-user-api/references/` 加 `masterdata-sync.md` | `merit-cloud-masterdata-sync` | 半天 |
-| **P0** | **新建 `meritdata-platform-cloud-dev`（本 skill）**| **全部** | **已完成**（v2.2.0）|
-
----
-
-## 7. 关联资源
-
-| 资源 | 路径 |
-|------|------|
-| 研发版源 modules | `研发skills/skills/meritdata-cloud-dev/modules/`（22 个 module.md）|
-| 研发版 skill-suite.json | `研发skills/skills/meritdata-cloud-dev/references/skill-suite.json` |
-| 研发版 scenario-contract.md | `研发skills/skills/meritdata-cloud-dev/references/scenario-contract.md` |
-| 当前整合包 4 层架构 | `meritdata-platform-suite/README.md §三` |
-| 三方映射清单 | `meritdata-platform-suite/docs/三方skill映射关系清单_20260907.md` |
-| 框架提取文档 | `meritdata-platform-suite/docs/二开12阶段开发流程文档框架提取_20260907.md` |

package/skills/meritdata-platform-cloud-dev/references/scenario-contract.md

@@ -1,75 +0,0 @@
-# 场景契约
-
-> 本文件定义 `meritdata-platform-cloud-dev` 处理的 7 类动作及其路由契约。
-> 来源：研发版 `meritdata-cloud-dev/references/scenario-contract.md` v3.1.0，本文件做了**精简**（移除内部模块细节，保留动作骨架）。
-
----
-
-## 1. 动作路由（7 类）
-
-| 动作 | 典型输入 | 主要输出 | 内部模块 | 当前整合包对应 skill |
-|------|---------|---------|---------|-------------------|
-| **能力查询** | 平台有什么人员/流程/缓存/附件能力 | 能力路径 + 证据 + 版本 + 边界 | `merit-cloud-platform` | `meritdata-platform-playbook`（L1 路由）+ 本 skill |
-| **集成查询** | 如何接 Feign / 认证 / 流程 / 消息 / 业务审计 | 契约候选 + 依赖 + GAP + 联调清单 | `merit-cloud-feign-api` / `meritdata-platform-bpm` / `merit-cloud-msg-job` / `merit-cloud-logging` | `meritdata-platform-data-access` / `meritdata-platform-bpm` / `meritdata-platform-job` / `meritdata-platform-operation-log` |
-| **方案设计** | 新系统 / 模块关系 / 数据边界 / 接口方案 | 服务 + 数据模型 + 接口 + 验证方案 | `merit-cloud-domain-model` / `merit-cloud-data-boundary` / `meritdata-platform-frontend` | `meritdata-platform-domain-model` / `meritdata-platform-data-boundary` |
-| **新工程** | scaffold + 模块 manifest | 完整前后端工程 + SQL + 文档 + 验证 | `merit-cloud-gen` + `merit-code-spec` + 相关平台模块 | `meritdata-bootstrap-2nd-dev`（L4 工具）+ `meritdata-platform-2nd-dev-check` |
-| **存量新增模块** | project_context + create_module | 模块补丁 + SQL migration + 接入清单 | `merit-cloud-gen` + `merit-cloud-domain-model` + `merit-code-spec` | `meritdata-platform-domain-model` + `meritdata-platform-code-spec` |
-| **已有模块扩展** | 真实源码 + 字段/API/页面/流程需求 | 符号级最小修改 + 迁移 + 回归结果 | `merit-cloud-gen` + `merit-code-spec` + 命中的专项模块 | 各 L2/L3 skill + `meritdata-platform-code-review` |
-| **项目验证** | manifest / 源码目录 / 工程 ZIP | 强制违规 + 建议 + 哈希 + 编译边界 | `merit-code-spec` + `merit-cloud-data-boundary` + 治理工具 | `meritdata-platform-2nd-dev-check`（L4）+ `tools/skill-vetter` + `tools/skill-stocktake` |
-
----
-
-## 2. 平台版本
-
-- **默认版本**：`6.13.2`
-- **不得静默使用**：必须显式声明用户项目使用的版本
-- **存量项目**：优先从 POM 和真实依赖读取版本
-- **路径/签名/返回包装/依赖**：不可跨版本照搬
-
----
-
-## 3. 输出状态（5 档）
-
-| 状态 | 含义 | 处置 |
-|------|------|------|
-| `PASS` | 适用门禁通过且无声明缺口 | 可交付 |
-| `PASS_WITH_SERVICE_REQUIREMENTS` | 平台语义存在，远程契约尚未接入 | 需联调 |
-| `PASS_WITH_DECLARED_GAPS` | 结构可用，但存在明确待联调或待取证能力 | 需补 GAP |
-| `NOT_RUN_REQUIRES_MERGE` | 存量模块补丁必须合入原项目后构建 | 不宣称编译通过 |
-| `FAIL` | 触发规范 / 数据边界 / manifest / 构建强制规则 | 阻断 |
-
----
-
-## 4. 强契约（与 playbook 的关键差异）
-
-| 维度 | playbook | 本 skill |
-|------|---------|---------|
-| 主入口 | 单 skill 路由 | **一个请求只能有一个主入口** |
-| 复合需求 | 多 skill 串联（flows.md）| **主入口 + 补充 modules 内部加载**，不让用户逐个选择 |
-| 模块来源 | references/intent-routing.md | `references/modules-mapping.md`（22 modules）|
-| 角色 | 路由器 | 执行引擎 |
-
----
-
-## 5. 决策约束（与 rules/code-dev-rules.md §八 联动）
-
-- 二开业务库**不得**连接或映射 cloud 平台表（`PF_` 前缀）
-- 平台 Entity 与 Q 类**只在同 JVM 且已验证依赖时使用**；独立二开服务**必须**转 Feign/API
-- 平台接口、Swagger/HTTP、Feign、本地 Bean、DTO、版本差异等**只使用随 Skill 发布的离线知识库与已登记证据**；**不得**在生成代码时要求用户提供平台源码、解压/反编译 Jar、访问维护人员本机目录或重新取证
-- 人员、部门、角色、字典、附件、富文本和流程字段**自动联动**对应公共能力（org-user-api / lookup-api / permission / file / bpm）
-- 业务表默认小写蛇形且**不使用** `PF_`；实体使用大驼峰
-- Git/SVN 状态和差异**只读**，提交**始终**由用户手动完成
-- 不生成 AI 开发 Journal；`merit-cloud-logging` 只处理生成后业务系统的运行审计（不处理 AI 自身）
-
----
-
-## 6. 相关资源
-
-| 资源 | 路径 |
-|------|------|
-| 22 modules 映射 | [modules-mapping.md](modules-mapping.md) |
-| skill 元数据 + 路由场景 | [skill-suite.json](skill-suite.json) |
-| schema | [skill-suite.schema.json](skill-suite.schema.json) |
-| 铁律前置约束 | `meritdata-platform-suite/rules/code-dev-rules.md §八` |
-| 顶层路由器 | `meritdata-platform-suite/skills/meritdata-platform-playbook/SKILL.md` |
-| 研发版源文件 | `研发skills/skills/meritdata-cloud-dev/references/scenario-contract.md` |

package/skills/meritdata-platform-cloud-dev/references/skill-suite.json

@@ -1,52 +0,0 @@
-{
-  "$schema": "./skill-suite.schema.json",
-  "schema_version": "1.0.0",
-  "suite_version": "1.0.0",
-  "platform_profiles_ref": "../references/modules-mapping.md",
-  "policies": {
-    "unknown_skill": "fail",
-    "unknown_platform_version": "fail",
-    "incubating_implicit_route": false,
-    "one_primary_per_route": true
-  },
-  "skills": [
-    {"id":"meritdata-platform-bpm","path":"meritdata-platform-bpm","lifecycle":"stable","kind":"integration","owner":"workflow","primary_capabilities":["workflow.runtime"],"excludes":["file.lifecycle","message.delivery"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-bpm"]},
-    {"id":"merit-cloud-config","path":"merit-cloud-config","lifecycle":"stable","kind":"knowledge","owner":"platform-config","primary_capabilities":["config.runtime","security.policy"],"excludes":["auth.code-generation"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-nacos-config","meritdata-platform-platform-config"]},
-    {"id":"merit-cloud-domain-model","path":"merit-cloud-domain-model","lifecycle":"stable","kind":"design","owner":"architecture","primary_capabilities":["domain.relationship-modeling"],"excludes":["code.rendering"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-domain-model"]},
-    {"id":"merit-cloud-data-boundary","path":"merit-cloud-data-boundary","lifecycle":"stable","kind":"governance","owner":"data-architecture","primary_capabilities":["data.platform-business-isolation"],"excludes":["datasource.metadata","integration.masterdata-sync"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-data-boundary"]},
-    {"id":"merit-cloud-feign-api","path":"merit-cloud-feign-api","lifecycle":"stable","kind":"integration","owner":"service-contract","primary_capabilities":["service.internal-feign"],"excludes":["integration.external-publishing"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-data-access"]},
-    {"id":"merit-cloud-gen","path":"merit-cloud-gen","lifecycle":"stable","kind":"generator","owner":"code-generation","primary_capabilities":["code.rendering","auth.code-generation"],"excludes":["service.fact-ownership"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-bootstrap-2nd-dev","meritdata-platform-2nd-dev-check"]},
-    {"id":"meritdata-platform-impexp","path":"meritdata-platform-impexp","lifecycle":"stable","kind":"integration","owner":"data-exchange","primary_capabilities":["data.excel-import-export"],"excludes":["file.lifecycle"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-impexp"]},
-    {"id":"merit-cloud-logging","path":"merit-cloud-logging","lifecycle":"stable","kind":"integration","owner":"audit","primary_capabilities":["audit.business-operation"],"excludes":[],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-operation-log"]},
-    {"id":"merit-cloud-msg-job","path":"merit-cloud-msg-job","lifecycle":"stable","kind":"integration","owner":"message-schedule","primary_capabilities":["message.delivery","schedule.job"],"excludes":["cache.pubsub"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-job","meritdata-platform-message-center"]},
-    {"id":"merit-cloud-platform","path":"merit-cloud-platform","lifecycle":"stable","kind":"router","owner":"platform-architecture","primary_capabilities":["knowledge.capability-graph"],"excludes":["domain.implementation"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-cloud-dev"]},
-    {"id":"meritdata-platform-org-user-api","path":"meritdata-platform-org-user-api","lifecycle":"stable","kind":"integration","owner":"platform-services","primary_capabilities":["service.organization-directory","service.authorization"],"excludes":["service.internal-feign","integration.masterdata-sync"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-org-user-api","meritdata-platform-lookup-api","meritdata-platform-permission"]},
-    {"id":"meritdata-platform-data-access","path":"meritdata-platform-data-access","lifecycle":"beta","kind":"knowledge","owner":"platform-entity-contract","primary_capabilities":["entity.platform-querydsl-index"],"excludes":["data.platform-business-isolation","service.internal-feign"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-data-access"]},
-    {"id":"meritdata-platform-frontend","path":"meritdata-platform-frontend","lifecycle":"stable","kind":"integration","owner":"frontend-platform","primary_capabilities":["ui.platform-components"],"excludes":["http.transport","code.rendering"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-frontend","meritdata-platform-ui-components"]},
-    {"id":"merit-cloud-utils","path":"merit-cloud-utils","lifecycle":"stable","kind":"knowledge","owner":"backend-runtime","primary_capabilities":["runtime.utility-session","runtime.date-id-crypto"],"excludes":["config.runtime"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-session","meritdata-platform-sm-crypto"]},
-    {"id":"merit-code-spec","path":"merit-code-spec","lifecycle":"stable","kind":"governance","owner":"quality","primary_capabilities":["quality.code-policy"],"excludes":["code.rendering"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-code-spec","meritdata-platform-code-review"]},
-    {"id":"merit-skill-governance","path":"merit-skill-governance","lifecycle":"stable","kind":"governance","owner":"skill-governance","primary_capabilities":["governance.skill-suite"],"excludes":["domain.implementation"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["tools/skill-vetter","tools/skill-stocktake","tools/skill-authoring-workflow"]},
-    {"id":"merit-cloud-cache","path":"merit-cloud-cache","lifecycle":"stable","kind":"integration","owner":"platform-runtime","primary_capabilities":["cache.kv","cache.hash","cache.queue","cache.counter","cache.pubsub"],"excludes":["message.delivery","lock.reliable-distributed"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified"},"maps_to":["meritdata-platform-cache"]},
-    {"id":"merit-cloud-file","path":"merit-cloud-file","lifecycle":"beta","kind":"integration","owner":"file-lifecycle","primary_capabilities":["file.lifecycle","file.security"],"excludes":["data.excel-import-export","workflow.runtime"],"supported_profiles":{"6.12.1":"compatible","6.13.2":"verified"},"maps_to":[],"gap":"待补：附件上传/下载/孤儿清理独立 references"},
-    {"id":"merit-cloud-datasource","path":"merit-cloud-datasource","lifecycle":"beta","kind":"integration","owner":"data-platform","primary_capabilities":["datasource.metadata","datasource.dynamic-pool","datasource.safe-sql"],"excludes":["domain.repository","data.etl"],"supported_profiles":{"6.10.1":"compatible","6.12.1":"verified","6.13.2":"verified-distribution"},"maps_to":[],"gap":"待补：数据源元数据 + 动态连接池 references"},
-    {"id":"merit-cloud-webapi","path":"merit-cloud-webapi","lifecycle":"beta","kind":"integration","owner":"external-api","primary_capabilities":["webapi.catalog","webapi.app-auth"],"excludes":["service.internal-feign","integration.masterdata-sync"],"supported_profiles":{"6.12.1":"compatible","6.13.2":"verified"},"maps_to":[],"gap":"待补：对外 WebAPI（App-Key/Token）references"},
-    {"id":"merit-cloud-masterdata-sync","path":"merit-cloud-masterdata-sync","lifecycle":"beta","kind":"integration","owner":"masterdata-integration","primary_capabilities":["integration.masterdata-sync"],"excludes":["service.organization-directory","data.etl"],"supported_profiles":{"6.12.1":"compatible","6.13.2":"verified"},"maps_to":[],"gap":"待补：HR/组织人员同步（增量同步 + 失败重放）references"},
-    {"id":"merit-cloud-http-client","path":"merit-cloud-http-client","lifecycle":"beta","kind":"integration","owner":"frontend-transport","primary_capabilities":["http.transport","http.service-registry"],"excludes":["ui.platform-components","service.internal-feign","webapi.app-auth"],"supported_profiles":{"6.12.1":"compatible","6.13.2":"verified"},"maps_to":[],"gap":"待补：前端 HTTP 客户端 + 服务注册 references"}
-  ],
-  "route_scenarios": [
-    {"id":"route.existing-add-module","prompt":"在现有项目新增采购申请模块，保留原工程配置","expected_primary":"merit-cloud-gen","allowed_supplemental":["merit-cloud-domain-model","merit-code-spec","meritdata-platform-impexp"]},
-    {"id":"route.existing-add-workflow","prompt":"给现有报销模块增加审批流程、人员选择和消息通知","expected_primary":"merit-cloud-gen","allowed_supplemental":["meritdata-platform-bpm","meritdata-platform-org-user-api","merit-cloud-msg-job","merit-code-spec"]},
-    {"id":"route.person-selector","prompt":"业务表单选择人员并回填名称","expected_primary":"meritdata-platform-org-user-api","allowed_supplemental":["meritdata-platform-frontend","merit-cloud-gen"]},
-    {"id":"route.workflow-attachment","prompt":"审批表上传附件并随流程归档","expected_primary":"meritdata-platform-bpm","allowed_supplemental":["merit-cloud-file"]},
-    {"id":"route.excel-import","prompt":"批量导入 Excel 并导出错误明细","expected_primary":"meritdata-platform-impexp","allowed_supplemental":["merit-cloud-logging"]},
-    {"id":"route.cache-ttl","prompt":"用平台 Redis 做租户隔离的 TTL 缓存和原子计数","expected_primary":"merit-cloud-cache","allowed_supplemental":["merit-cloud-config","merit-code-spec"]},
-    {"id":"route.business-file","prompt":"普通业务附件上传、回显、下载、删除和孤儿清理","expected_primary":"merit-cloud-file","allowed_supplemental":["meritdata-platform-frontend","merit-cloud-config"],"gap":"需先补 merit-cloud-file references"},
-    {"id":"route.datasource-metadata","prompt":"检查数据源连通性并读取 schema table column 元数据","expected_primary":"merit-cloud-datasource","allowed_supplemental":["merit-cloud-config"],"gap":"需先补 merit-cloud-datasource references"},
-    {"id":"route.cloud-data-boundary","prompt":"二开项目查询 cloud 库人员组织数据并设计多表查询","expected_primary":"merit-cloud-data-boundary","allowed_supplemental":["merit-cloud-domain-model","merit-cloud-feign-api","merit-cloud-gen"]},
-    {"id":"route.publish-webapi","prompt":"向外部 ERP 发布一个带 App-Key 和 App-Token 的接口","expected_primary":"merit-cloud-webapi","allowed_supplemental":["merit-cloud-logging"],"gap":"需先补 merit-cloud-webapi references"},
-    {"id":"route.sync-masterdata","prompt":"把外部组织人员角色增量同步到平台并支持失败重放","expected_primary":"merit-cloud-masterdata-sync","allowed_supplemental":["merit-cloud-webapi","merit-cloud-logging"],"gap":"需先补 merit-cloud-masterdata-sync references"},
-    {"id":"route.frontend-multi-service","prompt":"前端同时调用业务、system-manager 和 bpm-engine 并保留平台签名","expected_primary":"merit-cloud-http-client","allowed_supplemental":["meritdata-platform-frontend","merit-cloud-gen"],"gap":"需先补 merit-cloud-http-client references"},
-    {"id":"route.platform-entity-qclass","prompt":"同 JVM 项目核对平台人员实体字段并用 QueryDSL Q 类查询","expected_primary":"meritdata-platform-data-access","allowed_supplemental":["meritdata-platform-org-user-api","merit-cloud-config"]}
-  ],
-  "aliases": []
-}

package/skills/meritdata-platform-cloud-dev/references/skill-suite.schema.json

@@ -1,23 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://meritdata.example/schemas/skill-suite.schema.json",
-  "type": "object",
-  "required": ["schema_version", "suite_version", "platform_profiles_ref", "policies", "skills", "route_scenarios", "aliases"],
-  "properties": {
-    "skills": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "path", "lifecycle", "kind", "owner", "primary_capabilities", "excludes", "supported_profiles"],
-        "properties": {
-          "id": {"type": "string", "pattern": "^[a-z0-9-]+$"},
-          "path": {"type": "string"},
-          "lifecycle": {"enum": ["incubating", "beta", "stable", "deprecated", "retired"]},
-          "primary_capabilities": {"type": "array", "minItems": 1, "items": {"type": "string"}, "uniqueItems": true},
-          "excludes": {"type": "array", "items": {"type": "string"}, "uniqueItems": true},
-          "supported_profiles": {"type": "object", "minProperties": 1}
-        }
-      }
-    }
-  }
-}

package/skills/meritdata-platform-code-review/SKILL.md

@@ -1,42 +0,0 @@
----
-name: meritdata-platform-code-review
-description: |
-  代码审查。Java 代码审查清单；性能/安全/可维护性维度；code-spec 规则的实施场景。
-  触发场景：二开代码 PR review / Java 编码规范检查 / 性能问题排查 / 安全漏洞扫描。
-  何时不用：数据访问专项 → 用 data-access-review；测试用例 → 用 test-case。
-metadata:
-  version: "1.0.0"
-  author: petroleum+rd
-  source: petroleum+rd
-  date_added: "2026-09-07"
-  last_modified: "2026-09-07"
-  risk: medium
-  layer: L2
-  sub-layer: L2-M
-  stack: methodology
-allowed-tools: Read, Grep, Glob, Bash
----
-
-# 代码审查（code-review）
-
-## 触发
-- 二开 Java 代码 PR review
-- 性能问题代码定位（SQL/N+1/缓存）
-- 安全漏洞代码扫描（注入/越权/敏感）
-- 可维护性评估（命名/复杂度/重复）
-
-## 不触发
-- 数据访问专项（PF_/Feign/Entity）→ 用 `meritdata-platform-data-access-review`
-- 测试用例设计 → 用 `meritdata-platform-test-case`
-- 业务模型设计 → 用 `meritdata-platform-domain-model`
-
-## 前置约束
-- 审查**必须**涵盖 4 维度：正确性 / 性能 / 安全 / 可维护性
-- 严重问题（数据泄露/事务错误）**零容忍**
-- 审查结论**必须**有依据（具体行号 + 反例 + 修复建议）
-
-## 路由
-- 4 维度审查清单 → [references/guide.md](references/guide.md)
-- 性能审查（N+1/缓存/SQL）→ [references/performance.md](references/performance.md)
-- 安全审查（注入/越权/敏感）→ [references/security.md](references/security.md)
-- [SKILL.md](../SKILL.md)

package/skills/meritdata-platform-code-review/references/guide.md

@@ -1,173 +0,0 @@
-# 代码审查基础指南（code-review）
-
-> Java 代码 4 维度审查：正确性 / 性能 / 安全 / 可维护性。
-
----
-
-## 1. 4 维度清单
-
-### 1.1 正确性
-
-- [ ] 业务逻辑正确（边界、空值、状态机）
-- [ ] 异常处理完整（不吞异常 / 不空 catch）
-- [ ] 事务边界正确（@Transactional 范围）
-- [ ] 并发安全（线程安全集合、锁）
-
-### 1.2 性能
-
-- [ ] 无 N+1 查询
-- [ ] 无循环 DB / Feign
-- [ ] SQL 走索引
-- [ ] 缓存合理（key 带用户/租户）
-- [ ] 大对象不序列化
-
-### 1.3 安全
-
-- [ ] 无 SQL 拼接
-- [ ] 无 XSS（HTML 渲染转义）
-- [ ] 无越权（资源 + 数据权限）
-- [ ] 敏感数据脱敏（日志、响应）
-- [ ] 无硬编码密钥
-
-### 1.4 可维护性
-
-- [ ] 命名规范（类/方法/常量）
-- [ ] 方法长度 ≤ 50 行
-- [ ] 无重复代码
-- [ ] 注释解释"为什么"
-- [ ] 测试覆盖核心路径
-
----
-
-## 2. 审查流程
-
-```
-PR 创建
-   ↓
-1. 自动 CI（编译、扫描、测试）
-   ↓
-2. Reviewer 审查
-   ↓ 评审
-3. 评论（必须含：行号 + 问题 + 建议）
-   ↓
-4. 修改 → 重新审查
-   ↓
-5. 批准 → 合并
-```
-
-### 2.1 评审评论模板
-
-```markdown
-**问题**：<具体问题>
-**位置**：<文件:行号>
-**影响**：<严重程度>
-**建议**：<修复方案 + 代码示例>
-**优先级**：🔴 阻断 / 🟠 必须 / 🟢 建议
-```
-
-## 3. 严重度
-
-| 等级 | 处理 | 例子 |
-|------|------|------|
-| 🔴 阻断 | 必须修复才能合并 | 内存泄漏、数据丢失、安全漏洞 |
-| 🟠 必须 | 必须修复（可在 follow-up）| 性能问题、命名错误 |
-| 🟢 建议 | 后续重构 | 重复代码、注释不全 |
-
-## 4. 评审检查清单
-
-### 4.1 Controller 层
-
-- [ ] URL 命名规范（名词、复数、连字符）
-- [ ] HTTP 方法正确（GET/POST/PUT/DELETE）
-- [ ] 响应包装（`Result.success(data)`）
-- [ ] 参数校验（@Valid + JSR-303）
-- [ ] 权限校验（@PreAuthorize）
-- [ ] 异常处理（@ExceptionHandler）
-- [ ] 文档注解（@OpenAPIDefinition）
-
-### 4.2 Service 层
-
-- [ ] 接口和实现分离（IXxxService / XxxServiceImpl）
-- [ ] 事务边界（@Transactional）
-- [ ] 业务校验（前置 + 后置）
-- [ ] 不在循环内调用外部资源
-- [ ] 不吞异常
-- [ ] 不返回 null（用空集合 / Optional）
-
-### 4.3 Repository 层
-
-- [ ] 方法命名（findXxx / listXxx / saveXxx）
-- [ ] 无 SQL 拼接
-- [ ] 无 N+1
-- [ ] 索引走通（EXPLAIN）
-- [ ] 软删除穿透（findXxxIncludingDeleted）
-
-### 4.4 通用
-
-- [ ] 无硬编码常量
-- [ ] 无死代码
-- [ ] 无过度嵌套（≤ 3 层）
-- [ ] 日志规范（INFO/WARN/ERROR 正确）
-
-## 5. ❌ 反模式
-
-### 5.1 ❌ 评审无依据
-
-```markdown
-// ❌ 错
-这段代码有问题。
-```
-
-```markdown
-// ✅ 正确
-**问题**：N+1 查询
-**位置**：OrderService.list():42
-**影响**：1000 订单 → 1000 次 Feign，RT 30s
-**建议**：用 userClient.listByIds 批量装配
-**优先级**：🔴
-```
-
-### 5.2 ❌ 评审不区分严重度
-
-```markdown
-// ❌ 错
-这个变量名不好。这段代码有 SQL 注入。这两个都得改。
-```
-
-✅ 区分 🔴 阻断 / 🟠 必须 / 🟢 建议。
-
-### 5.3 ❌ 评审不写建议
-
-```markdown
-// ❌ 错
-这个方法太长了。
-```
-
-```markdown
-// ✅ 正确
-**问题**：方法 80 行（>50）
-**建议**：拆成 validate + calculate + save 三个方法
-**优先级**：🟢
-```
-
-## 6. 评审效率
-
-### 6.1 时间
-
-- 简单 PR（< 200 行）：15-30 分钟
-- 中等 PR（200-500 行）：30-60 分钟
-- 复杂 PR（> 500 行）：拆分或多次评审
-
-### 6.2 多人评审
-
-大型 PR 可指定 2-3 个 Reviewer 分维度评审：
-
-- Reviewer A：正确性 + 性能
-- Reviewer B：安全 + 可维护性
-
-## 7. 关联阅读
-
-- [performance.md](performance.md) — 性能审查
-- [security.md](security.md) — 安全审查
-- [rules/code-dev-rules.md](../../rules/code-dev-rules.md)
-- [SKILL.md](../SKILL.md)