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

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

@@ -0,0 +1,40 @@
+---
+name: meritdata-platform-mod-http-client
+description: Meritdata Cloud Vue2 多服务 HTTP 客户端规范。生成或修复 service registry、gateway 路径、http-plugin、JSON/form/query/upload/download 请求、平台签名与会话 header 保留、响应解包、业务/传输错误和并发隔离时使用；人员字典流程附件组件命中后应自动触发本 Skill。
+---
+
+# Merit Cloud HTTP 客户端
+
+保证前端跨业务服务、system-manager 和 bpm-engine 的请求可路由、可诊断且不破坏平台安全拦截器。
+
+## 工作流
+
+1. 从需求与 UI 语义汇总 service requirements：业务 CRUD、人员/部门/角色/字典、BPM、附件、访问日志。
+2. 读取 contracts.md（参考：，待补充），按目标前端包核实 `cloud-module-base/packages/httpConfig/http-plugin` 的真实行为。
+3. 建立 service registry 和 endpoint schema；每个 endpoint 声明 service、method、contentType、responseShape、return 和错误策略。
+4. 按 client-implementation.md（参考：，待补充） 生成包装器，并用 anti-patterns.md（参考：，待补充） 排除共享 defaults、二次解包、未注册 alias、自行签名和 URL 双斜杠；所有请求通过平台 plugin，header 只写当次 config，禁止重写 Cloud-Sign。
+5. 运行 `node scripts/validate-client.mjs --project <front-end> --registry <registry.json>`，未注册 alias、全局 defaults 污染或不明确 responseShape 均阻断。
+6. 执行 acceptance.md（参考：，待补充） 的 HC-01 至 HC-08；真实平台 E2E 未运行时明确标为待集成验证。
+
+## 自动联动
+
+- 人员/部门/角色/字典/资源权限/访问日志：必须注册 `system-manager`。
+- BPM 表单、待办、追踪：必须注册 `bpm-engine`，按页面需要补 `system-manager`。
+- 附件/富文本：优先使用组件已验证 provider，不擅自改写上传协议。
+- 普通业务 CRUD：注册业务 service，禁止把所有请求错误地指向 system-manager。
+
+## 网关路径前检
+
+请求地址按五段核对：`gatewayOrigin`、`gatewayPrefix`、`serviceName`、`contextPath`、`controllerPath`。完整路径为前五段按目标项目既有拼接规则组成的地址，其中 `gatewayPrefix` 只能出现一次。
+
+1. `serviceName` 取目标服务 `spring.application.name` 或网关路由；`contextPath` 取服务配置，未配置时为空。
+2. 先检查平台 HTTP plugin/BaseApi 是否已拼接 gatewayPrefix。已拼接时调用方不得再次添加。
+3. 开发代理的 target 只指向 gatewayOrigin，请求保留 gatewayPrefix；直连服务端口仅限用户明确要求的本地调试。
+4. 生成 endpoint schema 时记录五段来源、认证上下文和 responseShape，缺任一证据则输出 GAP。
+
+## 边界
+
+- UI Skill 负责组件 props/events；本 Skill 只实现 transport 和 service dependency。
+- feign-api 负责后端内部服务契约；WebApi 负责外部系统认证发布。
+- 不复制签名算法、Secret 或 token；平台 plugin 拥有签名、CSRF 和会话跳转。
+- 旧包响应契约不明时先运行 contract probe，不使用 `res.data || res` 猜测式兼容。

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

@@ -0,0 +1,26 @@
+---
+name: meritdata-platform-mod-impexp
+description: meritdata cloud 导入导出框架：导出用 ExportUtil(POI HSSF)、导入用 ImportHandler+Checker(校验器)+Converter(转换器)。生成模块时需要 Excel 导入导出功能时用。
+---
+
+# Merit Cloud 导入导出
+
+## 路由
+
+- Excel/CSV 导入、模板校验、字典/人员转换与批量落库：读取 references/import-workflow.md（参考：，待补充）。
+- 查询导出、响应头、大数据量、权限与脱敏：读取 references/export-workflow.md（参考：，待补充）。
+- 普通附件生命周期转 `meritdata-platform-mod-file`；填报报表 `ITReportService` 不等于通用导入导出。
+
+## 执行流程
+
+1. 从当前项目依赖、官方契约或已核验签名索引确认 `ImportHandler/Checker/Converter/ExportUtil` 的真实类名、包名和签名；历史模板只能作为候选证据。
+2. 明确文件格式、模板版本、字段映射、错误返回方式、数据量、事务/幂等和权限密级。
+3. 平台人员/组织/字典只通过已核验 Feign/API 批量校验或装配，不查询 Cloud 表。
+4. 验证空文件、错表头、类型错误、重复数据、部分失败、恶意公式/压缩包、大数据量和越权导出。
+
+## 强制边界
+
+- 上传文件校验扩展名、MIME、魔数、大小和解析资源上限；文件名不得决定服务器路径。
+- 导入先校验后落库，明确全有或全无/分批提交语义；重试不得重复写入。
+- 导出服务端重新执行数据权限、密级和脱敏，不能只依赖前端禁用按钮。
+- 大数据量禁止一次性装入内存；HSSFWorkbook 受 `.xls` 行数限制，按目标格式选择流式方案。

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

