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

package/CHANGELOG.md

@@ -0,0 +1,1094 @@
+# 变更记录（CHANGELOG）
+
+> 本文件记录 `meritdata-platform-suite/` 整合包的所有变更。版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
+
+---
+
+## v2.6.0 — 2026-09-08
+
+**P1 v2.2.0 缺口处理收尾**：4 / 4 个 v2.2.0 遗留缺口全部处理完毕（masterdata-sync + file + http-client + webapi），44 原始 skill 全部有对应。**35 skill / 0 真正缺失 / 0 疑似合并 / 0 剩余缺口**。
+
+### P1-A：`merit-cloud-http-client` 合并入 frontend（references 子目录）
+
+**决策**：`merit-cloud-http-client` 不独立成 skill，而是作为 references 子目录合并到 `meritdata-platform-frontend`（与 UI 组件、路由权限、认证等并列）。
+
+| 维度 | 详情 |
+|------|------|
+| **合并位置** | `meritdata-platform-frontend/references/http-client/` |
+| **新增 references** | `INDEX.md` / `service-registry.md` / `http-plugin.md` / `gateway-paths.md` / `acceptance.md`（5 篇） |
+| **核心覆盖** | 平台 plugin 自动处理 7 个 header（Cloud-Sign / qinLang / Request-Csrf-Token 等）+ 5 段路径拼接（gatewayOrigin + gatewayPrefix + serviceName + contextPath + controllerPath）+ 4 种 responseShape 解包 + 8 项验收（HC-01 ~ HC-08）|
+| **触发场景** | 新建前端页面要调多个后端服务（业务 + 人员 + BPM + 附件）|
+
+**为什么合并而非新建独立 skill**：
+- http-client 是 Vue2 前端栈专用（`@cloud-module-base/httpConfig/http-plugin`），与 frontend skill 同栈
+- 平台 plugin 自动处理的事（签名 / CSRF / session / 多租户 / 响应解包）业务方不需要单独 skill 学习
+- 5 段路径拼接 + 4 种 responseShape 是 registry 模式 + plugin 行为的子内容，不足以独立成 skill
+
+**新增 references 内容**：
+- **INDEX.md**：触发 / 不触发 / 前置约束 / 路由 + 关键反模式速查（Axios.defaults.headers / 二次解包 / 自签 Cloud-Sign 等 7 项）
+- **service-registry.md**：registry 声明式注册（service 5 类 + endpoint schema 10 字段 + responseShape × return 4 种组合）+ 完整采购订单详情页示例
+- **http-plugin.md**：平台 plugin 自动处理的 7 个 header + 会话过期处理 + Cloud-Sign 签名 + 4 种响应解包 + 错误分类 + 并发隔离 + 上传下载 + CSRF
+- **gateway-paths.md**：5 段路径模型 + 各段取法 + 拼接函数 join() + 5 段来源记录（pathProvenance）+ 开发代理配置
+- **acceptance.md**：HC-01 ~ HC-08 8 项验收（alias 注册 / 跨 service 并发 / 平台 header / 并发 50 次不污染 / 4 种响应解包 / 会话跳转 / 人员走 system-manager / system-manager 不可用隔离）+ 负例扫描 + 性能验收
+
+### P1-B：`merit-cloud-webapi` 合并入 data-access/outbound（reference 单文档）
+
+**决策**：`merit-cloud-webapi` 不独立成 skill，而是作为 outbound 方向合并到 `meritdata-platform-data-access` 的一个 reference（与 feign-guide / service-catalog 并列）。
+
+| 维度 | 详情 |
+|------|------|
+| **合并位置** | `meritdata-platform-data-access/references/outbound/webapi.md`（单篇）|
+| **核心覆盖** | 服务端 `/webapi/**` + App-Key/App-Token 认证 + IP 白名单 + 幂等键 + WebApiInfo/AppAuth 登记 + 431-437 错误码 + 7 项验收（WA-01 ~ WA-07）|
+| **触发场景** | 外部系统（供应商 / 银行 / 合作伙伴）要调用平台能力 |
+
+**为什么合并而非新建独立 skill**：
+- webapi 是 data-access outbound 方向的一个特殊路径（外部系统 → 平台），与 Feign 异 JVM 同属 outbound
+- 调用方向判定（外部 vs 同集群 vs 同 JVM）天然适合作为 data-access 5 步决策树的一部分
+- 7 项验收（WA-01 ~ WA-07）已涵盖 webapi 完整生命周期，独立成 skill 反而割裂 outbound 整体
+
+**新增 reference 内容**：
+- 调用方向判定（外部 → webapi 本 skill；同集群 → feign-guide；同 JVM → service-catalog）
+- 平台 4 类服务（App / Category / Info / Auth）
+- 接口编目 5 要素（稳定 URL / HTTP 方法 / schema / 责任人密级 / 幂等键超时版本）
+- App 注册与授权流程（App-Key + App-Token 短时 + IP 白名单 + 接口授权）
+- 431-437 认证错误码 + 业务 ResultBody 错误码
+- 生成规则（路径必须 `/webapi/**` + WebApiInfo 登记 + AppAuth 授权）
+- 7 项验收清单（路径 / 登记 / 授权 / IP / 幂等 / Secret 脱敏 / 密钥轮换）
+
+### SKILL.md 路由同步（3 个）
+
+- `meritdata-platform-frontend/SKILL.md`：触发加 http-client / 不触发加 webapi / 前置约束加 plugin 必须 / 路由加 5 篇 references/INDEX.md
+- `meritdata-platform-data-access/SKILL.md`：触发加 webapi / 不触发加 http-client / 新增"第 5 步 对外 WebApi" 路由 → `outbound/webapi.md`
+- `meritdata-platform-playbook/references/intent-routing.md`：加 2 行路由（前端多服务 axios / 对外 WebApi 发布）
+
+### 校验
+
+```bash
+$ bash tools/skill-vetter/run.sh
+========================================
+  结果: 35 通过 / 0 失败
+========================================
+4 个 warnings（与 v2.5.0 一致 + data-access 增至 130 行）：
+  - meritdata-dev-docs-file-finder：SKILL.md 215 行（>60）
+  - meritdata-platform-cloud-dev：SKILL.md 80 行（>60）
+  - meritdata-platform-data-access：SKILL.md 130 行（>60；v2.6.0 加 webapi 后 +19 行）
+  - meritdata-platform-file：SKILL.md 99 行（>60）
+```
+
+### 架构统计
+
+```
+v2.6.0 整合包：
+  rules：    12 条（不变）
+  skills：   35 个（不变，仅 references 补齐）
+            ├─ L1 入口：1
+            ├─ L2-M 方法论：7（不变）
+            ├─ L2-C 平台能力：6（不变；data-access outbound 子目录新增 webapi.md）
+            ├─ L2-F 前端：1（不变；新增 references/http-client/ 子目录）
+            ├─ L3-C 单点 API：15（不变）
+            ├─ L3-F 前端单点：2
+            └─ L4-T 工具：3
+  tools/：  3 个 L0 治理脚本
+```
+
+### 校验
+
+```bash
+$ bash tools/skill-vetter/run.sh
+========================================
+  结果: 35 通过 / 0 失败
+========================================
+4 个 warnings（与 v2.5.0 一致，非新增）：
+  - meritdata-dev-docs-file-finder：SKILL.md 215 行（>60）
+  - meritdata-platform-cloud-dev：SKILL.md 80 行（>60）
+  - meritdata-platform-data-access：SKILL.md 111 行（>60）
+  - meritdata-platform-file：SKILL.md 99 行（>60）
+```
+
+### 已知缺口（v2.7.0+ 处理）
+
+> v2.2.0 历史 4 个缺口（file / masterdata-sync / http-client / webapi）已全部处理完毕。当前无"真正缺失"。
+
+| 模块 | 状态 |
+|------|------|
+| 工业互联 / 石油 / 研发 三方 44 原始 skill | ✅ **100% 已映射**（35 当前 skill）|
+| v2.2.0 历史缺口（file + masterdata-sync + http-client + webapi）| ✅ **4/4 全部补齐** |
+
+---
+
+## v2.5.0 — 2026-09-08
+
+**P1 v2.2.0 缺口处理**：2 / 4 个 v2.2.0 遗留缺口已处理（masterdata-sync 合并 + file 新建），剩余 2 个缺口（http-client / webapi）推后。
+
+### P1-A：masterdata-sync 合并入 data-access（inbound 子目录）
+
+**决策**：`meritdata-platform-masterdata-sync` 不独立成 skill，而是作为 inbound 方向合并到 `meritdata-platform-data-access`（与 outbound 对称）。
+
+| 维度 | 详情 |
+|------|------|
+| **合并位置** | `meritdata-platform-data-access/references/inbound/` |
+| **新增 references** | `sync-contracts.md` / `canonical-payload.md` / `adapter-pattern.md` / `reconciliation.md` / `xml-security.md`（5 篇） |
+| **outbound 重组** | 9 篇原 outbound references 移入 `outbound/` 子目录，与新结构对齐 |
+| **SKILL.md 升级** | 4 步决策树 → 5 步（outbound + inbound） |
+| **方向定位** | outbound = 二开调用平台（Feign 同/异 JVM），inbound = 外部主数据反向同步到平台 |
+
+**为什么合并而非新建独立 skill**：
+- inbound 与 outbound 是同一问题的两个方向（"数据如何进出平台"）
+- 5 步决策树包含 inbound，避免拆成两个 skill 后还要互相 cross-reference
+- 适配器模式（来源 DTO → canonical payload → 平台 DTO）天然适合与 outbound 的"DTO 转换"复用基础设施
+- v2.3.1 攻略层已并入 `org-user-api/references/masterdata-sync-攻略/INDEX.md`，新增独立 skill 会形成双索引
+
+**新增 inbound references 内容**：
+- **sync-contracts.md**：REST vs WebService 选型（业务量 < 1000 条 / 实时性 < 1h → REST；政府/银行 WebService）
+- **canonical-payload.md**：canonical 负载（bizKey / waterLevel / batchNo + 6 种 bizType schema）
+- **adapter-pattern.md**：三层适配（来源 DTO → canonical → 平台 payload）+ BizKey 映射缓存 + 批量编排
+- **reconciliation.md**：4 维度对账（数据完整性 / 业务一致性 / 时序一致性 / 异常容灾）+ 5 档状态 + MS-01~MS-08 验收
+- **xml-security.md**：5 条铁律（禁用 DTD/外部实体/限制大小/SOAPAction 白名单/禁字符串拼接）+ SAX/DOM/JAXB 配置
+
+### P1-B：新建 `meritdata-platform-file` skill（业务附件契约集成）
+
+**决策**：新建独立 L3-C skill，整合 `merit-cloud-file`（石油 + 研发）的内容。**不是通用文件上传，是 6.13.2 业务附件契约集成**。
+
+| skill | SKILL.md | references |
+|-------|----------|------------|
+| `meritdata-platform-file` | 100 行 | 5 篇（lifecycle / api-contracts / security / examples / acceptance） |
+
+**核心覆盖**：
+- 6 个动作：上传 / 回显 / 下载 / 删除 / 复制 / 密级
+- 2 个 Service：`IUploadService`（按 joinId 管理）+ `IEnclosureService`（通用 enclosure）
+- 2 个 ID 模型：`joinId`（业务聚合关联，业务对象类型:ID）+ `fileId`（`PfUpload.id`）
+- 6 大安全控制：密级 / 租户 / 下载授权 / 文件校验 / 路径安全 / 审计
+- 8 项验收（MS-01 ~ MS-08）：业务对象不存在 → 拒；joinId 格式；长度限制；跨租户拒绝；密级不足拒绝；L3 业务权限；联动清理；6 类操作审计
+
+**为什么不并入 data-access**：
+- 文件附件有独立的 6 个动作 + 完整生命周期（孤儿文件清理 / 物理延迟删除），与 DTO 装配是不同抽象层
+- joinId / fileId 是新概念，data-access 的 5 步决策树不再适用
+- 安全规范（路径穿越 / 越权下载 / 病毒扫描 / 临时 URL）是文件领域专用，与 data-access 的数据访问不重叠
+
+**为什么不并入 platform-config**：
+- platform-config 是 Nacos 配置 + 平台参数读取，file 是附件元数据 + 存储抽象，职责完全不同
+- file 的 6 动作有自己的 Service 接口、entity 字段、错误码，不适合作为 platform-config 的子文档
+
+### SKILL.md 路由同步（2 个）
+
+- `meritdata-platform-data-access/SKILL.md` 第 4 步新增 inbound 路由（5 篇 references）
+- `meritdata-platform-playbook/SKILL.md` "集成 / 数据访问" 段新增 inbound 子路由 + file skill 直链
+
+### 架构统计
+
+```
+v2.5.0 整合包：
+  rules：    12 条（不变）
+  skills：   35 个（↑ +1 file）
+            ├─ L1 入口：1
+            ├─ L2-M 方法论：7（不变）
+            ├─ L2-C 平台能力：6（不变；data-access 新增 inbound 子目录）
+            ├─ L2-F 前端：1
+            ├─ L3-C 单点 API：15（↑ +1 file）
+            ├─ L3-F 前端单点：2
+            └─ L4-T 工具：3
+  tools/：  3 个 L0 治理脚本
+```
+
+### 校验
+
+```bash
+$ bash tools/skill-vetter/run.sh
+  结果: 35 通过 / 0 失败（待 v2.5.0 P1 完成后执行）
+```
+
+### 已知缺口（v2.6.0+ 处理）
+
+| 模块 | 缺口 | 建议 |
+|------|------|:----:|
+| `merit-cloud-http-client` | 无独立 skill | P2（并入 `frontend/references/http-client.md`）|
+| `merit-cloud-webapi` | 无独立 skill | P2（并入 `data-access/references/webapi.md`）|
+
+---
+
+## v2.4.0 — 2026-09-08
+
+**P1 疑似合并复核**：3 个 L3 skill 补齐缺失 references 子文档，决策记录如下。
+
+### 复核结论
+
+| 研发版 skill | 整合包目标 | 决策 | 子文档 |
+|--------------|------------|------|--------|
+| `meritdata-platform-basic-config-api` | `meritdata-platform-platform-config` | ❌ 不重叠（HTTP 接口 vs 业务参数）| ✅ 新建 `basic-config-api.md`（15+ 端点 + Feign Client + 缓存策略）|
+| `meritdata-platform-config-item` | `meritdata-platform-nacos-config` | ⚠️ 部分重叠（都 Nacos，但 `@ConfigurationProperties` 业务配置组缺）| ✅ 新建 `configuration-properties.md`（MeritdataCloudProperties + @RefreshScope 最佳实践）|
+| `meritdata-platform-data-secret` | `meritdata-platform-data-classification` | ⚠️ 部分重叠（都数据密级，但 `SECRET_LEVEL` + `@EnableDataSecretFilter` 缺）| ✅ 新建 `hibernate-filter.md`（5 级密级 + 1.17 平台接口 + 行/列权限差异）|
+
+### 新增（3 个 references 子文档）
+
+| skill | 路径 | 行数 | 覆盖内容 |
+|-------|------|-----:|---------|
+| `meritdata-platform-platform-config` | `references/basic-config-api.md` | 220 | 1.1-1.15 端点速查 + Feign Client + 缓存 TTL + 典型场景（首页/Logo/登录页）|
+| `meritdata-platform-nacos-config` | `references/configuration-properties.md` | 295 | MeritdataCloudProperties 模板 + 3 步标准用法 + `@Value`/`@NacosValue` 区别 + `@Validated` + List/Map 嵌套 + 5 个典型场景 |
+| `meritdata-platform-data-classification` | `references/hibernate-filter.md` | 255 | SECRET_LEVEL 1-5 定义 + `@EnableDataSecretFilter` 启用 + 1.17 平台 8 接口 + 行/列权限差异 |
+
+### SKILL.md 路由同步（3 个）
+
+- `meritdata-platform-platform-config/SKILL.md` 路由 +1（basic-config-api）
+- `meritdata-platform-nacos-config/SKILL.md` 路由 +2（configuration-properties + config-item-攻略）
+- `meritdata-platform-data-classification/SKILL.md` 路由 +1（hibernate-filter）
+
+### 架构统计（不变）
+
+```
+v2.4.0 整合包：
+  rules：    12 条
+  skills：   34 个（不变，仅 references 补齐）
+  tools/：  3 个 L0 治理脚本
+```
+
+### 校验
+
+```bash
+$ bash tools/skill-vetter/run.sh
+  结果: 34 通过 / 0 失败
+```
+
+### 决策记录（不重叠 vs 部分重叠）
+
+**为什么 basic-config-api 是不重叠而非部分重叠**：
+- 研发版覆盖 15+ HTTP 接口（`/api/base/*`），整合包 `platform-config` 是业务参数配置类（`@ConfigurationProperties`）
+- 二者技术栈不同：HTTP Feign Client vs Nacos 热更新
+- 不存在内容重复 → 纯增量补齐
+
+**为什么 config-item 是部分重叠**：
+- Nacos 通用用法（@NacosValue / NacosUtils）已在 `nacos-config/references/guide.md`
+- 研发版独有 `@ConfigurationProperties` + `MeritdataCloudProperties` + `@Validated` + List/Map 嵌套场景
+- 整合包之前**只覆盖 @NacosValue 单值用法**，未覆盖 POJO 业务配置组
+
+**为什么 data-secret 是部分重叠**：
+- 通用字段脱敏（手机号/身份证/银行卡）已在 `data-classification/references/masking.md`
+- DAM 行级权限已在 `integration-with-dam.md`
+- 研发版独有 `SECRET_LEVEL` 1-5 字段规范 + `@EnableDataSecretFilter` 注解式启用 + 1.17 平台 8 接口
+
+### 已知缺口（v2.5.0+ 处理）
+
+| 模块 | 缺口 | 建议 |
+|------|------|:----:|
+| `merit-cloud-file` | 无独立 skill | P1（新建 `meritdata-platform-file` 或并入 `data-access/references/file-attachment.md`）|
+| `merit-cloud-http-client` | 无独立 skill | P2（并入 `frontend/references/http-client.md`）|
+| `merit-cloud-webapi` | 无独立 skill | P2（并入 `data-access/references/webapi.md`）|
+| `merit-cloud-masterdata-sync` | 无独立 skill | P2（已部分纳入 `org-user-api/references/masterdata-sync-攻略/INDEX.md`，需要再补"自助 API"层 references）|
+
+---
+
+## v2.3.1 — 2026-09-08
+
+**P1 攻略索引补齐**：5 个 L3 skill 加 `*/references/*-攻略/INDEX.md`，攻略内容统一指向 dev-docs/ 知识源（**索引而非复制**）。
+
+### 新增
+
+#### 攻略索引（5 个 INDEX.md）
+
+| skill | 路径 | 攻略 | 章节数 |
+|-------|------|------|:------:|
+| `meritdata-platform-bpm` | `references/bpm-攻略/INDEX.md` | 攻略-01（流程API 16）+ 02（工作流程 8）+ 03（监听 6）+ 06（系统认证 5）+ 07（模块设计 8）+ 08（前端组件 6）| 49 |
+| `meritdata-platform-org-user-api` | `references/masterdata-sync-攻略/INDEX.md` | 攻略-09（组织人员同步）| 7 |
+| `meritdata-platform-job` | `references/scheduling-攻略/INDEX.md` | 攻略-10（定时调度）| 7 |
+| `meritdata-platform-nacos-config` | `references/config-item-攻略/INDEX.md` | 攻略-11（配置项）| 3 |
+| `meritdata-platform-message-center` | `references/message-攻略/INDEX.md` | 攻略-12（消息中心）| 4 |
+
+### 决策说明
+
+**为什么用索引而非复制**：
+- dev-docs/ 已是攻略的**唯一权威源**（v2.3.0 已整合 158 文件 / 2.3MB）
+- 复制会引入内容漂移（一份更新多处不更新）
+- INDEX 引用相对路径 `../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-NN-*.md` 保持单源
+- 攻略 6 章节归口：`06-系统认证` → `meritdata-platform-sso`，`08-流程前端组件` → `meritdata-platform-frontend`（在 bpm 索引保留导航，避免双索引混乱）
+
+### 架构统计（不变）
+
+```
+v2.3.1 整合包：
+  rules：    12 条
+  skills：   34 个（不变，攻略以 INDEX.md 形式作为 references 子目录）
+  tools/：  3 个 L0 治理脚本
+```
+
+### 校验
+
+```bash
+$ bash tools/skill-vetter/run.sh
+  结果: 34 通过 / 0 失败
+```
+
+### 已知缺口（v2.4.0+ 处理）
+
+| 模块 | 缺口 | 建议 |
+|------|------|:----:|
+| `merit-cloud-file` | 无独立 skill | P1（新建 `meritdata-platform-file` 或并入 `data-access/references/file-attachment.md`）|
+| `merit-cloud-http-client` | 无独立 skill | P2（并入 `frontend/references/http-client.md`）|
+| `merit-cloud-webapi` | 无独立 skill | P2（并入 `data-access/references/webapi.md`）|
+| `merit-cloud-masterdata-sync` | 无独立 skill | P2（已部分纳入 `org-user-api/references/masterdata-sync-攻略/INDEX.md`，需要再补"自助 API"层 references）|
+| `meritdata-platform-basic-config-api` | 疑似合并 | P2（评估是否补 references 子文档）|
+| `meritdata-platform-config-item` | 疑似合并 | P2（评估是否补 references 子文档）|
+| `meritdata-platform-data-secret` | 疑似合并 | P2（验证 `@EnableDataSecretFilter` 是否在 `data-classification` 完整覆盖）|
+
+---
+
+## v2.3.0 — 2026-09-08
+
+**补齐兜底查找 skill `meritdata-dev-docs-file-finder`**：v2.2.0 误判为"内容缺失"（漏扫 `研发skills/dev-docs/`），现追加 158 文件 / 2.3MB 知识库，34 skill。
+
+### v2.2.0 漏扫承认
+
+> **v2.2.0 已知漏扫**：扫描研发 skills 时**漏掉** `研发skills/dev-docs/` 目录（133 文件 / 32K 行 + .bak 25 文件）。
+> **原因**：扫描脚本只读 `skills/` 子目录，未读 `dev-docs/`。
+> **影响**：`meritdata-dev-docs-file-finder` 被误判为"内容缺失"，延迟至 v2.3.0 才补齐。
+
+### 新增
+
+#### L2-M 兜底查找 skill（1 个）
+
+| skill | SKILL.md | references |
+|-------|----------|------------|
+| `meritdata-dev-docs-file-finder` | 174 行 | scenarios.md + keywords.md + dev-docs/（158 文件 / 2.3MB）|
+
+**核心覆盖**：
+- 17 个公共资产拆分文件（缓存 / Nacos / 国密 / Session / 日志 / BPM / Job / UI 组件）
+- 32 个外部接口拆分文件（基础配置 / 组织人员 / 数据密级 / 资源授权 / 字典 / 数据源）
+- 10 篇使用攻略（80 文件，BPM / 系统认证 / 组织同步 / 定时调度 / 配置项 / 消息中心）
+- 4 个根级索引（README / CLAUDE / AGENTS / REQUIREMENT_DESIGN_REFERENCE）
+
+**skill 工作流**（5 步）：
+1. 检测需求是否充分（不充分则反问 4 方向）
+2. 读 `references/scenarios.md` 场景匹配（30+ 场景）
+3. 读 `references/keywords.md` 关键词反查（兜底）
+4. 输出 ≤3 个推荐文件 + 一句话说明
+5. **find 后必 read**（AI 必须 `Read` 推荐文件后才能回答）
+
+### 架构统计
+
+```
+v2.3.0 整合包：
+  rules：    12 条（无变化）
+  skills：   34 个（↑ +1 dev-docs-file-finder）
+            ├─ L1 入口：1
+            ├─ L2-M 方法论：7（↑ +1 dev-docs-file-finder）
+            ├─ L2-C 平台能力：6
+            ├─ L2-F 前端：1
+            ├─ L3-C 单点 API：14
+            ├─ L3-F 前端单点：2
+            └─ L4-T 工具：3
+  tools/：  3 个 L0 治理脚本
+```
+
+### 校验
+
+```bash
+$ bash tools/skill-vetter/run.sh
+========================================
+  结果: 34 通过 / 0 失败
+========================================
+
+$ bash tools/skill-stocktake/run.sh
+总数: 34 个 skill
+  L1       1
+  L2       15  (M=7 / C=6 / F=1 + 拆分后 1)
+  L3       16
+  L4       3
+```
+
+### playbook 同步
+
+- intent-routing.md 表格新增"知识兜底查找 → dev-docs-file-finder"路由条目
+- flows.md 流程 1/6/7 增加"复杂场景找不到时 → dev-docs-file-finder"兜底指引
+
+---
+
+## v2.2.0 — 2026-09-07
+
+**补齐执行入口 `meritdata-platform-cloud-dev`**：v2.0.0 遗漏的执行引擎补齐，4 层架构扩展为 33 skill。
+
+### 遗漏承认（v2.0.0）
+
+> **v2.0.0 已知遗漏**：未引入 `meritdata-cloud-dev`（研发，含 22 modules/ + 强契约）。
+> **原因**：与 `meritdata-platform-playbook` 名称重叠被误判为冗余。
+> **实际两者职责不同**：
+> - `playbook`（L1）= 路由器（"用哪个 skill"）
+> - `meritdata-platform-cloud-dev`（L2-C）= 执行引擎（"动手生成代码"）
+>
+> 详见 `docs/三方skill映射关系清单_20260907.md §7.1`。
+
+### 新增
+
+#### L2-C 执行引擎 skill（1 个）
+
+| skill | SKILL.md | references |
+|-------|----------|------------|
+| `meritdata-platform-cloud-dev` | 80 行 | modules-mapping.md + scenario-contract.md + skill-suite.json + skill-suite.schema.json |
+
+**核心覆盖**：
+- 22 个内部 modules（`merit-cloud-platform / gen / data-boundary / domain-model / feign-api / cache / config / datasource / utils / logging / bpm / msg-job / impexp / file / org-user-api / data-access / frontend / http-client / webapi / masterdata-sync` + `merit-code-spec` + `merit-skill-governance`）→ 当前 14 个 L2/L3 skill 的路由映射
+- 7 类动作契约（能力查询 / 集成查询 / 方案设计 / 新工程 / 存量新增 / 已有模块扩展 / 项目验证）
+- 5 档输出状态（PASS / PASS_WITH_SERVICE_REQUIREMENTS / PASS_WITH_DECLARED_GAPS / NOT_RUN_REQUIRES_MERGE / FAIL）
+- 13 个典型路由场景（如"现有项目新增采购申请模块"）
+
+#### playbook 同步
+
+- intent-routing.md 新增"复杂需求 / 代码生成 → cloud-dev"路由条目
+- 与 cloud-dev 分工明确：playbook 处理"我要用哪个 skill"，cloud-dev 处理"我来执行这个需求"
+
+### 架构统计
+
+```
+v2.2.0 整合包：
+  rules：    12 条（无变化）
+  skills：   33 个（↑ +1）
+            ├─ L1 入口：1
+            ├─ L2-M 方法论：6
+            ├─ L2-C 平台能力：6（↑ +1 cloud-dev）
+            ├─ L2-F 前端：1
+            ├─ L3-C 单点 API：14
+            ├─ L3-F 前端单点：2
+            └─ L4-T 工具：3
+  tools/：  3 个 L0 治理脚本
+```
+
+#### 4 层架构完成度
+
+| 层 | 状态 | 内容 |
+|----|------|------|
+| L0 治理 | ✅ 完成 | 12 条铁律 rules + 3 个 tools/ 脚本 |
+| L1 入口 | ✅ 完成 | playbook |
+| L2 领域 | ✅ 完成 | 14 个 skill（M×6 / C×7 / F×1）|
+| L3 单点 API | ✅ 完成 | 16 个 skill（14 java + 2 frontend）|
+| L4 工具 | ✅ 完成 | 3 个 skill（bootstrap/importer/check）|
+
+### 校验
+
+```bash
+$ bash tools/skill-vetter/run.sh
+========================================
+  结果: 33 通过 / 0 失败
+========================================
+
+$ bash tools/skill-stocktake/run.sh
+总数: 33 个 skill
+  L1       1
+  L2       14
+  L3       16
+  L4       3
+```
+
+### 已知缺口（v2.3.0+ 处理）
+
+详见 `references/modules-mapping.md §4`：
+
+| 模块 | 缺口 | 建议优先级 | v2.3.0 状态 |
+|------|------|:--------:|:--------:|
+| `merit-cloud-file` | 无独立 skill | P1（新建 `meritdata-platform-file`）| 待 v2.3.1+ |
+| `merit-cloud-datasource` | 无独立 skill | P1（并入 `data-access/references/datasource.md`）| ✅ v2.2.0 已补 |
+| `merit-cloud-http-client` | 无独立 skill | P2（并入 `frontend/references/http-client.md`）| 待 v2.3.1+ |
+| `merit-cloud-webapi` | 无独立 skill | P2（并入 `data-access/references/webapi.md`）| 待 v2.3.1+ |
+| `merit-cloud-masterdata-sync` | 无独立 skill | P2（并入 `org-user-api/references/masterdata-sync.md`）| 待 v2.3.1+ |
+| `meritdata-bpm-2nd-dev` | 流程攻略资源库 | P1（作为 `bpm/references/` 子文档）| 待 v2.3.1+ |
+| `meritdata-dev-docs-file-finder` | dev-docs 兜底 | P2（独立 skill）| ✅ v2.3.0 已补 |
+
+---
+
+## v2.1.0 — 2026-09-07
+
+**L4 + L0 治理完工**：3 个 L4 工具 skill + 3 个 `tools/` 治理脚本。4 层架构完整闭环。
+
+### 新增
+
+#### L4 工具 skill（3 个）
+
+| skill | SKILL.md | references |
+|-------|----------|------------|
+| `meritdata-bootstrap-2nd-dev` | 38 行 | guide.md + template.md + verify.md |
+| `meritdata-nacos-importer` | 38 行 | guide.md + yaml-spec.md + gray-publish.md |
+| `meritdata-platform-2nd-dev-check` | 38 行 | guide.md + rules-checklist.md + ci-integration.md |
+
+**核心覆盖**：
+- `bootstrap-2nd-dev`：二开 Maven 项目脚手架（template 生成 + 变量替换 + 启动校验）
+- `nacos-importer`：Nacos 配置批量导入（YAML/Properties 规范 + 灰度发布流程）
+- `2nd-dev-check`：9 条规则合规扫描（4 data-boundary + 3 domain-model + 2 code-spec，CI 集成）
+
+#### L0 治理 scripts（`tools/` 目录，3 个）
+
+| 工具 | 功能 |
+|------|------|
+| `tools/skill-vetter/run.sh` | skill 结构校验（frontmatter / 必填字段 / 4 大章节 / 行数） |
+| `tools/skill-stocktake/run.sh` | skill 清单盘点（console / JSON / Markdown 三种格式） |
+| `tools/skill-authoring-workflow/` | skill 编写规范（README + SKILL.md 模板 + references 模板） |
+
+**核心覆盖**：
+- skill-vetter：CI 门禁用，每次 PR 校验所有 skill 结构
+- skill-stocktake：阶段验收用，统计 skill 数量 + Layer 分布 + 行数
+- skill-authoring-workflow：模板 + 校验清单，新人快速上手
+
+#### playbook 同步
+
+- intent-routing.md 表格 L4 工具行去掉"待建 P4"
+- 新增 "L4 工具 skill 清单（3 个，全部已交付）" 章节
+
+### 架构统计
+
+```
+v2.1.0 整合包：
+  rules：    12 条（无变化）
+  skills：   32 个（↑ +3）
+            ├─ L1 入口：1
+            ├─ L2-M 方法论：6
+            ├─ L2-C 平台能力：6
+            ├─ L2-F 前端：1（↓ frontend 仍为 L2）
+            ├─ L3-C 单点 API：13（包含 backend-deploy）
+            ├─ L3-F 前端单点：2
+            └─ L4-T 工具：3
+  tools/：  3 个 L0 治理脚本（↑ +3）
+```
+
+#### 4 层架构完成度
+
+| 层 | 状态 | 内容 |
+|----|------|------|
+| L0 治理 | ✅ 完成 | 12 条铁律 rules + 3 个 tools/ 脚本 |
+| L1 入口 | ✅ 完成 | playbook |
+| L2 领域 | ✅ 完成 | 13 个 skill（M/C/F 三亚层） |
+| L3 单点 API | ✅ 完成 | 19 个 skill（13 java + 2 frontend + 3 method） |
+| L4 工具 | ✅ 完成 | 3 个 skill（bootstrap/importer/check） |
+
+### 校验
+
+```bash
+$ bash tools/skill-vetter/run.sh
+========================================
+  skill-vetter: skill 合规校验
+========================================
+扫描目录: .../skills
+
+[全部 32 个 skill 通过]
+
+========================================
+  结果: 32 通过 / 0 失败
+========================================
+```
+
+---
+
+## v2.0.0 — 2026-09-07
+
+**4 层架构完整落地**：19 个 L3 单点 API skill 全部交付。
+
+### 变更（主版本升级：4 层架构完成）
+
+> **说明**：v2.0.0 未新增 L0 rules——`rules/` 仍为 12 条（v1.0 起的稳定集合）。L0 治理层的扩展（skill-authoring / skill-vetter / skill-stocktake）放在 **L4 工具层**（`tools/` 目录），由 P4 交付。
+
+#### 新增：L3 单点 API skill（19 个）
+
+**Group 1 — 缓存 / 配置 / 加密 / 密级（4 个 L3-C）**
+
+| skill | SKILL.md | references |
+|-------|----------|------------|
+| `meritdata-platform-cache` | 38 行 | guide.md + multi-level.md + redis-config.md |
+| `meritdata-platform-nacos-config` | 38 行 | guide.md + shared-config.md + gray-publish.md |
+| `meritdata-platform-sm-crypto` | 38 行 | guide.md + sm2-sm4.md + key-mgmt.md |
+| `meritdata-platform-data-classification` | 38 行 | guide.md + dam-rule.md + integration.md |
+
+**Group 2 — 会话 / 日志 / 消息 / 字典（4 个 L3-C）**
+
+| skill | SKILL.md | references |
+|-------|----------|------------|
+| `meritdata-platform-session` | 38 行 | guide.md + multi-device.md + token-store.md |
+| `meritdata-platform-operation-log` | 38 行 | guide.md + sensitive-and-async.md + storage.md |
+| `meritdata-platform-message-center` | 38 行 | guide.md + channels.md + template.md |
+| `meritdata-platform-lookup-api` | 38 行 | guide.md + cache-strategy.md + extend.md |
+
+**Group 3 — 组织 / 菜单 / 资源 / 权限 / 平台配置（5 个 L3-C）**
+
+| skill | SKILL.md | references |
+|-------|----------|------------|
+| `meritdata-platform-org-user-api` | 38 行 | guide.md + soft-delete-pitfalls.md + dam-integration.md |
+| `meritdata-platform-menu-config` | 38 行 | guide.md + menu-tree.md + cache.md |
+| `meritdata-platform-menu-resource` | 38 行 | guide.md + auth-and-path.md + cache-invalidate.md |
+| `meritdata-platform-permission` | 38 行 | guide.md + custom-rule.md + amount-limit.md |
+| `meritdata-platform-platform-config` | 38 行 | guide.md + global-flags.md + params.md |
+
+**Group 4 — 前端 / 部署（2 个 L3-F + 1 个 L3-C）**
+
+| skill | sub-layer | SKILL.md | references |
+|-------|-----------|----------|------------|
+| `meritdata-platform-ui-components` | L3-F | 38 行 | guide.md + components.md + theming.md |
+| `meritdata-platform-frontend-deploy` | L3-F | 38 行 | guide.md + nginx.md + cdn.md |
+| `meritdata-platform-backend-deploy` | L3-C | 38 行 | guide.md + docker.md + health-monitor-log.md |
+
+**Group 5 — 审查 / 测试（3 个 L2-M 扩展）**
+
+| skill | SKILL.md | references |
+|-------|----------|------------|
+| `meritdata-platform-data-access-review` | 38 行 | guide.md + ci-scan.md + anti-patterns.md |
+| `meritdata-platform-code-review` | 38 行 | guide.md + performance.md + security.md |
+| `meritdata-platform-test-case` | 38 行 | guide.md + unit-test.md + integration-test.md |
+
+#### playbook 同步
+
+- intent-routing.md 表格加完整 19 个 L3 skill 路由条目
+- 删除全部 "待建 P3" 标记
+- 新增 "L3 skill 清单（19 个，全部已交付）" 章节
+- flows.md 流程补全相关 L3 skill 引用
+
+#### 架构统计
+
+```
+v2.0.0 整合包：
+  rules：    12 条（无变化）
+  skills：   29 个（↑ +19 = 10 + 19）
+            ├─ L1 入口：1
+            ├─ L2-M 方法论：6（3 核心 + 3 P3 扩展）
+            ├─ L2-C 平台能力：6（bpm/data-access/job/impexp/sso/backend-deploy）
+            ├─ L2-F 前端：1
+            ├─ L3-C 单点 API：13
+            └─ L3-F 前端单点：2
+```
+
+#### 4 层架构完成度
+
+| 层 | 状态 | 内容 |
+|----|------|------|
+| L0 治理 | ✅ 完成 | 13 条铁律 rules |
+| L1 入口 | ✅ 完成 | playbook |
+| L2 领域 | ✅ 完成 | 13 个 skill（M/C/F 三亚层） |
+| L3 单点 API | ✅ 完成 | 19 个 skill（13 java + 2 frontend + 3 method） |
+| L4 工具 | ⏳ 待建 P4 | bootstrap / nacos-importer / check / vetter / stocktake |
+
+---
+
+## v1.3.0 — 2026-09-07
+
+**L2 维度修正**：合并 data-access + 加亚层标注。
+
+### 变更（不兼容 → 主版本升级）
+
+#### 合并：data-access 取代 3 个旧 skill
+
+| 旧 skill（v1.2）| 新 skill（v1.3）| 说明 |
+|------------------|-----------------|------|
+| `meritdata-platform-entities` | `meritdata-platform-data-access` | 平台 DTO + Q 类 |
+| `meritdata-platform-services` | `meritdata-platform-data-access` | 同 JVM Service |
+| `meritdata-platform-integration` | `meritdata-platform-data-access` | Feign + 第三方 |
+
+**理由**：entities + services + integration 本质是同一个问题（"如何访问外部数据"），只是按 JVM 部署形态拆开。合并后：
+- SKILL.md 用 4 步决策树路由到 9 个 references
+- references/ 保留所有原内容，无信息丢失
+
+#### 新增：L2 亚层标注
+
+所有 L2 skill 的 frontmatter 增加两个字段：
+
+```yaml
+metadata:
+  layer: L2
+  sub-layer: L2-M | L2-C | L2-F    # 亚层
+  stack: methodology | java | frontend
+```
+
+| 亚层 | 含义 | skill |
+|------|------|-------|
+| **L2-M** | 方法论（HOW） | code-spec / data-boundary / domain-model |
+| **L2-C** | 平台能力 Java | bpm / job / impexp / sso / data-access |
+| **L2-F** | 前端 | frontend |
+
+**意义**：
+- playbook 路由可按 sub-layer + stack 分流
+- 方法论恒定触发，能力条件触发，前端独立栈
+- CI 校验可按 sub-layer 分级（L2-M 全量、L2-C 按使用、L2-F 独立工具链）
+
+#### playbook 同步
+
+- intent-routing.md 表格加 `sub-layer` + `stack` 列
+- data-access 取代 entities/services/integration 三行
+- flows.md 流程 4 的 integration → data-access
+
+---
+
+## v1.2.0 — 2026-09-07
+
+**P2 完成**：8 个 L2 领域 skill（bpm / entities / services / integration / frontend / job / impexp / sso）。
+
+### 新增
+
+#### Skills（8 个 L2 领域）
+
+| skill | SKILL.md | references |
+|-------|----------|------------|
+| `meritdata-platform-bpm` | 35 行 | guide.md（流程设计/状态字段/回调）|
+| `meritdata-platform-entities` | 33 行 | dto-catalog.md + querydsl-guide.md + dto-converter.md |
+| `meritdata-platform-services` | 38 行 | service-catalog.md + same-jvm-detection.md + usage-patterns.md |
+| `meritdata-platform-integration` | 38 行 | feign-guide.md + batch-assembly.md + third-party.md |
+| `meritdata-platform-frontend` | 38 行 | components.md + project-structure.md + auth-and-api.md |
+| `meritdata-platform-job` | 38 行 | xxl-job-guide.md + idempotency.md + scenarios.md |
+| `meritdata-platform-impexp` | 38 行 | excel-guide.md + async-and-validate.md + scenarios.md |
+| `meritdata-platform-sso` | 38 行 | sso-guide.md + oauth-providers.md + filter-config.md |
+
+**核心覆盖**：
+- 平台能力接入：流程/任务/导入导出/SSO
+- 数据访问：DTO + Q 类 + Feign 批量装配
+- 前端：组件 + 工程 + 权限
+- 同 JVM vs 独立部署的判定
+
+### 变更
+
+- 整合包当前共 **12 个 skill**（P0 × 3 + P1 × 1 + P2 × 8）
+- playbook 的 intent-routing.md / flows.md 已同步新增 skill 的路由条目
+
+---
+
+## v1.1.0 — 2026-09-07
+
+**P1 完成**：L1 入口 `meritdata-platform-playbook`。
+
+### 新增
+
+#### Skills（1 个 P1）
+
+| skill | layer | SKILL.md | references/ |
+|-------|-------|----------|-------------|
+| `meritdata-platform-playbook` | L1 | 43 行 | intent-routing.md（117 行）+ flows.md（185 行）|
+
+**核心职责**：
+- 唯一对外 L1 入口（其他 skill 不直接暴露）
+- 识别用户动作意图 → 路由到 L2 skill
+- 复合需求（多 skill 组合）按典型流程串联
+
+**典型流程**（flows.md 已覆盖）：
+1. 新建二开业务模块（最常见）
+2. 加审批流
+3. 加导入导出
+4. 加定时任务
+5. 接入平台 UI 组件
+6. 排查 Bug
+7. 新二开项目冷启动
+8. 加权限 / 数据范围
+
+**意图路由表**（intent-routing.md 已覆盖）：
+- 建模类 → domain-model / bpm / entities / services
+- 数据访问类 → data-boundary / integration
+- 编码规范类 → code-spec
+- 平台能力类 → L3 字典/组织/缓存/Nacos/国密/...
+- 前端/部署/工具 → frontend / L3 / L4
+- 诊断/学习 → investigate-bug / 测试 / 审查
+
+### 变更
+- 整合包当前共 **4 个 skill**（P0 × 3 + P1 × 1）
+
+---
+
+## v1.0.0 — 2026-09-07
+
+**整合包首版**。3 个团队（44 个 skill）合并为 12 条铁律 + 3 个方法论 skill。
+
+### 新增
+
+#### Rules（12 条铁律，自动加载）
+
+| 文件 | 内容 | 行数 | 来源 |
+|------|------|------|------|
+| `rules/README.md` | 索引 + 抽取原则 + CLAUDE.md 集成方法 | 63 | 整合新建 |
+| `rules/api-design-rules.md` | REST API 设计（URL/方法/请求/状态码/版本/文档）| 96 | 研发 |
+| `rules/code-dev-rules.md` | 通用代码开发 + §八 方法论铁律（data-boundary/domain-model/code-spec）| 167 | 研发+石油 |
+| `rules/coding-standards-rules.md` | 资源/集合/字符串/异常/并发/对象/日志（编码细节）| 7 | 工业互联 |
+| `rules/frontend-coding-rules.md` | 前端编码规范 | 128 | 工业互联 |
+| `rules/frontend-component-rules.md` | 前端组件 | 174 | 工业互联 |
+| `rules/git-workflow-rules.md` | Git 分支/提交/合并/Commit Hooks/PR | 85 | 工业互联 |
+| `rules/nacos-rules.md` | Nacos 配置中心 | 154 | 研发 |
+| `rules/naming-conventions-rules.md` | 类/方法/常量/变量/包/配置/文件命名 | 98 | 工业互联 |
+| `rules/performance-rules.md` | DB/缓存/并发/内存/响应时间/日志 | 102 | 工业互联 |
+| `rules/security-rules.md` | 注入/认证/敏感信息/传输/文件/安全配置 | 91 | 工业互联 |
+| `rules/sql-naming-rules.md` | SQL 命名规范 | 396 | 研发 |
+| `rules/sql-script-rules.md` | SQL 脚本规范 | 146 | 研发 |
+
+**合并原则**：三方去重 + 标注源团队；通用规范（资源/集合/异常/并发）已整合到 `code-dev-rules.md` §一-§六。
+
+#### Skills（3 个方法论，P0 完成）
+
+| skill | layer | SKILL.md | references/anti-patterns.md | references/validate-rules.md |
+|-------|-------|----------|-----------------------------|------------------------------|
+| `meritdata-platform-code-spec` | L2 | 33 行 | 532 行 | 320 行 |
+| `meritdata-platform-data-boundary` | L2 | 38 行 | 518 行 | 340 行 |
+| `meritdata-platform-domain-model` | L2 | 38 行 | 537 行 | 304 行 |
+
+**精简对比**：
+
+| skill | 精简前 | 精简后 | 缩减 |
+|-------|--------|--------|------|
+| code-spec | 88 行 | 33 行 | -62% |
+| data-boundary | 111 行 | 38 行 | -66% |
+| domain-model | 95 行 | 38 行 | -60% |
+
+**精简原则**：删除与 rules 重复的正文/适用范围/安全边界，只保留 frontmatter + 触发 + 不触发 + 前置约束（引用 rules 章节）+ 路由。
+
+### 变更
+
+- **新增**：`meritdata-platform-suite/` 整合包目录结构
+- **重构**：`rules/code-dev-rules.md` §八 增加 3 个方法论铁律（§8.1 data-boundary / §8.2 domain-model / §8.3 code-spec）
+- **抽取**：从三方源目录抽取 12 条铁律到 `rules/`，每条加源团队 banner
+- **新建**：3 个方法论 skill，每个含 SKILL.md（路由器）+ references/anti-patterns.md（反模式）+ references/validate-rules.md（CI 命令）
+
+### 架构决策
+
+1. **双轨制**（rules ↔ skill）
+   - rules：CLAUDE.md 自动注入，铁律摘要（一句话一段）
+   - skill：按需加载，纯路由器（15-40 行）+ 详细 references
+   - 任何铁律变更**先改 rules**，再同步 references
+
+2. **4 层架构**
+   - L0 治理（skill-authoring-workflow / skill-vetter / skill-stocktake）
+   - L1 入口（meritdata-platform-playbook，唯一对外入口）
+   - L2 领域（方法论 + 业务能力）
+   - L3 单点 API（缓存/Nacos/国密/字典/...）
+   - L4 工具（bootstrap/nacos-importer/check）
+
+3. **命名规范**
+   - L2 用稳定名词（code-spec / data-boundary / domain-model）
+   - L0/L4 用动词（bootstrap / import / check / vetter / stocktake）
+   - 前缀统一：`meritdata-platform-`（采用研发版前缀）
+
+4. **三方源处理**
+   - 当前：3 个方法论 skill 已抽取
+   - 阶段 2：剩余 28 个 skill 逐一合稿（P1-P4 排序）
+   - 归档：阶段 2 完成后，三方源加 `LEGACY.md` 标记只读
+
+### 来源标注
+
+每个 rules 文件首行标注 `<!-- Source: <team> -->`，标明来源团队：
+
+- `工业互联codex/`：前端编码、组件、Git、性能、安全、命名、编码细节
+- `石油skills/`：MeritData Cloud 业务平台规范（方法论源头）
+- `研发skills/`：API 设计、SQL 规范、平台语义
+
+---
+
+## 版本速查
+
+| 版本 | 日期 | 摘要 |
+|------|------|------|
+| v2.5.0 | 2026-09-08 | ✅ **v2.2.0 缺口处理 2/4**：masterdata-sync 合并入 data-access/inbound + 新建 meritdata-platform-file；35 skill / 2 剩余缺口（http-client / webapi）|
+| **v2.6.0** | **2026-09-08** | **🎯 **v2.2.0 缺口收尾 4/4**：http-client 合并入 frontend/references/http-client/（5 篇）+ webapi 合并入 data-access/references/outbound/webapi.md；35 skill / 0 真正缺失 / 0 剩余缺口 / 44 原始 skill 100% 已映射**** |
+| **v2.6.1** | **2026-09-08** | **🛠 **运维优化 / skill-vetter 增强**：4 项新校验（死链/敏感/TODO/重复 name）+ 2 类新输出（summary 表格/JSON 报告）+ 5 个 reference 补建；35 skill / 0 失败**** |
+| v2.3.1 | 2026-09-08 | 📑 **攻略索引补齐**：5 个 L3 skill 加 `*/references/*-攻略/INDEX.md`；攻略源仍归 dev-docs/ |
+| v2.3.0 | 2026-09-08 | 🎯 **dev-docs 兜底完工**：新增 `meritdata-dev-docs-file-finder` + 158 文件知识库；34 skill |
+| v2.2.0 | 2026-09-07 | 🎯 **执行入口补齐**：新增 `meritdata-platform-cloud-dev`（22 modules 路由）；33 skill |
+| v2.1.0 | 2026-09-07 | 🎯 **L4 + L0 完工**：3 个 L4 工具 + 3 个 tools/ 治理脚本 |
+| v2.0.0 | 2026-09-07 | 🎯 **完整 4 层架构落地**：19 个 L3 skill |
+| v1.3.0 | 2026-09-07 | ⚠️ Breaking：合并 entities+services+integration → data-access；L2 加 sub-layer + stack 标注 |
+| v1.2.0 | 2026-09-07 | 新增 8 个 L2 领域 skill（bpm/data-access/job/impexp/sso + frontend + 原 3 个数据访问 skill）|
+| v1.1.0 | 2026-09-07 | 新增 L1 入口 playbook |
+| v1.0.0 | 2026-09-07 | 初始版本：3 个方法论 skill + 12 条铁律 |
+
+---
+
+## 待发布
+
+### v2.2.0（计划）
+
+- 三方源归档（加 `LEGACY.md`）
+- skill-vetter 增加更多校验项（references 行数 / 路由条目 / 反模式标记）
+- skill-stocktake 增加 Markdown 报告 + 趋势对比
+- **新建 `docs/二开12阶段开发流程文档框架提取_20260907.md`**：从源参考文档（`development-workflow.md` + `phase-diagrams.md`）抽取 12 Phase 框架；识别缺失 skill（`meritdata-platform-cloud-dev` 等 9 个）+ 命名不一致（小写蛇形 vs 大写蛇形）
+- **新建 `docs/三方skill映射关系清单_20260907.md`**：建立 44 原始 skill（6+8+30）→ 32 当前 skill 完整映射；识别 4 个真正缺失 + 4 个疑似合并 + 4 个已拆分；输出 v2.2.0 P0/P1/P2 行动建议
+- 补齐 `meritdata-platform-cloud-dev` skill（合并 `bootstrap-2nd-dev` + `2nd-dev-check`，对应源文档 Phase 1/4/10）
+
+---
+
+## 变更规范
+
+- **版本号**：遵循 SemVer（主版本.次版本.修订号）
+- **Breaking Changes**：必须升级主版本，并在 `rules/` 与 `skills/` 显式标注
+- **修订**：bug 修复、文档调整、案例补充 → 修订号 +1
+- **新功能**：skill 新增、铁律扩展 → 次版本 +1
+- **不兼容变更**：rules 章节号变更、SKILL.md frontmatter 破坏性修改 → 主版本 +1
+
+---
+
+## v2.6.1 — 2026-09-08
+
+**P1 运维优化 / skill-vetter 增强**：4 项新校验 + 2 类新输出格式，提升 CI 校验完整性。35 skill / 0 失败 / 0 真正缺失。
+
+### P1-A：vetter 新增 4 项校验
+
+| 维度 | 校验内容 | 等级 | 说明 |
+|------|---------|------|------|
+| **死链扫描** | 扫描所有 SKILL.md / references 的 Markdown 链接，验证目标文件存在 | ERROR | v2.5.0/2.6.0 拆分时遗漏 5 个 reference 文件被检测出 |
+| **敏感信息扫描** | 扫 `password` / `appSecret` / `keytab` / `appToken` / `apiKey` / `accessToken` / `privateKey` 等 9 类关键字 | WARN | 教学文档命中关键字但不是真实凭据 → WARN（不阻断）|
+| **TODO/FIXME 残留** | 检测 `TODO:` / `FIXME:` 标注（行号 + 内容片段）| WARN | 排查技术债用，不阻断 |
+| **重复 name 检查** | 跨 skills 全量扫描 frontmatter `name` 字段冲突 | ERROR | CI 门禁必须 |
+
+### P1-B：vetter 新增 2 类输出格式
+
+| 格式 | 用途 | 触发 |
+|------|------|------|
+| **summary 表格** | SKILL.md 行数 TOP-10 + 统计汇总（总数 / 通过 / 失败 / 仅警告）| 默认输出 |
+| **JSON 报告** | `vetter-output.json`（机器可读，含每个 skill 的 errors/warnings 数组 + 字段信息）| `--json` flag / 未来 CI 集成 |
+
+### P1-C：5 个遗漏 reference 文件补建（vetter 死链扫描触发）
+
+vetter 跑通后发现 4 个 skill 存在 11 个真实死链 → 全部补齐：
+
+| skill | 新建 reference | 行数 | 覆盖内容 |
+|-------|---------------|-----:|---------|
+| `meritdata-platform-bpm` | `references/status-mapping.md` | 37 | 流程实例状态 ↔ 业务字段映射（4 状态）+ 节点 ↔ 审批人 + 平台字段命名约定 |
+| `meritdata-platform-data-boundary` | `references/same-jvm.md` | 53 | 同 JVM 判定方法 + 允许 vs 禁止行为对照 + 灰度场景 |
+| `meritdata-platform-data-boundary` | `references/cloud-tables.md` | 33 | PF_ 前缀平台表清单（9 类）+ 对应 Feign 映射 |
+| `meritdata-platform-domain-model` | `references/relationship-patterns.md` | 113 | 1:N / M:N / 树形 / 跨服务关联 4 模式 + 代码示例 |
+| `meritdata-platform-domain-model` | `references/review-checklist.md` | 40 | review 5 大 checklist（表命名 / 关联键 / 平台语义 / 软删除）|
+
+### 校验
+
+```bash
+$ bash tools/skill-vetter/run.sh
+========================================
+  skill-vetter v2.6.1: skill 合规校验
+========================================
+扫描目录: /e/wllmh/pfsuite/meritdata-platform-suite/skills
+
+OK [meritdata-bootstrap-2nd-dev]
+[... 34 skills ...]
+
+========================================
+  重复 skill name 检查
+========================================
+OK 0 个重复 name
+
+========================================
+  结果: 35 通过 / 0 失败 (总计 35)
+========================================
+
+skill 总数：   35
+通过：        35
+失败：        0
+仅警告：      21
+```
+
+**21 个 warning 分布**（均非阻断）：
+- 4 个 SKILL.md > 60 行（dev-docs-file-finder 215 / data-access 130 / file 99 / cloud-dev 80）— 与 v2.6.0 一致
+- 17 个 sensitive-keyword 命中（教学文档，建议人工 review）
+
+### 架构统计（不变）
+
+```
+v2.6.1 整合包：
+  rules：    12 条（不变）
+  skills：   35 个（不变；5 个 reference 子文档新增）
+  tools/：  3 个 L0 治理脚本（skill-vetter 增强）
+```
+
+## v2.6.2 — 2026-09-09
+
+**冗余清理 + 内容恢复**：skill / rules 重复审计后发现 3 类冗余 + 1 个内容丢失 bug，全部修复。
+
+### 修复 1：恢复 `rules/coding-standards-rules.md` 内容（关键 bug）
+
+| 项 | 详情 |
+|----|------|
+| **Bug** | 套件版 `coding-standards-rules.md` 仅 198 字节（TODO 占位 stub），丢失全局版 92 行完整内容（资源/集合/字符串/异常/并发/对象/日志 7 大块） |
+| **根因** | v2.6.x 抽取时只拷了源 banner，未拷正文；`rules/README.md` 第 23 行也已标注"占位 - 待补全" |
+| **修复** | 从全局 `~/.claude/rules/coding-standards-rules.md` 恢复 92 行真实内容 + 源 banner + 修复说明（2659 字节） |
+| **影响** | 此前若套件被复制到项目，编码细节铁律失效（只剩 §8 方法论铁律可用） |
+
+### 修复 2：删除项目根冗余 `skills/` 目录
+
+| 项 | 详情 |
+|----|------|
+| **问题** | `E:\wllmh\pfsuite\skills\` 含 3 个 skill（code-spec / data-boundary / domain-model），与 `meritdata-platform-suite/skills/` 中对应 skill **references 完全相同**，SKILL.md 仅缺 `sub-layer` / `stack` 2 个 metadata 字段 |
+| **决策** | 删除项目根 `skills/`，保留套件版本（套件版有完整 4 层架构 metadata） |
+| **影响** | 消除 ~150KB 磁盘占用 + 3 个 skill 的维护负担 |
+
+### 修复 3：删除项目根冗余 `rules/` 目录
+
+| 项 | 详情 |
+|----|------|
+| **问题** | `E:\wllmh\pfsuite\rules\` 14 个文件（含 README）与 `meritdata-platform-suite/rules/` **字节级完全相同** |
+| **决策** | 删除项目根 `rules/`，**唯一权威来源 = 套件 rules/** |
+| **影响** | 消除 ~37KB 磁盘占用 + 14 个文件的同步维护负担 |
+
+### 修复 4：同步更新 `rules/README.md`
+
+- 删除"占位 - 待补全"标注
+- 加"§八 方法论铁律 → 3 个 L2-M skill references 详细版"互引
+- 加"清理记录"小节
+
+---
+
+## v2.6.3 — 2026-09-09
+
+**套件自包含升级**：将 6 个全局独有 rules 下放到套件，使 `meritdata-platform-suite/` 成为**完整、自包含、复制即用**的平台知识库。**不再依赖全局 `~/.claude/rules/`**。
+
+### 下放清单（6 个）
+
+| 文件 | 行数 / 字节 | 范围 | 触发 |
+|------|------------|------|------|
+| `meritdata-platform-data-boundary.md` | 176 / 6287 | 数据边界 4 铁律完整版 | 数据访问代码 / PR / CI |
+| `meritdata-platform-domain-model-rules.md` | 241 / 9505 | 业务建模 5 硬规则完整版 | DB 表设计 / 实体类生成 |
+| `documentation-rules.md` | 96 / 2090 | 代码注释 / Javadoc / README / 接口文档 | 编写文档 |
+| `requirement-dev-rules.md` | 71 / 1625 | 需求分析 / 设计 / PRD | 需求开发 |
+| `system-test-rules.md` | 84 / 1793 | 系统测试 / 集成测试 / UAT | 系统测试设计 |
+| `test-case-dev-rules.md` | 90 / 1901 | 单元 / 集成 / 开发者测试 | 测试用例编写 |
+
+### 配套改动
+
+| 改动 | 文件 |
+|------|------|
+| 6 个新文件加源 banner（标记下放来源与日期） | 各 rule 顶部 |
+| `code-dev-rules.md §8.1` 引用路径从全局 `~/.claude/rules/...` 改为套件内 `./meritdata-platform-data-boundary.md` | `code-dev-rules.md` |
+| `code-dev-rules.md §8.2` 引用路径同上，改为 `./meritdata-platform-domain-model-rules.md` | `code-dev-rules.md` |
+| `rules/README.md` 拆分 18 个 rule 为 3 类（12 通用开发 + 2 平台硬规则 + 4 流程文档） | `rules/README.md` |
+| `rules/README.md` CLAUDE.md 集成示例扩展到 18 条 | `rules/README.md` |
+
+### 收益
+
+- **自包含**：复制 `meritdata-platform-suite/` 到任意项目根，**所有规则随套件走**，无需全局 `~/.claude/rules/` 兜底
+- **统一治理**：未来规则修订只需改套件内文件，全局版可保留作为"旧参考"或同步删除
+- **避免漂移**：原来 §8.1 摘要指向全局版，若全局版更新但套件未同步会出现引用漂移；现在闭环在套件内
+
+### 套件当前规模
+
+- **35 skill**（4 层架构完整）
+- **18 rule**（12 通用开发 + 2 平台硬规则 + 4 流程文档）
+- **3 tool**（L0 治理脚本）
+- **0 真正缺失 / 0 stub**
+
+---
+
+## v2.6.4 — 2026-09-09
+
+**清理根级 3 个空壳目录**：删除 `meritdata-platform-suite/` 根级的 3 个 L4 工具空壳。
+
+### 问题
+
+| 空壳目录 | 实际内容 | 权威版本位置 |
+|----------|---------|------------|
+| `meritdata-platform-suite/meritdata-bootstrap-2nd-dev/` | 仅 1 个空 `references/` 子目录 | `skills/meritdata-bootstrap-2nd-dev/SKILL.md`（37 行） |
+| `meritdata-platform-suite/meritdata-nacos-importer/` | 仅 1 个空 `references/` 子目录 | `skills/meritdata-nacos-importer/SKILL.md`（37 行） |
+| `meritdata-platform-suite/meritdata-platform-2nd-dev-check/` | 仅 1 个空 `references/` 子目录 | `skills/meritdata-platform-2nd-dev-check/SKILL.md`（38 行） |
+
+**根因**：v2.0 早期 L4 工具可能在 suite 根级，后迁移到 `skills/` 但根级空壳未清。
+
+### 改动
+
+- 删除 3 个空壳目录（含其下的空 `references/`）
+- 套件根级从 9 项 → **6 项**（CHANGELOG.md / README.md / docs/ / rules/ / skills/ / tools/）
+
+### 套件当前规模（最终）
+
+- **35 skill**（唯一权威位置：`skills/`，4 层架构完整）
+- **18 rule**（唯一权威位置：`rules/`，自包含）
+- **3 tool**（唯一权威位置：`tools/`，L0 治理）
+- **0 空目录 / 0 stub / 0 重复**
+
+---
+
+### 已知缺口（v2.7.0+ 处理）
+
+> 当前无真正缺失。下一阶段聚焦运维优化深化（vetter 增加 Markdown 报告 / 反模式自动检测 / CI 集成）。
+
+---
+
+**最后更新**：2026-09-09
+**当前版本**：v2.6.3（套件自包含：35 skill / 18 rule / 3 tool）
+**下次计划**：v2.7.0（运维优化深化 + CI 集成）