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

package/skills/meritdata-bootstrap-2nd-dev/references/verify.md

@@ -1,204 +0,0 @@
-# 脚手架生成后校验（bootstrap-2nd-dev）
-
-> 生成项目后的 9 步校验清单，确保符合 MeritData 规范。
-
----
-
-## 1. 文件结构校验
-
-```bash
-# 必须存在的文件
-test -f pom.xml && echo "✅ pom.xml" || echo "❌ pom.xml 缺失"
-test -f README.md && echo "✅ README.md" || echo "❌ README.md 缺失"
-test -f Dockerfile && echo "✅ Dockerfile" || echo "❌ Dockerfile 缺失"
-test -f .gitignore && echo "✅ .gitignore" || echo "❌ .gitignore 缺失"
-test -f src/main/java && echo "✅ src/main/java" || echo "❌ src/main/java 缺失"
-test -f src/main/resources/application.yml && echo "✅ application.yml" || echo "❌ 缺失"
-test -f src/main/resources/bootstrap.yml && echo "✅ bootstrap.yml" || echo "❌ 缺失"
-test -f src/test/java && echo "✅ src/test/java" || echo "❌ 缺失"
-```
-
-## 2. 占位符替换校验
-
-```bash
-# 不应残留 sample 字符串
-if grep -r 'com\.meritdata\.cloud\.sample' src/ pom.xml 2>/dev/null; then
-    echo "❌ 占位符未替换：com.meritdata.cloud.sample"
-    exit 1
-else
-    echo "✅ 未发现 sample 占位符"
-fi
-
-# 不应残留模板的项目名
-if grep -r '\${projectName}\|\${groupId}\|\${artifactId}' src/ pom.xml 2>/dev/null; then
-    echo "❌ 模板占位符未替换"
-    exit 1
-else
-    echo "✅ 模板占位符已替换"
-fi
-```
-
-## 3. 编译校验
-
-```bash
-mvn clean compile -DskipTests
-echo "Exit: $?"
-```
-
-- ✅ 编译通过
-- ❌ 报错：检查 `<parent>` 版本 / 依赖冲突
-
-## 4. 启动校验
-
-### 4.1 准备
-
-```bash
-# 1. 启动 Nacos（如未启动）
-docker run -d --name nacos -p 8848:8848 \
-  -e MODE=standalone \
-  nacos/nacos-server:v2.3.0
-
-# 2. 启动 MySQL（如未启动）
-docker run -d --name mysql -p 3306:3306 \
-  -e MYSQL_ROOT_PASSWORD=root \
-  -e MYSQL_DATABASE=order_dev \
-  mysql:8.0
-
-# 3. 建库（如果上面没指定）
-mysql -h 127.0.0.1 -uroot -proot -e "
-  CREATE DATABASE IF NOT EXISTS order_dev
-  DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-"
-```
-
-### 4.2 启动
-
-```bash
-mvn spring-boot:run -Dspring-boot.run.profiles=dev
-```
-
-观察日志：
-- ✅ `Started OrderApplication in 5.234 seconds`
-- ✅ `DiscoveryClient` 注册成功：`my-2nd-service`
-- ❌ `APPLICATION FAILED TO START` — 检查错误
-
-### 4.3 验证
-
-```bash
-# 健康检查
-curl http://127.0.0.1:8080/my-2nd-service/actuator/health
-# {"status":"UP"}
-
-# Nacos 注册
-curl http://127.0.0.1:8848/nacos/v1/ns/instance/list?serviceName=my-2nd-service
-```
-
-## 5. 命名规范校验
-
-```bash
-# 包名小写
-grep -rE '^package [A-Z]' src/main/java/ && echo "❌ 包名大写" || echo "✅ 包名规范"
-
-# 类名大驼峰
-grep -rE '^public class [a-z]' src/main/java/ && echo "❌ 类名小写" || echo "✅ 类名规范"
-```
-
-## 6. 4 铁律校验（必须）
-
-调用 [`meritdata-platform-2nd-dev-check`](../meritdata-platform-2nd-dev-check/references/guide.md)：
-
-```bash
-bash tools/2nd-dev-check/run.sh my-2nd-service
-```
-
-应通过：
-- ✅ §1.1 无 PF_ 平台表
-- ✅ §1.2 无分页循环 Feign
-- ✅ §1.3 无平台 Entity import
-- ✅ §1.4 无空集合掩盖
-
-## 7. 测试启动
-
-```bash
-mvn test
-```
-
-- ✅ 测试通过
-- ❌ 模板测试失败：检查模板版本
-
-## 8. Git 初始化
-
-```bash
-cd my-2nd-service
-git init
-git add .
-git commit -m "feat: 从 2nd-dev-template v1.0 初始化项目"
-
-# 推送到远端
-git remote add origin git@git.meritdata.com:my-team/my-2nd-service.git
-git push -u origin main
-```
-
-## 9. CI 触发
-
-推送后 GitHub Actions / GitLab CI 自动运行：
-
-- ✅ `build` 通过
-- ✅ `lint` 通过
-- ✅ `test` 通过
-
-## 10. ❌ 常见错误
-
-### 10.1 ❌ Nacos namespace 不存在
-
-```
-c.a.c.n.registry.NacosDiscoveryClient : failed to register
-```
-
-✅ 在 Nacos 控制台创建 namespace，复制 namespace ID 到配置。
-
-### 10.2 ❌ 数据库权限不足
-
-```
-Access denied for user 'root'@'localhost'
-```
-
-✅ 检查 MySQL 用户权限：`GRANT ALL ON order_dev.* TO 'order'@'localhost';`
-
-### 10.3 ❌ 端口占用
-
-```
-Web server failed to start. Port 8080 was already in use.
-```
-
-✅ `lsof -i:8080` 找到占用进程，杀掉或换端口。
-
-### 10.4 ❌ 父 POM 拉取失败
-
-```
-Could not resolve com.meritdata.cloud:cloud-parent:5.6.0
-```
-
-✅ 配置 Maven 私有仓库（`~/.m2/settings.xml`）。
-
-## 11. 校验 Checklist
-
-```
-[ ] 文件结构完整（pom / README / Dockerfile / .gitignore）
-[ ] 占位符已全部替换
-[ ] mvn compile 通过
-[ ] mvn spring-boot:run 启动成功
-[ ] curl /actuator/health 返回 UP
-[ ] Nacos 注册成功
-[ ] 包名/类名规范
-[ ] 4 铁律扫描通过
-[ ] mvn test 通过
-[ ] git 已初始化并推送
-[ ] CI 流水线全绿
-```
-
-## 12. 关联阅读
-
-- [guide.md](guide.md) — 脚手架指南
-- [template.md](template.md) — 模板说明
-- [SKILL.md](../SKILL.md)