@@ -0,0 +1,29 @@
+---
+name: meritdata-platform-mod-logging
+description: meritdata cloud 业务运行操作/访问日志（谁在什么时间修改了什么业务数据、审计追溯用）：后端操作日志(ILogPostService+Message+LogPattenUtils)、访问日志(save-access-log)、错误日志、日志查询和导出。用于业务审计、合规追踪和生产排障，不记录 AI 开发过程。
+---
+
+# Merit Cloud 业务审计日志
+
+把业务运行日志接入平台日志体系；不要生成 AI 开发过程日志或 Gateway 会话日志。
+
+## 路由
+
+- 新增、修改、删除及新旧值差异审计：读取 references/operation-logging.md（参考：，待补充）。
+- 页面访问、日志查询、趋势、历史和导出：读取 references/access-and-query.md（参考：，待补充）。
+- 普通技术诊断日志：遵循 `merit-code-spec` 的 SLF4J 规范，不投递为业务操作日志。
+
+## 强制边界
+
+1. 增删改使用 `Message.TYPE_OPT`；页面访问使用 `TYPE_VISIT`；业务错误使用 `TYPE_ERROR`。
+2. 业务日志文案放在 `src/main/resources/logs/*.logs.properties`，用 `LogPattenUtils` 读取，不在 Java 中硬编码。
+3. 后端统一通过 `ILogPostService` 或平台审计服务投递，不自行写平台日志表。
+4. 日志不得包含 token、密码、密钥、完整身份证号等敏感数据；动态文本先防日志注入。
+5. 日志失败策略必须按业务要求确定；不得让非关键审计投递无意间破坏主事务，也不得静默丢失法规要求的审计记录。
+
+## 完成检查
+
+- 日志类型、模块、操作、状态和详情字段语义正确。
+- properties key 与调用完全一致，占位符数量匹配。
+- 成功与失败路径均符合审计要求，异常堆栈使用技术日志单独记录。
+- 未跨库访问平台日志表，未泄露敏感数据。

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

@@ -0,0 +1,36 @@
+---
+name: meritdata-platform-mod-masterdata-sync
+description: Meritdata Cloud 外部主数据同步规范。通过 REST/WebService 接入组织、人员、角色、职务、资源和授权数据，设计同步顺序、业务键幂等、批次对账、部分成功重放、XML 安全与审计时使用；独立二开服务在线查询平台人员组织应使用 meritdata-platform-mod-feign-api，不得直连 cloud 平台表。
+---
+
+# Merit Cloud 主数据同步
+
+将一次“接口调用”设计成可重放、可对账、可审计的企业同步链路。
+
+## 工作流
+
+1. 判断场景：外部系统通过已开放契约批量/增量写入平台主数据才使用本 Skill；独立二开服务在线查询转 `$meritdata-platform-mod-feign-api`，只有明确同 JVM 的平台模块扩展才转 `$meritdata-platform-mod-services`。
+2. 读取 sync-contracts.md（参考：，待补充），选择目标版本已核实的 REST 或 WebService 通道。认证编目组合 `$meritdata-platform-mod-webapi`。
+3. 按 canonical-payload.md（参考：，待补充） 定义来源系统、批次号、业务键、父子依赖、删除语义、水位和对账口径。默认顺序：组织 → 角色/职务 → 人员 → 资源 → 授权。
+4. 生成适配层：来源 DTO → canonical DTO → 平台 payload。XML 使用安全序列化器，禁止字符串拼接；关闭外部实体和 DTD。
+5. 单项记录失败不得假定全批回滚。保存阶段状态、失败明细和可重放 payload 摘要，Secret 与敏感原文不落日志。
+6. 同步后按数量、业务键、父子关系和授权集合对账，超阈值删除或全量覆盖必须人工审批。
+
+## 实现约束
+
+- 组织编码、人员编码等稳定业务键用于 upsert；禁止把数据库主键当跨系统契约。
+- 父组织先于子组织；人员依赖的组织/职务不存在时进入可重试失败，不创建无归属脏数据。
+- REST 与 WS 共享同一批次/幂等/错误模型，不能形成两套真源。
+- 重试只处理失败项或安全幂等项，指数退避并限制次数；永久错误进入人工处置队列。
+- `POST /api/cloud-data-sync/start-sync` 是平台内部权限消息重放，不是通用主数据同步接口，禁止自动调用。
+- 本 Skill 是服务契约集成，不授权二开项目直接写 cloud 数据库、复制平台表或建立跨库事务。
+
+## 验收
+
+执行 acceptance.md（参考：，待补充） 的 MS-01 至 MS-08。仅“HTTP 200”不算成功，必须通过批次结果和对账。
+
+## 不适用
+
+- 独立二开服务查询平台人员/组织/角色：feign-api；同 JVM 平台模块扩展才用 services。
+- 内部微服务 RPC：feign-api。
+- 任意业务表 ETL、CDC 或数据库复制：平台资料未证明这些能力，需另行集成。

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

