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

package/skills/meritdata-dev-docs-file-finder/references/scenarios.md

@@ -1,313 +0,0 @@
-# dev-docs 场景→文件映射表（30+ 场景）
-
-> **使用方式**：根据用户需求描述，匹配下表中"场景描述"列，找到对应文件
-
----
-
-## 一、后端公共资产
-
-### 1. 缓存 / Redis
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 缓存用户会话/Token | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` | KV 缓存（put/putExpire） |
-| 缓存配置项/简单字符串 | `03_一基础设施-1.1缓存操作-StringCacheFacade.md` | 字符串专用 |
-| 计数器/点赞/浏览量 | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` | increment/decrement |
-| 任务队列/消息队列 | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` | enqueue/dequeue |
-| 跨服务通知/事件订阅 | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` | publish/subscribe |
-| 分布式锁 | `02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md` | setIfAbsent |
-
-### 2. 配置中心 / Nacos
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 动态读取配置项 | `04_一基础设施-1.2配置中心-NacosUtils.md` | getProperty |
-| 修改 Nacos 配置 | `04_一基础设施-1.2配置中心-NacosUtils.md` | addConfig/publishConfig |
-| 获取 Nacos Token | `04_一基础设施-1.2配置中心-NacosUtils.md` | getNacosToken |
-
-### 3. 国密加解密
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| SM2 加密/签名/电子签章 | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` | Sm2Utils |
-| SM4 加密/合同加密 | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` | Sm4Utils |
-| SM3 哈希/数据指纹 | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` | SM3Encoder |
-| 数据签名验签 | `05_二通用工具-2.1加解密-SM2-SM3-SM4.md` | Sm2Utils |
-
-### 4. 日志 / 审计
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 记录操作日志/审计 | `06_三平台服务-3.1日志服务-ILogPostService.md` | ILogPostService |
-| 方法级日志注解 | `07_三平台服务-3.1日志注解-LogDesc-LogOperation.md` | @LogOperation |
-| 实体字段变更日志 | `07_三平台服务-3.1日志注解-LogDesc-LogOperation.md` | @LogDesc/@AddDesc/@DelDesc |
-| 自定义日志 | `07_三平台服务-3.1日志注解-LogDesc-LogOperation.md` | POST /post-diy |
-
-### 5. 会话 / 当前用户
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 获取当前登录用户 ID | `08_三平台服务-3.3会话信息-SessionUtils.md` | getUserId |
-| 获取当前用户部门/组织 | `08_三平台服务-3.3会话信息-SessionUtils.md` | getDept/getOrg |
-| 获取当前用户角色/权限 | `08_三平台服务-3.3会话信息-SessionUtils.md` | getRoleCodes/getAuthoritiesIds |
-| 获取租户 ID | `08_三平台服务-3.3会话信息-SessionUtils.md` | getTenantId |
-| 判断是否管理员 | `08_三平台服务-3.3会话信息-SessionUtils.md` | isAdmin |
-| 踢出在线用户 | `09_三平台服务-3.3在线用户-IUserOnlineTime.md` | getOutOnlineByUserNames |
-
-### 6. 多系统集成 / 数据密级
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 同步组织人员数据 | `10_三平台服务-3.4多系统集成+3.5数据密级.md` | WebService/RESTful |
-| WebService 同步接口 | `10_三平台服务-3.4多系统集成+3.5数据密级.md` | syncOrgWebService |
-| RESTful 同步接口 | `10_三平台服务-3.4多系统集成+3.5数据密级.md` | /webapi/ou/sync/* |
-| 启用数据密级过滤 | `10_三平台服务-3.4多系统集成+3.5数据密级.md` | @EnableDataSecretFilter |
-| 行级权限控制 | `10_三平台服务-3.4多系统集成+3.5数据密级.md` | Hibernate @Filter |
-
-### 7. 服务通知
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 角色变更通知 | `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md` | sendRoleMessage |
-| 资源变更通知 | `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md` | sendResourceMessage |
-| 用户角色变更通知 | `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md` | sendUserRoleMessage |
-| 权限分配通知 | `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md` | sendAssignMessage |
-
-### 8. 业务组件
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 流程发起/审批/退回 | `12_四业务组件-4.1工作流BpmEngine.md` | BpmEngine |
-| 流程追踪/待办查询 | `12_四业务组件-4.1工作流BpmEngine.md` | getGraphTrack |
-| 调度编排/DolphinScheduler | `13_四业务组件-4.2调度组件ICloudClient.md` | ICloudClient |
-| 定时任务/XXL-JOB | `14_四业务组件-4.3定时任务IJobApi.md` | IJobApi |
-| 添加定时任务 | `14_四业务组件-4.3定时任务IJobApi.md` | addJob |
-| 触发任务 | `14_四业务组件-4.3定时任务IJobApi.md` | triggerJob |
-
----
-
-## 二、前端公共资产
-
-### 9. Vue UI 组件
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 通用对话框/弹窗 | `15_五前端资产-5.1UI组件库-上半.md` | CloudDialog |
-| 用户选择器/单选 | `15_五前端资产-5.1UI组件库-上半.md` | UserSelect |
-| 用户选择器/多选 | `15_五前端资产-5.1UI组件库-上半.md` | UserSelectMulti |
-| 部门选择器 | `15_五前端资产-5.1UI组件库-上半.md` | DeptSelect |
-| 角色选择器 | `15_五前端资产-5.1UI组件库-上半.md` | RoleSelect |
-| 导入按钮/Excel导入 | `15_五前端资产-5.1UI组件库-上半.md` | ImportButton |
-| 菜单权限控制 | `15_五前端资产-5.1UI组件库-上半.md` | MenuAuth |
-| 资源代码授权 | `16_五前端资产-5.1UI组件库-下半.md` | ResourceCodeAuth |
-| 三员授权 | `16_五前端资产-5.1UI组件库-下半.md` | ThreeMemberAuth |
-| 表格头部搜索 | `16_五前端资产-5.1UI组件库-下半.md` | TableHeadSearch |
-| 二级鉴别密码 | `16_五前端资产-5.1UI组件库-下半.md` | VerifiyPassword |
-| 通用头部布局 | `16_五前端资产-5.1UI组件库-下半.md` | CommonHeader |
-
----
-
-## 三、外部接口
-
-### 9.5 外部接口总览
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 外部接口目录/清单说明 | `18_目录与文档说明.md` | 147 个外部 API 文档说明 |
-| 接口清单总览/平台有哪些接口 | `18_目录与文档说明.md` | 文档结构 + 接口统计 |
-
-### 10. 基础配置（1.x）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 平台产品信息/首页配置 | `19_1.1-1.6基础配置-平台信息类.md` | 1.1-1.6 |
-| 平台密级信息 | `19_1.1-1.6基础配置-平台信息类.md` | 1.5 |
-| 初始化密码策略 | `19_1.1-1.6基础配置-平台信息类.md` | 1.3 |
-| 登录页定制/超链接 | `20_1.7-1.10基础配置-页面与消息类.md` | 1.7-1.10 |
-| 保存/发送消息 | `20_1.7-1.10基础配置-页面与消息类.md` | 1.10 |
-| 消息中心/已读未读 | `21_1.11-1.15基础配置-消息与配置类.md` | 1.11-1.15 |
-| 首页框架配置 | `21_1.11-1.15基础配置-消息与配置类.md` | 1.14 |
-| 角色路由跳转 | `21_1.11-1.15基础配置-消息与配置类.md` | 1.15 |
-
-### 11. 组织人员同步（1.16）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 同步 HR 组织架构 | `22_1.16组织人员同步.md` | syncOrg |
-| 同步人员信息 | `22_1.16组织人员同步.md` | syncUser |
-| 同步资源/菜单 | `22_1.16组织人员同步.md` | syncResource |
-| 同步角色 | `22_1.16组织人员同步.md` | syncRole |
-| 同步权限分配 | `22_1.16组织人员同步.md` | syncAssign |
-
-### 12. 数据密级（1.17）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 数据密级配置 | `23_1.17资源数据密级-上半.md` + `24_1.17资源数据密级-下半.md` | 1.17.1-1.17.4 |
-| 密级数据字典 | `24_1.17资源数据密级-下半.md` | 1.17.5-1.17.8 |
-
-### 13. 组织机构（2.x）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 组织 CRUD | `25_2.1组织维护-上半.md` + `26_2.1组织维护-下半.md` | 2.1.1-2.1.11 |
-| 组织树查询 | `26_2.1组织维护-下半.md` | 2.1.9 |
-| 人员 CRUD | `27_2.2人员维护-上半.md` + `28_2.2人员维护-下半.md` | 2.2.1-2.2.14 |
-| 人员列表/查询 | `27_2.2人员维护-上半.md` | 2.2.6 |
-| 角色管理 | `29_2.3角色维护-上半.md` + `30_2.3角色维护-下半.md` | 2.3.1-2.3.16 |
-| 添加角色人员 | `29_2.3角色维护-上半.md` | 2.3.1 |
-| 用户管理 | `31_2.4用户维护-上半.md` + `32_2.4用户维护-下半.md` | 2.4.1-2.4.13 |
-| 用户启停/启用 | `31_2.4用户维护-上半.md` | 2.4.5-2.4.6 |
-| 密码初始化 | `32_2.4用户维护-下半.md` | 2.4.12 |
-| 工作组管理 | `33_2.5工作组维护.md` | 2.5.1-2.5.2 |
-| 根据用户查人员 | `34_2.6其他接口-上半.md` | 2.6.1 |
-| 登录名称查询 | `34_2.6其他接口-上半.md` | 2.6.2 |
-| 模糊查询用户 | `35_2.6其他接口-下半.md` | 2.6.8 |
-
-### 14. 资源管理（3.x）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 资源授权 | `36_3.1-3.7资源授权基础.md` + `37_3.8-3.10资源授权进阶.md` | 3.1-3.10 |
-| 按角色获取菜单 | `36_3.1-3.7资源授权基础.md` | 3.1 |
-| 按用户获取菜单 | `36_3.1-3.7资源授权基础.md` | 3.3 |
-| 数据字典 | `38_3.11基础数据.md` | 3.11.1 |
-| 日志同步 | `38_3.11基础数据.md` | 3.11.2 |
-| 动态数据源 | `39_3.12数据源维护.md` | 3.12.1-3.12.3 |
-| DAM 第三方资源 | `40_3.13第三方资源维护.md` | 3.13.1-3.13.4 |
-| 应用服务管理 | `41_3.14服务管理.md` | 3.14.1-3.14.7 |
-| 资源菜单 CRUD | `42_3.15资源维护-上半.md` + `43_3.15资源维护-下半.md` | 3.15.1-3.15.10 |
-| 门户菜单 | `42_3.15资源维护-上半.md` | 3.15.4-3.15.5 |
-| 人员选择器（API）| `44_3.16人员选择器-上半.md` + `45_3.16人员选择器-下半.md` | 3.16.1-3.16.7 |
-| 报表授权 | `46_3.17填报报表+3.18验证码.md` | 3.17 |
-| 验证码 | `46_3.17填报报表+3.18验证码.md` | 3.18 |
-| 工作台/Logo | `47_3.19工作台维护.md` | 3.19.1-3.19.2 |
-| 调度编排状态 | `48_3.20调度编排.md` | 3.20.1 |
-| 立即执行调度 | `48_3.20调度编排.md` | 3.20.3 |
-
----
-
-## 四、附录
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 返回码列表 | `49_附录-4.1-4.3返回码与版本清单.md` | 4.1 |
-| V6.8/V6.9 版本新增接口 | `49_附录-4.1-4.3返回码与版本清单.md` | 4.2-4.3 |
-| Maven 依赖 | `17_附录-统计汇总-Maven依赖-注意事项.md` | 附录 A |
-| 组件开发注意事项 | `17_附录-统计汇总-Maven依赖-注意事项.md` | 附录 B |
-| 平台命名规范 | `01_目录与文档结构.md` | 文档结构 |
-| 组件统计 | `17_附录-统计汇总-Maven依赖-注意事项.md` | 统计汇总 |
-
----
-
-## 五、使用攻略（10 篇 / 2026-08 新增）
-
-> **匹配原则**：用户提"教程 / 怎么做 / 集成 / 接入 / 二开 / 自定义"等意图时，优先进入使用攻略。比详细 API 文档更易读。
-
-### 1. 流程 API（攻略-01）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 流程引擎初始化 / 规则引擎初始化 | `攻略-01-流程API-章节02_规则引擎初始化接口.md` | 启动前初始化 |
-| 启动流程实例 / 发起流程 | `攻略-01-流程API-章节03_启动流程实例接口.md` | 流程发起 |
-| 完成任务 / 流程审批 | `攻略-01-流程API-章节05_完成任务接口.md` | 审批通过 |
-| 填写意见 / 审批意见 | `攻略-01-流程API-章节06_填写意见接口.md` | 审批备注 |
-| 查看流程追踪 / 流程图 | `攻略-01-流程API-章节08_查看追踪接口.md` | 含 8.1-8.4 |
-| 退回拟稿人 / 退回流程 | `攻略-01-流程API-章节09_退回拟稿人接口.md` | 一键回退 |
-| 退回上一环节 | `攻略-01-流程API-章节10_退回上一环节处理人接口.md` | 退回指定节点 |
-| 流程设计器列表 | `攻略-01-流程API-章节11_流程设计器列表查询.md` | 设计器端 |
-| 个人待办 / 我的待办 | `攻略-01-流程API-章节12_个人待办.md` | 待办列表 |
-| 阅知 / 抄送 / 通知 | `攻略-01-流程API-章节13_阅知.md` | 阅知完整流程 |
-| 流程最新定义ID | `攻略-01-流程API-章节14_流程最新定义ID.md` | procDefId |
-| 业务相关接口 / 流程实例查询 | `攻略-01-流程API-章节15_业务相关接口.md` | 14.1-14.5 |
-
-### 2. 工作流程应用开发（攻略-02）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 创建 BPM 后端工程 | `攻略-02-工作流程-章节02_后端工程创建.md` | 工作流程工程 |
-| 引入 BPM 依赖 / pom 配置 | `攻略-02-工作流程-章节03_后端工程配置.md` | pom.xml + bootstrap.properties |
-| 流程业务类编写 | `攻略-02-工作流程-章节04_后端工程业务类创建.md` | 实体 + Service |
-| 启动后端应用 | `攻略-02-工作流程-章节05_启动后端应用工程.md` | 启动流程 |
-| 流程前端开发 | `攻略-02-工作流程-章节06_流程应用前端开发.md` | 前端集成 |
-| 启动前端应用 | `攻略-02-工作流程-章节07_启动前端应用工程.md` | npm/scripts |
-| 流程设计 / 流程图设计 | `攻略-02-工作流程-章节08_流程设计.md` | 流程图编辑器 |
-
-### 3. 监听表达式开发（攻略-03）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 流程监听器 / 监听表达式 | `攻略-03-监听表达式-章节01_实现策略.md` | 实现思路 |
-| 自定义监听 jar 包 | `攻略-03-监听表达式-章节02_自定义_jar_包的实现流程.md` | jar 工程创建 |
-| 监听服务搭建 | `攻略-03-监听表达式-章节03_自定义服务搭建.md` | 微服务 |
-| 流程设计设置 listener | `攻略-03-监听表达式-章节04_流程设计中设置_listener_参数.md` | 流程定义 |
-| 验证监听事件 | `攻略-03-监听表达式-章节05_测试触发流程监听事件是否生效.md` | 测试 |
-
-### 6. 系统认证集成（攻略-06）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 平台 token 认证 / token 集成 | `攻略-06-系统认证-章节02_token_认证集成.md` | 含 2.3.1/2.3.2/2.3.3 |
-| CAS 单点登录 / CAS 集成 | `攻略-06-系统认证-章节03_cas_统一认证中心.md` | 含 3.2.1-3.2.6 完整步骤 |
-| 第三方认证中心 / 自定义认证 | `攻略-06-系统认证-章节04_第三方认证中心.md` | 4.1-4.5 |
-| 认证中心端配置 | `攻略-06-系统认证-章节05_附录_1_认证中心端配置.md` | 证书生成 |
-
-### 7. 流程模块设计（攻略-07）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| BPM 架构理解 | `攻略-07-流程模块设计-章节01_背景.md` | 整体介绍 |
-| 工作流相关介绍 | `攻略-07-流程模块设计-章节02_工作流相关介绍.md` | BPM 概念 |
-| 流程包含模块 | `攻略-07-流程模块设计-章节03_应用开发平台流程包含模块.md` | 模块图 |
-| 流程功能模块 | `攻略-07-流程模块设计-章节04_流程功能模块介绍.md` | 设计器/业务/组件/样例 |
-| 流程后端设计 | `攻略-07-流程模块设计-章节05_流程后端设计.md` | 5.1-5.5 |
-| 流程前端设计 | `攻略-07-流程模块设计-章节06_流程前端设计.md` | 6.1-6.3 |
-| 流程模块二次开发 | `攻略-07-流程模块设计-章节07_二次开发.md` | 二次开发 |
-| 个人样例流程 | `攻略-07-流程模块设计-章节08_个人样例流程的配置.md` | 8.1-8.6 |
-
-### 8. 流程前端组件（攻略-08）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| BpmFormTools / 流程表单工具 | `攻略-08-流程前端组件-章节03_BpmFormTools_-_BPM表单工具组件.md` | Props/Events |
-| BpmGridButtonsNew / 流程按钮 | `攻略-08-流程前端组件-章节04_BpmGridButtonsNew_-_BPM表格按钮组件.md` | 状态值 |
-| MeritBPM / BPM 组件方法 | `攻略-08-流程前端组件-章节01_概述.md` | 方法概览 |
-| 后端 BpmEngine 核心接口 | `攻略-08-流程前端组件-章节05_后端BpmEngine核心接口.md` | 4.1-4.5 |
-
-### 9. 组织人员同步（攻略-09）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 组织同步 / webservice / RESTful | `攻略-09-组织人员同步-章节02_组织同步.md` | 2.1.1/2.1.2 |
-| 人员同步 / HR 集成 | `攻略-09-组织人员同步-章节03_人员同步.md` | 3.1.1/3.1.2 |
-| 资源菜单同步 | `攻略-09-组织人员同步-章节04_资源菜单同步.md` | 4.1.1/4.1.2 |
-| 角色同步 | `攻略-09-组织人员同步-章节05_角色同步.md` | 5.1.1/5.1.2 |
-| 资源权限同步 | `攻略-09-组织人员同步-章节06_资源权限同步.md` | 6.1.1/6.1.2 |
-| 同步配置 / 触发器 | `攻略-09-组织人员同步-章节07_组织同步配置.md` | nacos 配置 |
-
-### 10. 定时调度任务（攻略-10）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| XXL-JOB 调度 / JobHandler | `攻略-10-定时调度-章节03_调度相关应用包.md` | 引入依赖 |
-| 调度配置 / Cron 表达式 | `攻略-10-定时调度-章节04_配置项相关.md` | nacos 配置 |
-| 调度任务注册 / 客户端注册 | `攻略-10-定时调度-章节05_调度功能使用.md` | 3.1-3.3 |
-| 调度任务 API | `攻略-10-定时调度-章节06_调度任务_API_接口.md` | 调用样例 |
-| 对外调度 API | `攻略-10-定时调度-章节07_对外调度任务_API_接口.md` | 平台对外 |
-
-### 11. 系统配置项管理（攻略-11）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| nacos 配置查询 / 配置项说明 | `攻略-11-配置项-章节01_应用配置项相关.md` | bootstrap 地址 |
-| 配置文件列表 / 命名空间维护 | `攻略-11-配置项-章节02_配置中心配置项说明.md` | 9 个配置文件 + 2.3 全量详情 |
-| 配置项使用 / @Value / 配置实体类 | `攻略-11-配置项-章节03_配置项的使用.md` | @RefreshScope 等 |
-
-### 12. 消息中心（攻略-12）
-
-| 用户需求关键词 | 推荐文件 | 备注 |
-|--------------|---------|------|
-| 消息中心使用场景 | `攻略-12-消息中心-章节01_消息中心使用场景.md` | 概述 |
-| 消息中心页面 / 消息管理 / 消息提醒 | `攻略-12-消息中心-章节02_消息中心页面功能使用.md` | 2.1-2.3 |
-| 消息发送 API / 消息列表 | `攻略-12-消息中心-章节03_消息中心接口功能使用.md` | 3.1-3.2 |
-| 附件上传 / 附件下载 | `攻略-12-消息中心-章节04_附：附件上传下载删除接口.md` | 附录 |

package/skills/meritdata-nacos-importer/SKILL.md

@@ -1,37 +0,0 @@
----
-name: meritdata-nacos-importer
-description: 批量导入 Nacos 配置（YAML/Properties → Nacos 服务）。当用户说"导入 Nacos 配置 / 上线配置 / 批量同步 / 灰度发布"时使用。
-metadata:
-  version: "1.0.0"
-  risk: high
-  layer: L4
-  sub-layer: L4-T
-  stack: tool
----
-
-# meritdata-nacos-importer
-
-## 触发
-
-- 用户说"导入 Nacos 配置 / 上线配置 / 批量同步"
-- 用户提供 YAML/Properties 文件 + Nacos server + namespace
-- 灰度发布：先把配置推到"灰度命名空间"
-
-## 不触发
-
-- 单个 key 修改（→ Nacos 控制台 / API）
-- 配置中心架构问题（→ `meritdata-platform-nacos-config` skill）
-- 配置变更通知应用（→ `meritdata-platform-nacos-config` §shared-config）
-
-## 前置约束
-
-- 必须有 Nacos 服务地址 + 命名空间 ID + 访问凭证
-- 配置 key 命名遵守 [`rules/nacos-rules.md`](../../rules/nacos-rules.md)
-- 生产导入**必须先灰度**（PROD 命名空间单独审）
-- 大文件（>1MB）禁止推 Nacos（应用 `application-<env>.yml` 拆分）
-
-## 路由
-
-- [guide.md](references/guide.md) — 导入命令 + 工作流
-- [yaml-spec.md](references/yaml-spec.md) — YAML/Properties 文件规范
-- [gray-publish.md](references/gray-publish.md) — 灰度发布流程

package/skills/meritdata-nacos-importer/references/gray-publish.md

@@ -1,216 +0,0 @@
-# 灰度发布流程（nacos-importer）
-
-> Nacos 配置灰度发布的标准流程。
-
----
-
-## 1. 灰度发布 vs 全量发布
-
-| 维度 | 灰度发布 | 全量发布 |
-|------|---------|---------|
-| 范围 | 2-3 个实例 / 1 个 namespace | 全部实例 |
-| 风险 | 低（出问题只影响少量）| 高 |
-| 时间 | 长（分阶段）| 短（一次性）|
-| 适用 | 重要配置 / 不可逆操作 | 普通配置 / 可回滚 |
-
-## 2. 灰度命名空间
-
-### 2.1 创建
-
-在 Nacos 控制台：
-
-```
-命名空间名: gray-20260907-<变更主题>
-命名空间ID: 自动生成（复制用）
-描述: <变更原因>，操作人：张三
-```
-
-### 2.2 命名规范
-
-```
-gray-<YYYYMMDD>-<变更简述>
-```
-
-例：
-- `gray-20260907-bpm-timeout`
-- `gray-20260907-datasource-url`
-
-## 3. 灰度发布流程
-
-```
-1. 准备
-   ├─ 创建 PR / 评审
-   ├─ 创建 gray-xxx 命名空间
-   └─ 通知相关方
-
-2. 推送灰度
-   └─ nacos-import --namespace=gray-20260907-bpm-timeout
-
-3. 应用接入灰度
-   ├─ @NacosValue(group="gray-20260907-bpm-timeout")
-   └─ 或 spring.cloud.nacos.config.namespace=gray-20260907-bpm-timeout
-
-4. 验证（30 min）
-   ├─ 监控 / 日志 / 业务指标
-   ├─ 1-3 个实例跑灰度
-   └─ 通过 → 5 → 不通过 → 6.1
-
-5. 全量发布
-   ├─ nacos-import --namespace=prod
-   ├─ 监控所有实例
-   └─ 通过 → 6.2 / 不通过 → 6.1
-
-6. 收尾
-   ├─ 6.1 回滚：删除灰度 / 生产配置
-   └─ 6.2 清理：删除灰度命名空间
-```
-
-## 4. 配置示例
-
-### 4.1 应用端按 group 拉取
-
-```java
-@NacosValue(
-    value = "${order.timeout-seconds:30}",
-    group = "gray-20260907-bpm-timeout",  // 灰度
-    autoRefreshed = true
-)
-private int timeoutSeconds;
-```
-
-### 4.2 完整 namespace 切换
-
-```yaml
-# bootstrap.yml
-spring:
-  cloud:
-    nacos:
-      config:
-        namespace: gray-20260907-bpm-timeout  # 灰度
-```
-
-## 5. 监控指标
-
-| 指标 | 正常范围 | 异常处理 |
-|------|---------|---------|
-| 配置拉取成功率 | ≥ 99.9% | < 99% 立即回滚 |
-| 应用启动失败率 | < 0.1% | > 1% 回滚 |
-| 业务 RT (P95) | 持平 | 上升 > 50% 评估 |
-| 业务错误率 | 持平 | 上升 > 0.1% 回滚 |
-| 数据库连接 | 正常 | 异常立即回滚 |
-
-## 6. 回滚策略
-
-### 6.1 立即回滚
-
-```bash
-# 删除灰度命名空间配置（应用自动 fallback 到 prod）
-nacos-import --namespace=gray-20260907-bpm-timeout --skip-existing
-
-# 或手动删除
-curl -X DELETE "http://127.0.0.1:8848/nacos/v1/cs/configs?dataId=...&group=..."
-```
-
-### 6.2 全量回滚
-
-```bash
-# 备份当前 prod 配置
-nacos-export --namespace=prod --output=./backup-before-rollback
-
-# 恢复上一个版本
-nacos-import --namespace=prod --input-dir=./backup-before-rollback --skip-existing
-```
-
-## 7. CHANGELOG 模板
-
-```markdown
-## [YYYY-MM-DD] 配置变更
-
-**变更主题**：BPM 流程超时从 30s 改为 60s
-**变更人**：张三
-**灰度 ID**：gray-20260907-bpm-timeout
-**影响范围**：所有 BPM 流程
-
-**变更前**：
-```yaml
-meritdata:
-  bpm:
-    timeout-seconds: 30
-```
-
-**变更后**：
-```yaml
-meritdata:
-  bpm:
-    timeout-seconds: 60
-```
-
-**验证**：
-- 监控：✓ RT 持平
-- 业务：✓ 流程跑通
-- 错误率：✓ 无上升
-
-**回滚**：删除 gray-20260907-bpm-timeout 命名空间
-```
-
-## 8. ❌ 反模式
-
-### 8.1 ❌ 直接改生产命名空间
-
-```
-1. 改 prod/...
-2. 应用立即生效
-3. 出问题没回滚机会
-```
-
-✅ 用灰度命名空间。
-
-### 8.2 ❌ 灰度过长
-
-```
-灰度 3 天 → 没人验证 → 错过最佳窗口
-```
-
-✅ 灰度 ≤ 24h，及时收尾。
-
-### 8.3 ❌ 没有验证指标就全量
-
-```bash
-# ❌ 错
-nacos-import --namespace=prod  # 没验证
-```
-
-✅ 先灰度 → 验证 → 全量。
-
-### 8.4 ❌ 没备份
-
-```bash
-# ❌ 错：导入前没备份
-nacos-import --namespace=prod --input-dir=./new-config
-# 旧配置丢了
-```
-
-✅ 先 `nacos-export` 备份。
-
-## 9. 紧急回滚 SOP
-
-```
-发现生产异常
-  ↓
-1. 立即：删除新推的配置
-   curl -X DELETE "http://.../configs?dataId=..."
-
-2. 应用自动 fallback 到默认值 / 上次配置
-
-3. 通知：群 / 邮件 / 告警
-
-4. 记录事故：时间 / 影响 / 根因
-
-5. 修复 → 重新灰度
-```
-
-## 10. 关联阅读
-
-- [guide.md](guide.md) — 导入指南
-- [yaml-spec.md](yaml-spec.md) — YAML 规范
-- [SKILL.md](../SKILL.md)