package/skills/meritdata-dev-docs-file-finder/SKILL.md

@@ -1,215 +0,0 @@
----
-name: meritdata-dev-docs-file-finder
-description: |
-  dev-docs/ 知识库兜底查找 skill。当用户需求不明确落在 `meritdata-platform-bpm`（流程）/ `meritdata-platform-config-integration`（配置集成）/ 9 个 L3 单点 skill 范围内（查询公共资产、外部接口、平台日志、缓存、Session、国密加解密、字典、菜单、资源权限等）时，AI 必须加载本 skill 读取 `references/dev-docs/README.md` + `references/scenarios.md` + `references/keywords.md` 匹配最相关的 dev-docs/ 拆分文件，再回答用户。
-metadata:
-  version: "1.0.0"
-  author: petroleum+rd
-  source: petroleum+rd
-  date_added: "2026-09-08"
-  last_modified: "2026-09-08"
-  risk: low
-  layer: L2
-  sub-layer: L2-M
-  stack: tool
-allowed-tools: Read, Grep, Glob
----
-
-# dev-docs 拆分文件查找器
-
-> **来源**：研发版 `meritdata-dev-docs-file-finder` v1.3.0 + 研发侧 `dev-docs/` 知识库（133 文件 / 32K 行，v2.3.0 P0 补齐）。
->
-> **范围**：作为 9 个 L3 单点 skill + `bpm` + `config-integration` 的**兜底查找**——查 L3 查不到时来这里。
->
-> **不直接执行开发**：本 skill 只做「找 + 读」两件事；动手写代码用具体 L3 skill。
-
-## 触发
-
-满足以下任一条件即可触发本 skill：
-- 用户描述了大致需求（"我想用 Redis 缓存用户会话"、"怎么做电子签章"、"美林平台有什么做 XX 的 API"）
-- 用户询问 dev-docs 拆分文件的位置或内容
-- L3 单点 skill 路由失败 / 关键词不在 L3 覆盖范围
-
-## 不触发
-
-- 直接执行开发任务 → 用对应的 L3 skill（如 `meritdata-platform-bpm`、`meritdata-platform-frontend`）
-- 跨服务 JOIN / 直连平台表 → ❌ 触发 `meritdata-platform-data-boundary` 铁律
-- 完全脱离 dev-docs 的问题
-
-## 前置约束
-
-- **dev-docs 知识库必须可用**：本 skill 依赖 `references/dev-docs/` 158 文件（`meritdata-platform-suite/skills/meritdata-dev-docs-file-finder/references/dev-docs/`）
-- **find 后必 read**：推荐文件列表不等于完事，AI 必须 `Read` 打开每个推荐文件读完内容再回答
-- **最多 3 个文件**：超过会让用户选择疲劳
-- **不要拼凑 API**：从 dev-docs 读到的方法名 / 参数 / 字段才能用，凭印象编 100% 会错
-
-## 路由（5 步决策树）
-
-### Step 1：检测需求是否充分
-
-**判断标准**：用户消息是否包含以下任一信号
-- 动词 + 名词（"用 XX"、"调用 XX"、"实现 XX"、"集成 XX"）
-- 关键词（"缓存"、"日志"、"加密"、"同步"、"授权"、"流程"、"定时"、"密级"、"选择器"等）
-- 明确的场景描述
-- **常见开发场景关键词**（覆盖使用攻略）："监听器"/"工作流程"/"系统认证"/"token"/"CAS"/"消息中心"/"定时任务"/"XXL-JOB"/"nacos 配置"/"组织同步"
-
-**如果需求不充分**（用户只说"帮我看下"、"查文档"等），立即用 AskUserQuestion 反问：
-
-```python
-AskUserQuestion(
-    questions=[{
-        "question": "请问您要查阅 dev-docs 中的哪个方向？",
-        "header": "需求方向",
-        "multiSelect": True,
-        "options": [
-            {"label": "后端公共资产（缓存/Nacos/国密/日志/会话/集成）", "description": "查阅平台提供的 Java 工具类和服务"},
-            {"label": "前端公共资产（Vue 组件/工具函数）", "description": "查阅前端 UI 组件和 JS 工具"},
-            {"label": "外部接口（基础配置/组织机构/资源管理）", "description": "查阅平台 HTTP 接口"},
-            {"label": "使用攻略（二开教程 / 集成指南 / 自定义开发）", "description": "10 篇按场景拆分的教程（BPM/认证/调度/消息中心/配置项等）"},
-            {"label": "二开就绪度检查（部署/版本/规范）", "description": "用 meritdata-platform-2nd-dev-check skill"},
-        ]
-    }]
-)
-```
-
-### Step 2：场景匹配（推荐）
-
-读取 [references/scenarios.md](references/scenarios.md)，根据用户需求中的关键词匹配最相关的场景。
-
-**匹配算法**：
-1. 提取用户需求中的名词 + 动词
-2. 在场景表中查找匹配（按"场景描述"列）
-3. **优先选最精确匹配**（场景描述与需求高度一致）
-4. **次选相关场景**（场景描述有部分关键词重叠）
-5. **最多推荐 3 个文件**（避免用户选择疲劳）
-
-### Step 3：关键词补充（兜底）
-
-如果场景表匹配不到，读 [references/keywords.md](references/keywords.md) 按关键词反查。
-
-### Step 4：输出推荐
-
-**输出格式**：
-```
-📚 根据您的需求「[用户需求]」，推荐以下文件：
-
-1. [文件名 1] - [一句话说明]
-2. [文件名 2] - [一句话说明]
-3. [文件名 3] - [一句话说明]
-
-💡 提示：[使用建议或相关文件补充]
-```
-
-**优先级规则**：
-- 多个匹配时，**单一精确匹配** > **多个相关匹配** > **关键词反查**
-- 如果只有 1 个匹配，直接推荐 1 个
-- 如果找到 2-3 个相关匹配，列出 2-3 个（按相关性排序）
-- 如果都不匹配，回退到 [references/dev-docs/README.md](references/dev-docs/README.md) 全文搜索
-
----
-
-### Step 5：🔍 必做 — 打开读取推荐文件（find 后必须 read）
-
-**find 是 skill 的活，read 是 AI 的活**。skill 输出推荐文件列表后**不算完**，AI 必须用 `Read` 工具**真的打开每个推荐文件读完完整内容**，再从里面取方法名 / 参数 / 字段名 / 代码片段，**直接呈现给用户**或落地到代码。
-
-**为什么必须有这步**：
-- 不读 = 推荐文件列表 = 没用（用户要的是答案，不是路径）
-- 不读 = AI 自己凭印象编 API 路径 / 方法签名 = 100% 会错
-- 读 + 摘抄关键信息 = 用户拿到可直接用的答案
-
-**怎么读**：
-```
-推荐文件列表 = ['references/dev-docs/02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md']
-→ Read(file_path='references/dev-docs/02_一基础设施-1.1缓存操作-SysCacheServiceFacade.md')
-→ 读完摘出 SysCacheServiceFacade.put(key, value) / get(key) / hset(...) 等关键方法
-→ 在回复里直接呈现给用户或写入代码
-```
-
-**反模式（必须避开）**：
-- ❌ 输完 3 个文件名就交差 —— **没读 = 没用**
-- ❌ "可以参考 `02_...md`" 然后让用户自己去看 —— 把 AI 的活甩给用户
-- ❌ 凭印象编 API 路径或方法签名 —— 100% 会错
-
-> 💡 **除非用户明确说"先列出来我挑"**，否则一律默认「找到 → 读 → 用」三步走完再回复。
-
----
-
-## 反问模板
-
-### 反问 1：需求方向
-当用户消息完全无具体需求时：
-- 后端公共资产 / 前端公共资产 / 外部接口 / 使用攻略 / 二开就绪度
-
-### 反问 2：具体场景
-当用户有大方向但无具体场景时：
-- "缓存用户会话/Token" vs "计数器/限流" vs "任务队列"
-- "组织人员同步" vs "数据密级配置" vs "资源授权"
-- "BPM 流程发起" vs "流程审批" vs "流程追踪"
-- "系统认证集成" vs "CAS 单点登录" vs "第三方认证"
-- "定时任务" vs "调度 API" vs "调度配置"
-
-### 反问 3：颗粒度
-当用户已明确场景但不确定是后端还是前端时：
-- "后端 Java 接口" vs "前端 Vue 组件"
-
----
-
-## 重要原则
-
-1. **find 后必 read**：本 skill 负责定位（Step 1-4），但**推荐文件不等于完事** —— AI 拿到推荐列表后**必须立即用 `Read` 打开每个推荐文件读完**（详见 Step 5），从读到的内容里取实际方法名 / 参数 / 字段，**不能凭印象编**
-2. **不擅自执行任务**：本 skill 只做「找 + 读」两件事；用户没明确要求时**不直接动手写业务代码**（那是各 L3 专项 skill 的活）
-3. **最多 3 个文件**：超过会让用户选择疲劳
-4. **明确说明理由**：每个推荐文件都要有一句话说明为什么相关
-5. **场景优先于关键词**：场景表是结构化匹配，关键词兜底
-6. **永远不假装知道**：如果真的匹配不到，明确说"未找到精确匹配，建议看 README.md"
-7. **专项优先 + 兜底**：BPM 相关用 `meritdata-platform-bpm`、配置/集成用 `meritdata-platform-config-integration`（v2.3.0 P1）；本 skill 兜底其他场景
-
----
-
-## 与其他 skill 的协作
-
-| 场景 | 优先 skill | 兜底 |
-|------|-----------|------|
-| BPM 流程 API / 工作流 / 监听器 | `meritdata-platform-bpm` + `bpm-攻略-NN.md` | 本 skill |
-| BPM 前端组件 | `meritdata-platform-frontend` + 攻略-08 | 本 skill |
-| 系统认证集成 | `meritdata-platform-sso` + 攻略-06 | 本 skill |
-| 缓存 / Nacos / Session / 日志 / 国密 | 对应 L3 skill（如 `meritdata-platform-cache`）+ dev-docs 公共资产 | 本 skill |
-| 组织 / 人员 / 角色 / 字典 | 对应 L3 skill（如 `meritdata-platform-org-user-api`）+ dev-docs 外部接口 | 本 skill |
-| 调度 / 定时任务 | `meritdata-platform-job` + 攻略-10 | 本 skill |
-| 消息中心 | `meritdata-platform-message-center` + 攻略-12 | 本 skill |
-| 配置项 / Nacos | `meritdata-platform-nacos-config` + 攻略-11 | 本 skill |
-| 数据源 | `meritdata-platform-data-access` + dev-docs 3.12 | 本 skill |
-
----
-
-## dev-docs 知识库结构
-
-```
-references/dev-docs/
-├── README.md                          # 📚 总索引（按场景匹配 + 关键词搜索 + 章节映射）
-├── CLAUDE.md                          # 二开能力速查清单
-├── AGENTS.md                          # AI agent 入口
-├── REQUIREMENT_DESIGN_REFERENCE.md    # 需求设计参考
-├── 01–17                              # 公共资产清单（缓存/Nacos/国密/日志/会话/UI 等）
-├── 18–49                              # 外部接口清单（基础配置/组织/资源/字典/数据源等）
-├── 攻略-NN-00_总览.md + 章节NN_*.md   # 10 篇使用攻略（BPM/认证/调度/消息中心等）
-└── .bak/                              # 原文件备份（公共资产-原文件 + 外部接口-原文件 + 16 个使用攻略）
-```
-
----
-
-## 相关文件
-
-| 文件 | 用途 |
-|------|------|
-| [references/scenarios.md](references/scenarios.md) | 场景→文件映射表（30+ 场景，**优先查这个**）|
-| [references/keywords.md](references/keywords.md) | 关键词→文件反查表（**兜底**）|
-| [references/dev-docs/README.md](references/dev-docs/README.md) | dev-docs 总索引（场景匹配 + 章节映射表）|
-| `references/dev-docs/攻略-NN-00_总览.md` | 10 个攻略的总览入口（按场景点入）|
-| `meritdata-platform-suite/研发skills/LEGACY.md §六` | 历史归档说明 |
-| `meritdata-platform-suite/docs/三方skill映射关系清单_*.md` | skill 映射清单 |
-
----
-
-**最后更新**：2026-09-08（v2.3.0 P0 补齐）
-**来源**：研发版 `meritdata-dev-docs-file-finder` v1.3.0 + `dev-docs/` 知识库