@@ -0,0 +1,27 @@
+---
+name: meritdata-platform-mod-msg-job
+description: meritdata cloud 消息与调度：①消息中心——发站内信/通知/消息推送/未读数/附件上传下载/定时消息；②定时调度——创建定时任务/Job/cron(@JobHandler/IJobApi)、启停/手动触发、调度日志；③调度编排二开(ICloudClient)
+---
+
+# Merit Cloud 消息与调度
+
+## 路由
+
+- 站内信、公告、未读数、定时消息和消息附件：读取 references/message-center.md（参考：，待补充） 与 references/additional-channels.md（参考：，待补充）。
+- `@JobHandler`、`IJobApi`、cron、启停和手动触发：读取 references/scheduled-jobs.md（参考：，待补充）。
+- 调度编排平台回调 `ICloudClient`：读取 references/schedule-orchestration.md（参考：，待补充）。
+- 附件生命周期与安全转 `meritdata-platform-mod-file`；Redis pub/sub 转 `meritdata-platform-mod-cache`；流程待办转 `meritdata-platform-mod-bpm`。
+
+## 通用流程
+
+1. 先区分业务消息、定时 Job、调度编排回调，选择唯一主路径。
+2. 从目标版本依赖和源码确认 API、DTO、枚举、服务名及网关路径。
+3. 设计接收人、去重/幂等、重试、失败审计、权限和敏感数据边界。
+4. 验证重复投递、超时、部分失败、任务重入、取消竞态和日志脱敏。
+
+## 强制边界
+
+- 不直连平台消息或调度数据库表。
+- 消息、短信、邮件中不得泄露 token、验证码或超出业务所需的个人信息。
+- 定时任务必须可重入或有互斥策略，并使用平台调度日志；禁 `System.out`。
+- 编排回调状态与取消操作必须幂等，不能用本地事务假装覆盖远程执行。

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

@@ -0,0 +1,40 @@
+---
+name: meritdata-platform-mod-meritdata-platform-entities
+description: Meritdata Cloud 平台内置实体与 QueryDSL Q 类的只读索引和使用边界。仅在同 JVM 且目标项目已显式依赖平台模块时，用于核对人员、用户、组织、角色、字典、资源、租户、密级等平台实体的字段、关联和 Q 类；独立二开微服务不得借此直连 cloud 平台表。
+---
+
+# Merit Cloud 平台实体与 QueryDSL Q 类
+
+## 使用前提
+
+1. 先确认调用方与平台模块在同一 JVM，并从目标项目 POM、import 和已生成 Q 类确认依赖与版本。
+2. 本 Skill 是字段和关联的只读定位入口，不保证历史实体、表名、Filter 或 Q 类在当前版本仍存在。
+3. 独立部署的二开服务只保存平台稳定 ID/code，通过 `meritdata-platform-mod-feign-api` 批量装配；不得映射或 JOIN cloud 平台表。
+4. 涉及账号、密码、私钥、数据源、个人信息、租户或密级时，只读取完成任务所需字段，并遵守项目的脱敏、授权和审计规则。
+
+## 按意图路由
+
+| 需求 | 核对对象 | 联动模块 |
+|---|---|---|
+| 当前登录人、人员、用户、用户人员关系 | Emp / User 及目标项目 Q 类 | `meritdata-platform-mod-utils`、`meritdata-platform-mod-services` |
+| 组织、部门、角色、工作组、授权关系 | Organization / Role / Resource 及关系实体 | `meritdata-platform-mod-services` |
+| 字典、分类和基础枚举 | Lookup / Category 及对应 Q 类 | `meritdata-platform-mod-services` |
+| 租户、密级、审计与 Hibernate Filter | BaseEntity / CloudBaseEntity / 目标 Filter | `meritdata-platform-mod-config`、`meritdata-platform-mod-logging` |
+| 在同 JVM 动态查询平台实体 | 已生成的 Q<Entity>、Repository 与现有查询样例 | `meritdata-platform-mod-services` |
+| 工作流主表、待办、流程实体 | BPM DTO/API，不直接查流程表 | `meritdata-platform-mod-bpm` |
+
+## 实施规则
+
+1. 先定位目标项目已有实体、Repository 和 Q 类，再决定字段、关联方向和过滤条件；没有版本证据时输出 GAP。
+2. 不把 `User`、`Emp`、组织、部门、岗位、角色或工作组混为同一概念；显示名装配优先走已有批量服务。
+3. 不假定 Hibernate 的租户或密级 Filter 自动生效。必须验证实体注解、拦截器、会话上下文和正反授权用例。
+4. QueryDSL 查询只引用目标构建已生成的 Q 类；Q 类缺失时修复构建生成链路，不手写伪 Q 类。
+5. 输出中记录实体/字段/Q 类来源、版本、访问边界和最小验证场景。
+
+完整证据项见 entity-qclass-verification.md（参考：，待补充）。
+
+## 边界
+
+- 新业务实体设计、迁移、Repository 与分页生成转 `meritdata-platform-mod-gen` 和 `meritdata-platform-mod-domain-model`。
+- 跨进程或独立业务库读取平台数据转 `.claude/rules/data-boundary-rules.md` 与 `meritdata-platform-mod-feign-api`。
+- 不复制平台 Entity/Repository 到二开工程，不根据历史资料臆造字段、表名或关联。

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

@@ -0,0 +1,62 @@
+---
+name: meritdata-platform-mod-platform
+description: 公司 meritdata cloud 微服务平台能力总入口、知识图谱与实施路由。用于从角色、业务场景、平台版本和调用边界识别最小 Skill 组合；查询场景、实体、服务、API、依赖、版本及证据关系；回答“平台有什么能力/应该用哪个服务或接口/本地 Bean 还是 Feign/升级影响是什么/如何组合认证、流程、消息、调度、日志、导入导出、前端组件、代码生成和质量治理”等跨域问题。
+---
+
+# 公司微服务平台能力导航
+
+先识别上下文，再加载专项 Skill。不要凭记忆发明接口。
+
+## 路由流程
+
+1. 识别角色：业务分析、新人开发、资深开发、架构师、测试、运维、安全或交付。
+2. 识别任务：查能力、做方案、新建工程、现有项目新增模块/字段/接口/页面/流程/集成、排错、测试、部署或治理。
+3. 识别版本：优先读取项目 POM/运行环境；无法确定时声明默认 `6.13.2`。
+4. 识别边界：二开业务库不得直连 cloud 平台表；平台数据优先已核验 Feign/API。只有同一平台服务进程且明确依赖模块时才使用本地 Bean；浏览器使用网关 HTTP。
+5. 查询 capability-graph.json（参考：，待补充），选择最小 Skill 集；需要关系下钻时按 graph-model.md（参考：，待补充） 查询 meritdata-platform-knowledge.json（参考：，待补充）。
+6. 涉及远程调用时先读取 interface-knowledge-base.md（参考：，待补充） 与 api-service-catalog.md（参考：，待补充），区分本地 Bean、Feign 和网关 REST，再交给 `meritdata-platform-mod-feign-api` 使用已登记契约生成调用封装。运行时不得要求用户提供平台源码、源码 Jar、反编译结果或维护人员本机目录。
+7. 涉及升级或依赖冲突时读取 version-dependency-matrix.md（参考：，待补充）；涉及端到端实施时读取 scenario-paths.md（参考：，待补充）。
+8. 读取所选内部能力的 `module.md`，输出“场景路径—能力选择—调用边界—版本证据—风险—验证”，不只输出代码。
+
+可用脚本：
+
+```powershell
+python scripts/query_graph.py --role developer --keyword workflow --version 6.13.2
+python scripts/query_graph.py --skill meritdata-platform-mod-services
+python scripts/query_knowledge.py 人员 --version 6.13.2 --access-mode FEIGN
+```
+
+脚本只提供可选的确定性检索；Skill 消费不依赖 Python，可直接读取上述 Markdown/JSON。
+
+## 核心路由
+
+| 意图 | 主要 Skill | 常见联动 |
+|---|---|---|
+| 新工程、存量项目新增/改造模块与集成 | `meritdata-platform-mod-gen` | spec、domain-model、UI、logging |
+| 多表关系/聚合/复杂查询设计 | `meritdata-platform-mod-domain-model` | gen、services、feign-api |
+| cloud平台库与二开业务库隔离 | `.claude/rules/data-boundary-rules.md` | domain-model、feign-api、gen |
+| 平台能力、知识图谱与依赖影响 | 本 Skill | feign-api、governance |
+| 跨服务 Feign/网关 API | `meritdata-platform-mod-feign-api` | services、config、logging |
+| 同进程人员/组织/角色/字典/资源/授权 | `meritdata-platform-mod-services` | utils、UI |
+| 同 JVM 核对平台实体字段、关联或 QueryDSL Q 类 | `meritdata-platform-mod-meritdata-platform-entities` | services、config、logging |
+| 流程审批 | `meritdata-platform-mod-bpm` | UI、msg-job、logging |
+| 消息、定时任务、调度编排 | `meritdata-platform-mod-msg-job` | config、logging |
+| 认证、Nacos、国际化、密级 | `meritdata-platform-mod-config` | utils、UI |
+| 导入导出 | `meritdata-platform-mod-impexp` | services、logging |
+| Vue 公共组件和权限 | `meritdata-platform-mod-ui` | services、bpm |
+| 会话、日期、ID、加解密 | `meritdata-platform-mod-utils` | config |
+| 操作/访问审计 | `meritdata-platform-mod-logging` | config、spec |
+| 代码规范与质量检查 | `merit-code-spec` | gen |
+| Skill 版本、证据、兼容和发布治理（仅维护人员） | `merit-skill-governance` | platform、spec |
+
+## 决策约束
+
+- 不把本地 Bean 接口误称为 Feign；跨进程调用必须确认是否存在公开 REST/Feign 契约。
+- 平台 Entity 与 Q 类只在同 JVM 且已验证依赖时使用；独立二开服务必须转 Feign/API，不能借实体索引绕过数据边界。
+- 不把“文档出现的方法”直接视为当前版本真实签名；优先使用目标项目源码/官方契约/随 Skill 发布的已核验签名摘要和契约测试。平台取证材料只在 Skill 维护阶段更新，不在员工生成代码时重新提取。
+- 将需求拆成“场景 → 能力 → 实体 → 服务/API → 依赖/版本 → 实施 Skill”；只有路径而无签名时标记 `documented`，推断标记 `[INFERRED]`。
+- 不生成 Gateway 会话日志或 AI 开发 Journal；`meritdata-platform-mod-logging` 只处理生成后业务系统的运行审计。
+- 不把 `test-compile` 描述成集成测试通过；数据库、Nacos、网关、流程环境需要独立验证。
+- 对修改账号、授权、密码、流程状态等操作说明权限、审计和幂等风险。
+
+角色工作台见 roles.md（参考：，待补充），组合场景见 scenarios.md（参考：，待补充），版本策略见 versions.md（参考：，待补充）。

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

@@ -0,0 +1,37 @@
+---
+name: meritdata-platform-mod-services
+description: meritdata cloud 平台同进程模块的公共服务本地 Bean 查询/调用：人员组织角色、用户、字典、资源与授权。仅用于明确引入 cloud-system-manage-module 且与平台服务同进程的扩展；独立二开微服务或独立业务库访问平台数据时改用 meritdata-platform-mod-feign-api，禁止直连 cloud 平台表。
+---
+
+# 平台同进程公共服务
+
+## 先判定部署边界
+
+1. 只有调用方与平台管理模块同 JVM，且目标项目明确引入对应 module 时，才注入本 Skill 的本地 Bean。
+2. 独立部署的二开微服务必须改用 `.claude/rules/data-boundary-rules.md` + `meritdata-platform-mod-feign-api`；不得为了注入 Bean 而连接 cloud 库或依赖平台持久化模块。
+3. 业务库只保存平台稳定 ID/code。列表先分页业务数据，再按能力域去重 ID 并批量装配；禁止循环调用和跨库 JOIN。
+4. 方法签名、Map key 或返回 VO 缺少目标版本证据时输出 GAP，不凭名称补全。
+
+## 按任务加载参考
+
+- 人员、组织、用户、角色、字典查询：读取 core-directory-services.md（参考：，待补充）。优先考虑 `IDamService` 的批量能力；选人页面回填优先使用已核验的 `IUserSelectService`。
+- 菜单资源、组件权限和授权分配：读取 resource-authorization.md（参考：，待补充）。
+- 岗位、职务、工作组、工作台、资源组、外部资源和自定义字段：读取 extended-services.md（参考：，待补充）。
+
+## 能力选择
+
+| 任务          | 首选服务                                 | 强制注意                |
+| ----------- | ------------------------------------ | ------------------- |
+| 批量按用户查人员/部门 | `IDamService` / `IUserSelectService` | 一页每个能力域最多一次批量查询     |
+| 组织树与组织详情    | `IDamService` / `IOrgService`        | 不把组织、部门、岗位混为一类      |
+| 用户账号与密码     | `IUserService`                       | 不把 User 与 Emp 当同一实体 |
+| 字典树与字典项     | `ILookupService`                     | 业务保存稳定 code，缓存需失效策略 |
+| 角色          | `RoleService`                        | 职务/岗位/工作组不等于角色      |
+| 菜单与资源       | `IResourceService`                   | 前端可见性不等于数据权限        |
+| 给角色/机构/用户授权 | `IAssignService`                     | 写操作需权限、幂等和审计        |
+
+## 输出要求
+
+- 写明本地 Bean 适用的 JVM/module 前提及证据版本。
+- 给出批量调用位置、失败/降级行为和 ID→显示名装配策略。
+- 若调用方是独立服务，停止生成本地 Bean 注入代码并转 Feign/API 路径。

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

@@ -0,0 +1,47 @@
+---
+name: merit-code-spec
+description: merit 公司 Java 代码规范自查/检查（命名/OOP/集合/并发/异常/注释/SQL/日志/Swagger + ResultBody/GridView + 表名大写下划线+业务前缀 T_xxx 等平台规范，详见 .claude/rules/sql-naming-rules.md）
+---
+
+# Merit 公司代码规范检查
+
+对生成或修改的 Java、SQL 和接口代码执行强制规范门禁。项目专属规范优先；不冲突的通用规则同时生效。
+
+## 路由
+
+| 维度 | 权威规则文件 |
+|------|------------|
+| Java 命名、OOP、集合、并发、异常、注释、SQL 与技术日志 | [.claude/rules/coding-standards-rules.md](../../../rules/coding-standards-rules.md) |
+| 安全、注入、认证、敏感信息 | [.claude/rules/security-rules.md](../../../rules/security-rules.md) |
+| 性能、数据库、缓存、并发 | [.claude/rules/performance-rules.md](../../../rules/performance-rules.md) |
+| SQL 命名（表/字段/索引/约束）| [.claude/rules/sql-naming-rules.md](../../../rules/sql-naming-rules.md) |
+| SQL 脚本规范 | [.claude/rules/sql-script-rules.md](../../../rules/sql-script-rules.md) |
+| 命名约定（类/方法/常量/包）| [.claude/rules/naming-conventions-rules.md](../../../rules/naming-conventions-rules.md) |
+| REST API 规范 | [.claude/rules/api-design-rules.md](../../../rules/api-design-rules.md) |
+| 代码开发指南（流程/异常/资源）| [.claude/rules/code-dev-rules.md](../../../rules/code-dev-rules.md) |
+| 平台二开数据边界铁律 | [.claude/rules/data-boundary-rules.md](../../../rules/data-boundary-rules.md) |
+| Nacos 配置规范 | [.claude/rules/nacos-rules.md](../../../rules/nacos-rules.md) |
+| Git 工作流 | [.claude/rules/git-workflow-rules.md](../../../rules/git-workflow-rules.md) |
+| 文档规范 | `~/.claude/rules/documentation-rules.md`（**用户级**）|
+
+> **不再单独维护** `java-core-rules.md` / `meritdata-platform-rules.md` / `checklist.md` / `spec_scan.py`，全部规则已统一收纳到项目级 rules 目录。
+>
+> 门禁加载：触发 `meritdata-platform-2nd-dev-check` 做 7 类 60+ 项体检，生成链路同时加载 `.claude/rules/data-boundary-rules.md` 的 4 条铁律；任一失败即阻断。
+
+## 检查流程
+
+1. 识别项目平台版本、Java/Spring 版本、数据库和项目已有约定。
+2. 只检查与本次改动相关的维度，但覆盖所有受影响文件。
+3. 报告精确到文件和行，给出规则、风险和最小修复。
+4. 修复强制项后重新扫描、编译和测试；不能确认的依赖/API 标记 GAP。
+
+## 输出
+
+```text
+Merit 代码规范自查报告
+  ❌ [强制] <文件>:<行> <问题>（修复建议）
+  ⚠️ [建议] <文件>:<行> <问题>
+强制违反 N 项，建议 N 项
+```
+
+只有强制违反为 0、规范扫描与数据边界扫描均通过，才可声明规范门禁通过。

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

@@ -0,0 +1,51 @@
+---
+name: meritdata-platform-mod-ui
+description: Meritdata Cloud Vue2 + ElementUI 企业级前端能力路由；在生成或改造表单、列表、详情、流程页时，根据字段语义自动选择人员/部门/角色弹框、字典、附件、富文本、日期、流程和权限等平台组件，并生成 ID+名称回填、只读展示、校验及验收用例。
+---
+
+# meritdata-platform-mod-ui
+
+将前端生成从“按 Java 类型画控件”升级为“按业务语义复用平台能力”。适用 Vue 2 + Element UI + `cloud-module-base`/`cloud-module-bpm` 6.13.2。
+
+基础 CRUD 页面必须按 `ResultBody` 显式处理成功、业务失败和网络异常：列表读取 `data.rows/data.total`，保存/删除失败显示 `message` 或 `stackmessage`，并在 `finally` 关闭 loading。不得把其他项目的 axios 实例、上传 URL、Store 或页面目录直接复制到目标工程。
+
+## 必须执行的生成流程
+
+1. 读取需求、实体字段、DTO 注释、字典编码、流程与权限元数据；不得只看字段类型。
+2. 依 references/semantic-component-rules.md（参考：，待补充） 识别语义，输出“字段-语义-组件-存储-展示-证据”决策表。
+3. 命中平台组件时必须自动生成组件引用、弹框状态、已选回显、保存回调、ID+名称回填、只读模式及表单校验。
+4. 完成 references/generation-contract.md（参考：，待补充） 的跨层契约检查；前端组件、API DTO、后端字段必须闭环。
+5. 在交付生成项目前执行 `node scripts/preflight.mjs --project <front-end>`。有 `GAP` 时停止交付；只有已找到项目级真实组件时才可使用 `--adapt`生成薄适配器。
+6. 执行 references/acceptance-scenarios.md（参考：，待补充） 中适用场景，附上验证记录；未实际运行不得写 PASS。
+
+## 自动完善规则
+
+- 出现“负责人/经办人/申请人/审批人”：生成人员选择弹框，同时保存 `xxxId` 和 `xxxName`；不允许自由文本录入人名。
+- 出现“参与人/知会人/协作人”：默认多选，前端使用数组，后端必须明确是关联表还是 JSON；不得默认逗号字符串。
+- 出现“归属部门/承办部门/组织”：使用部门选择器并回填 ID+名称。“组织”含义不清时先根据字段注释/业务用例判断，不盲选部门组件。
+- 出现“类型/等级/状态”且给出字典编码：自动查字典并生成列表/详情名称映射；流程状态不得当作普通字典。
+- 出现“附件/证明/材料/照片”：自动生成上传组件、大小/数量/扩展名限制、回显与只读下载。
+- 出现“详细说明/公告正文/处理意见”且需要图文：使用 `MlEditor`；普通备注仍用 `el-input type="textarea"`。
+- 业务启用工作流：列表和表单同时接入 BPM 组件，并以流程态+任务权限切换编辑/只读，不只生成“提交”按钮。
+- 出现“新增/编辑/删除/导出/审批”操作：自动包裹资源权限；三员功能使用三员标签，不在页面手写角色判断。
+
+## 证据与保守策略
+
+- 已核验：平台 6.13.2 开发攻略中的 `user-select`、`user-select-multi`、`role-select`、`dept-select`、`resource-code-auth`、`three-member-auth`。
+- 项目级可用：`upLoadFile.vue`、`MlEditor.vue`、`dateUtils`、`queryDicData`；生成前必须检查目标工程路径/依赖是否存在。
+- 不确定选择组件返回对象字段时，保留 `raw`并在实际工程运行一次记录，不猜测 `id/name/code`。
+- 组件依赖缺失时不生成假组件或空壳，不保留无法解析的 import；必须输出 references/dependency-preflight.md（参考：，待补充） 定义的 gap。
+
+## 实现引用
+
+- 准确的 props/事件、字典、附件、富文本和日期用法：references/component-contracts.md（参考：，待补充）
+- 存量 Vue2 工程的 `CloudDialog`、表头筛选、二次密码等组件兼容信息：references/legacy-component-compatibility.md（参考：，待补充）。仅在预检确认目标项目实际安装时使用。
+- 存量 Vue2 工程的 `CloudDialog`、表头筛选、二次密码等组件兼容信息：references/legacy-component-compatibility.md（参考：，待补充）。仅在预检确认目标项目实际安装时使用。
+- 完整中型系统验证样例：参考 `references/project-portfolio-ui-spec.md`（待补充，目前参见各 references/ 子文档）
+- 无 Python 策略：本 Skill 以 Markdown/YAML 声明式规则为主，生成时由模型直接执行；详见 references/no-python-assessment.md（参考：，待补充）。
+- 生成器依赖预检契约：references/dependency-preflight.md（参考：，待补充）。
+- 企业表格筛选、列显隐和按钮能力：references/grid-and-service-requirements.md（参考：，待补充）。
+
+## 服务依赖闭环
+
+命中人员、部门、角色、字典、权限、BPM、附件组件时，除了组件 import，还必须输出 service requirements。目标工程未注册 `system-manager`/`bpm-engine` 等实际 alias 时预检失败；不得生成“组件可见但弹框请求 undefined”的页面。HTTP transport 由专门的 http-client 或生成器适配，UI 不修改共享 Axios defaults。

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

@@ -0,0 +1,31 @@
+---
+name: meritdata-platform-mod-utils
+description: "meritdata cloud 后端工具类：获取当前登录用户信息(SessionUtils: userId/部门/人员)、日期格式化计算(DateUtils)、UUID 生成(IDGenerator)、AES/DES/RSA/SM2/SM4 加解密、JWT token、Base64/XSS/压缩。注：查任意人员组织用 meritdata-platform-mod-services"
+---
+
+# Merit Cloud 后端工具类
+
+优先复用平台已核验工具，不重复引入同类库；先按场景读取对应参考。
+
+本 Skill 中“加解密”仅指业务代码可调用的 AES/DES/RSA/SM2/SM4 安全工具类，与平台 Jar 的研究取证无关；不得用本 Skill 处理、修改或还原平台制品。
+
+## 路由
+
+- 当前登录人、部门、组织、日期和标识：读取 references/session-date-id.md（参考：，待补充）。
+- 加密、JWT、Base64、压缩、XSS、网络、多数据源和脚本：读取 references/security-and-infrastructure.md（参考：，待补充）。
+- 查询任意人员/组织/角色：使用 `meritdata-platform-mod-services`，不要把 `SessionUtils` 当目录服务。
+- 认证协议、SSO/CAS/token 集成：使用 `meritdata-platform-mod-gen`；本 Skill 只说明底层工具边界。
+
+## 使用流程
+
+1. 从项目依赖、官方契约和已核验签名索引确认当前版本确实存在目标类、包名和方法签名。
+2. 选择最小能力，复用项目既有注入与异常处理风格。
+3. 对密钥、路径、外部输入、脚本和数据源切换执行安全检查。
+4. 编译并覆盖成功、空值、非法输入和异常路径；无法确认的签名标记 GAP，不臆造。
+
+## 强制边界
+
+- 密钥和 token 不硬编码、不写日志、不作为普通配置回显。
+- 工具类不改变 Cloud 库隔离原则；业务数据仍只落二开业务库。
+- 文件路径必须规范化并验证仍位于允许根目录。
+- 用户输入不得直接成为 Groovy/表达式脚本。

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

@@ -0,0 +1,35 @@
+---
+name: meritdata-platform-mod-webapi
+description: Meritdata Cloud 对外 WebApi 发布与授权规范。新增或审查 /webapi/** 接口、App-Key/App-Token、应用与接口编目、IP 黑白名单、接口授权、重放防护和调用审计时使用；公司内部服务调用应改用 meritdata-platform-mod-feign-api。
+---
+
+# Merit Cloud 对外 WebApi
+
+把平台能力安全地发布给外部系统，不复制平台拦截器内部算法或密钥。
+
+## 工作流
+
+1. 确认调用方向。公司内部微服务调用转 `$meritdata-platform-mod-feign-api`；只有外部系统访问公司能力才继续。
+2. 读取 public-contracts.md（参考：，待补充），按目标平台版本核实 App、Category、Info、Auth 四类服务和 `/webapi/**` 拦截规则。
+3. 建立接口编目：稳定 URL、方法、请求/响应 schema、责任人、密级、幂等键、超时和版本；禁止把 Controller 路径当成未经登记的 WebApi。
+4. 建立调用方应用，分配最小 API 集并配置 IP 规则。Secret/App-Token 不进入源码、日志、示例、异常或留痕。
+5. 客户端按平台文档生成短时 App-Token；处理时钟偏差、重放、431–437 类认证错误和业务 `ResultBody` 错误。
+6. 按 replay-and-e2e.md（参考：，待补充） 加入业务幂等、重放检测、审计、限流、撤权和密钥轮换演练，再做契约与安全验收。
+
+## 生成规则
+
+- 服务端路径必须位于 `/webapi/**`，并先完成 WebApiInfo 登记和 AppAuth 授权。
+- 请求体使用 DTO + Jakarta Validation；响应遵循平台统一响应，不暴露堆栈或内部实体。
+- 写接口必须声明幂等键、重复请求结果和部分成功语义；高风险操作增加业务授权，不能只依赖 App-Token。
+- 不自行实现或覆盖 `WebApiInterceptor`，不把平台内部或未公开常量写进业务代码。
+- 外部组织人员同步由 `$meritdata-platform-mod-masterdata-sync` 负责；本 Skill 仅提供认证和编目底座。
+
+## 验收
+
+执行 acceptance.md（参考：，待补充） 的 WA-01 至 WA-07。未知版本、未登记 API、无授权关系、Secret 可被日志捕获或重放请求仍成功均为阻断项。
+
+## 不适用
+
+- 内部 Feign、动态 Feign 或本地 Bean：使用 feign-api/services。
+- 网关路由部署、证书签发或 License 破解：不属于本 Skill。
+- 前端多服务 Axios：使用 http-client（若套件已启用）。