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

package/rules/frontend-component-rules.md

@@ -0,0 +1,174 @@
+<!--
+来源：研发skills/rules v1.0（2026-08 收录）
+抽取到 pfsuite/rules：2026-09-04
+后续治理：合并三方意见后再升级
+-->
+
+# 前端组件和交互规范
+
+**触发条件**：设计前端组件、定义用户交互行为、开发Element UI组件时
+
+---
+
+## 一、组件设计原则
+
+**必须执行**：
+- 组件保持单一职责，一个组件只做一件事
+- 组件高度控制在80px以内最佳
+- 组件必须设置明确的 Props 接口
+- 组件必须定义 Events 和 Slots
+- 组件必须处理自身的状态和逻辑
+
+**禁止执行**：
+- 禁止创建过于庞大的组件（超过500行）
+- 禁止在组件内部直接操作DOM
+- 禁止组件职责不清，功能混杂
+
+---
+
+## 二、对话框组件
+
+**必须执行**：
+- 对话框使用`el-dialog`组件
+- 支持通过props控制显隐
+- 支持通过slot自定义内容
+- 支持确认和取消操作的回调
+- 打开时自动聚焦第一个可输入项
+
+**对话框规范**：
+| 类型 | 标题格式 | 按钮 |
+|------|----------|------|
+| 确认对话框 | "操作名称 - 确认" | 确认/取消 |
+| 表单对话框 | "操作名称" | 提交/取消 |
+| 信息对话框 | "信息标题" | 确定 |
+
+---
+
+## 三、表单组件
+
+**必须执行**：
+- 使用`el-form`进行表单管理
+- 必填项添加红色星号标记
+- 输入框添加placeholder提示
+- 必填校验使用`trigger: 'blur'`
+- 表单项宽度统一：标准宽度300px
+
+**禁止执行**：
+- 禁止在表单中使用易混淆的验证规则
+- 禁止硬编码表单初始值（应从接口获取）
+- 禁止省略表单校验失败的错误提示
+
+---
+
+## 四、数据表格
+
+**必须执行**：
+- 使用`el-table`展示列表数据
+- 支持分页功能
+- 支持排序功能
+- 支持单选/多选功能
+- 加载状态显示loading遮罩
+- 空状态显示空表格提示
+
+**分页规范**：
+- 默认每页20条
+- 支持10/20/50/100条切换
+- 显示总条数信息
+- 保持当前页码记忆
+
+---
+
+## 五、按钮交互
+
+**必须执行**：
+- 主按钮放在右侧或底部
+- 危险操作使用红色按钮（如删除）
+- 按钮必须有明确的状态（正常/禁用/加载中）
+- 点击后显示loading状态防止重复提交
+- 操作完成后给予明确的反馈
+
+**按钮顺序**：
+```
+[取消] [确认/提交]
+```
+
+---
+
+## 六、消息提示
+
+**必须执行**：
+- 操作成功使用`Message.success`
+- 操作失败使用`Message.error`
+- 警告信息使用`Message.warning`
+- 通用提示使用`Message.info`
+- 消息自动关闭时间3秒
+
+**提示位置**：页面顶部居中
+
+---
+
+## 七、确认交互
+
+**必须执行**：
+- 删除操作必须二次确认
+- 危险操作使用`MessageBox.confirm`
+- 确认框显示操作内容的摘要
+- 取消操作不执行任何改变
+- 确认操作执行后刷新列表
+
+**确认框内容**：
+- 标题：明确操作类型
+- 内容：操作对象 + 操作描述
+- 按钮文字：明确动作含义
+
+---
+
+## 八、加载状态
+
+**必须执行**：
+- 页面加载显示全屏loading
+- 数据请求显示表格内loading
+- 按钮点击显示按钮内loading
+- 文件上传显示进度条
+- 加载失败显示错误状态和重试按钮
+
+**禁止执行**：
+- 禁止长时间不给出任何反馈
+- 禁止loading状态后仍可操作
+- 禁止隐藏加载错误信息
+
+---
+
+## 九、错误处理
+
+**必须执行**：
+- 表单校验失败显示具体错误信息
+- 接口错误显示友好错误提示
+- 网络错误显示重试选项
+- 404资源不存在显示跳转首页
+- 超时错误提示重新登录
+
+**禁止执行**：
+- 禁止直接展示后端错误堆栈
+- 禁止错误后不清理loading状态
+- 禁止关键操作失败无任何提示
+
+---
+
+## 十、响应式布局
+
+**必须执行**：
+- 最小支持宽度1024px
+- 内容区域使用自适应布局
+- 表格支持横向滚动
+- 对话框在小屏幕下全屏显示
+- 表单项在小屏幕下垂直排列
+
+---
+
+## 重要提醒
+
+- 用户操作必须得到即时反馈
+- 确认对话框是安全防线，禁止绕过
+- 加载状态是用户体验的关键
+- 错误信息要友好，不泄露技术细节

package/rules/git-workflow-rules.md

@@ -0,0 +1,85 @@
+<!--
+来源：研发skills/rules v1.0（2026-08 收录）
+抽取到 pfsuite/rules：2026-09-04
+后续治理：合并三方意见后再升级
+-->
+
+# Git 工作流
+
+**触发条件**：使用 Git 进行版本控制时
+
+---
+
+## 一、分支管理
+
+**必须执行**：
+- **永远不要直接提交到 main/master**
+- 从 main 创建功能分支：`feature/yarn-log-optimization`
+- 从 main 创建修复分支：`bugfix/connection-pool-leak`
+- 分支命名格式：`<type>/<short-description>`
+
+| 前缀 | 用途 | 示例 |
+|------|------|------|
+| `feature/` | 新功能 | `feature/user-auth` |
+| `bugfix/` | bug修复 | `bugfix/memory-leak` |
+| `hotfix/` | 紧急修复 | `hotfix/production-crash` |
+| `refactor/` | 重构 | `refactor/service-layer` |
+| `docs/` | 文档 | `docs/api-guide` |
+
+---
+
+## 二、提交规范
+
+**必须执行**：
+- 提交信息格式：`<type>(<module>): <描述>`
+- 描述使用中文，简洁明了，不超过50字
+
+| 类型 | 用途 | 示例 |
+|------|------|------|
+| `feat` | 新功能 | `feat(yarn): 添加日志聚合状态接口` |
+| `fix` | 修复bug | `fix(hadoop): 修复Kerberos认证失败` |
+| `docs` | 文档 | `docs: 更新API文档` |
+| `style` | 代码格式 | `style: 格式化代码` |
+| `refactor` | 重构 | `refactor: 提取公共方法` |
+| `test` | 测试 | `test: 添加单元测试` |
+| `chore` | 构建/工具 | `chore: 更新依赖版本` |
+
+**正确示例**：
+```bash
+git commit -m "feat(yarn): 添加日志聚合状态判断接口"
+git commit -m "fix(hadoop): 修复FileSystem未关闭问题"
+```
+
+---
+
+## 三、合并策略
+
+**必须执行**：
+- 使用 `--no-ff` 保留合并历史：`git merge --no-ff feature/xxx`
+- 合并前确保目标分支是最新的
+- 合并后**立即删除已合并的功能分支**
+
+---
+
+## 四、Commit Hooks
+
+**必须执行**：
+- 提交前运行测试验证（可选配置）
+- 使用 `--no-verify` 跳过 hook 时**必须说明原因**
+
+---
+
+## 五、PR 合并
+
+**必须执行**：
+- 创建 PR 时描述清楚：背景、修改内容、测试结果
+- 至少有一个 Reviewer 通过后再合并
+- 合并后自动删除 source 分支
+
+---
+
+## 重要提醒
+
+- 永远不要直接提交到 main/master
+- 提交信息要清晰描述"做了什么"，而不是"怎么做的"
+- 分支命名要简洁有意义

package/rules/meritdata-platform-data-boundary.md

@@ -0,0 +1,183 @@
+<!--
+来源：全局 ~/.claude/rules/meritdata-platform-data-boundary.md v1.0（2026-04 起累计）
+下放到套件：2026-09-09（v2.6.3）
+后续治理：套件内自包含权威版本；全局版可作为兜底但优先以本文件为准
+-->
+
+# MeritData 数据边界硬规则（所有 MeritData 项目自动生效）
+
+**触发条件**：任何 MeritData Cloud 二开项目的数据访问代码生成前、PR 提交前、CI 扫描时。
+
+**配套操作指南**：`meritdata-platform-data-access` skill（按需触发）—— 本文件只定义"什么不能做"，skill 定义"怎么做"。
+
+---
+
+## §1 4 条铁律（强制，违反即阻断）
+
+### 1.1 不映射 PF_ 前缀平台表
+
+**禁止**：二开业务库 `@TableName("PF_USER")` / `CREATE TABLE PF_xxx` / 跨库 JOIN 任何 PF_ 表。
+
+**理由**：PF_ 是平台专属表前缀，跨库访问导致数据库耦合、平台升级失败、并发压力转嫁。
+
+**唯一例外**：同 JVM 平台模块内的代码（详见 skill 的 `references/same-jvm.md`）。
+
+### 1.2 不分页循环逐条 Feign
+
+**禁止**：
+
+```java
+for (int page = 1; page <= totalPages; page++) {
+    List<MyData> dataList = myRepo.findPage(page);
+    for (MyData data : dataList) {
+        UserDTO user = userClient.getById(data.getUserId());  // N 次 Feign = N+1
+    }
+}
+```
+
+**正确模式**（详见 skill）：一次 Feign 批量拉取 + 内存 join。
+
+### 1.3 不复制平台 Entity/Repository
+
+**禁止**：`import com.meritdata.cloud.platform.entity.*` 出现在二开业务代码中（独立部署场景）。
+
+**正确模式**：通过 DTO 转换；独立服务通过 Feign Client 接收 DTO。
+
+### 1.4 不掩盖平台故障
+
+**禁止**：`catch (Exception e) { return Collections.emptyList(); }` 吃掉 Feign 失败。
+
+**正确模式**：显式上抛异常，让上游感知平台故障。
+
+---
+
+## §2 触发场景（本规则自动生效的场景）
+
+| 场景 | 是否触发本规则 |
+|------|--------------|
+| 二开库的数据访问代码生成 | ✅ 触发 |
+| 二开服务的 Controller/Service/Repository 文件修改 | ✅ 触发 |
+| Feign Client 代码生成 | ✅ 触发 |
+| 平台模块（与平台同 JVM）的代码修改 | ❌ 不触发（参考 `meritdata-platform-entities`）|
+| 前端代码生成 | ❌ 不触发（不涉及数据库）|
+| 文档生成 | ❌ 不触发 |
+
+---
+
+## §3 CI 校验命令（项目级可执行）
+
+### 3.1 检测 PF_ 表映射
+
+```bash
+grep -r 'PF_[A-Z]' src/main/java/ \
+  && echo "❌ 发现 PF_ 前缀引用，违反铁律 1.1" \
+  && exit 1 \
+  || echo "✅ 未发现 PF_ 引用"
+```
+
+### 3.2 检测跨库 JOIN
+
+```bash
+grep -rE 'JOIN\s+PF_' src/main/resources/mapper/ \
+  && echo "❌ 发现跨库 JOIN 平台表，违反铁律 1.1" \
+  && exit 1 \
+  || echo "✅ 未发现跨库 JOIN"
+```
+
+### 3.3 检测平台 Entity 直接 import
+
+```bash
+grep -r 'import com.meritdata.cloud.platform.entity' src/main/java/com/example/ \
+  && echo "❌ 二开项目不应直接 import 平台 Entity，违反铁律 1.3" \
+  && exit 1 \
+  || echo "✅ 未发现平台 Entity 直接引用"
+```
+
+### 3.4 检测空集合掩盖异常
+
+```bash
+grep -rn 'catch.*Exception.*emptyList\|catch.*Exception.*Collections.empty' src/main/java/ \
+  | grep -v 'test/' \
+  && echo "⚠️ 疑似空集合掩盖异常，请人工 review 是否违反铁律 1.4" \
+  || echo "✅ 未发现空集合掩盖模式"
+```
+
+完整脚本（含反模式库）见配套 skill 的 `references/validate-rules.md`。
+
+---
+
+## §4 配套 skill 与文档
+
+| 类别 | 入口 | 内容 |
+|------|------|------|
+| **硬约束**（本文件） | `~/.claude/rules/meritdata-platform-data-boundary.md` | 4 条铁律 + 触发场景 + CI 命令 |
+| **操作指南**（按需触发）| `meritdata-platform-data-access` skill | Feign 批量装配模式、同 JVM 判定、平台表清单 |
+| **平台表清单** | skill `references/cloud-tables.md` | 所有 PF_ 前缀表及对应 Feign/API |
+| **CI 脚本完整版** | skill `references/validate-rules.md` | 完整反模式检测脚本 |
+| **跨 skill 编排** | `meritdata-platform-playbook` | 综合需求时由 playbook 路由 |
+
+---
+
+## §5 反模式 vs 正模式速查
+
+| 反模式 | 正模式 | 触发铁律 |
+|--------|--------|---------|
+| `@TableName("PF_USER")` | `userClient.listByIds(...)` | 1.1 |
+| `for循环 + userClient.getById` | `userClient.listByIds(去重 ID 集合)` | 1.2 |
+| `import 平台 Entity` | 通过 DTO 转换 | 1.3 |
+| `catch + return emptyList` | `throw new ServiceException(...)` | 1.4 |
+| `select * from user u join order o ...` 跨库 | 业务数据本地 + 用户 Feign 批量 | 1.1 |
+
+---
+
+## §6 例外与豁免
+
+### 6.1 同 JVM 例外
+
+当二开代码与平台模块部署在**同一个 JVM 进程**且**明确引入 cloud-system-manage-module** 时，可直接使用平台本地 Bean（如 `IDamService`）。
+
+**判定方法**：详见 skill 的 `references/same-jvm.md`。
+
+**注意**：即使是同 JVM，**仍禁止**：
+- 直连平台数据库
+- 复制平台 Entity 到二开库
+- 跨库 JOIN
+
+### 6.2 测试代码豁免
+
+测试代码（`src/test/`）不受铁律 1.4（空集合掩盖）限制，可使用 mock 数据。
+
+### 6.3 历史项目兼容
+
+存量 5.x 旧版项目允许保留旧数据访问模式，但**新增代码必须遵守本规则**。
+
+---
+
+## §7 违规处置
+
+| 等级 | 触发条件 | 处置 |
+|------|---------|------|
+| 🔴 阻断 | 铁律 1.1 / 1.2 / 1.3 / 1.4 任一违反 | PR 拒绝合并；CI 失败 |
+| 🟠 警告 | 疑似反模式（如 §3.4 检测）| 人工 review；不阻断 |
+| 🟢 提示 | 不涉及数据访问的代码 | 不触发 |
+
+---
+
+## §8 与全局规则的关系
+
+| 现有 rule | 关系 |
+|----------|------|
+| `~/.claude/rules/code-dev-rules.md` | 本规则是其"数据访问"专项细化；通用编码规范仍由 code-dev-rules 管辖 |
+| `~/.claude/rules/security-rules.md` | 本规则涉及"敏感数据访问"的部分与 security-rules 协同 |
+| `~/.claude/rules/performance-rules.md` | 本规则 1.2（不分页循环 Feign）实质是 performance-rules 的"数据库性能"专项 |
+
+**优先级**：当本规则与其他 rule 冲突时，以本规则为准（专项规则优先于通用规则）。
+
+---
+
+## §9 版本与变更
+
+- v1.0（2026-09-04）：初版，从 `meritdata-platform-data-boundary` skill 的 4 条铁律 + 触发场景 + CI 命令抽取
+- 来源：原 `core/meritdata-platform-data-boundary/SKILL.md` §MUST DO + §触发条件 + §代码示例
+
+后续变更通过 PR review，重大变更需架构组确认。

package/rules/meritdata-platform-domain-model-rules.md

@@ -0,0 +1,248 @@
+<!--
+来源：全局 ~/.claude/rules/meritdata-platform-domain-model-rules.md v1.0（2026-04 起累计）
+下放到套件：2026-09-09（v2.6.3）
+后续治理：套件内自包含权威版本；全局版可作为兜底但优先以本文件为准
+-->
+
+# MeritData 业务建模硬规则（所有 MeritData 项目自动生效）
+
+**触发条件**：任何 MeritData Cloud 二开项目进行业务建模、数据库表设计、实体类生成前、PR 提交前。
+
+**配套操作指南**：`meritdata-platform-domain-model` skill（按需触发）—— 本文件只定义"什么不能做"和"必须怎么做"，skill 定义"怎么思考"。
+
+---
+
+## §1 表命名硬规则（强制，违反即阻断）
+
+### 1.1 二开业务表/字段必须小写蛇形
+
+**必须**：
+- 表名：`t_purchase_order`、`t_order_item`（小写蛇形，以 `t_` 开头）
+- 字段名：`order_no`、`create_by`、`create_time`（小写蛇形）
+- 索引名：`idx_t_purchase_order_user_id`、`uk_t_purchase_order_no`
+
+**禁止**：
+- 大写或驼峰：`PurchaseOrder`、`purchaseOrder`、`orderNo`
+- 沿用平台 `PF_` 前缀：`PF_USER`、`PF_LEGACY_ORDER`（详见 `meritdata-platform-data-boundary.md` §1.1）
+
+**实体类命名（与表命名解耦）**：
+- Java 实体类：**大驼峰**（PascalCase）—— `PurchaseOrder`、`OrderItem`
+- 字段：`orderNo`、`createBy`（驼峰）
+- 通过 `@Column("order_no")` 显式映射到小写蛇形字段
+
+### 1.2 历史/特殊主表可申请例外
+
+**例外流程**（必须同时满足）：
+1. 显式声明例外开关（如 `@TableName(value = "LEGACY_ORDER", excludeProperty = {...})`）
+2. 注明"不可改名原因"（对接上游老系统 / 监管要求 / 数据迁移约束）
+3. 新业务列、关联表**不随主表例外放宽**——仍按 §1.1 走小写蛇形
+
+**反例**：因主表叫 `T_LEGACY_ORDER`，就给新加的 `T_LEGACY_ORDER_DETAIL` 也用大写 → 禁止。
+
+---
+
+## §2 关联键硬规则（强制，违反即阻断）
+
+### 2.1 不得把人员、组织名称作为唯一关联键
+
+**禁止**：
+```sql
+-- ❌ 用姓名/组织名做关联
+WHERE t_order.applicant_name = '张三' AND t_order.dept_name = '采购部'
+```
+
+**必须**：
+```sql
+-- ✅ 用稳定 ID 做关联
+WHERE t_order.applicant_user_id = '10001' AND t_order.dept_id = 'D001'
+```
+
+**理由**：人员/组织名称会变更（重名、调动、合并），ID 才是稳定键。
+
+**配套**：名称作为**冗余字段**快照存储（如 `applicant_name_snapshot`），用于显示。
+
+### 2.2 跨服务禁止数据库外键
+
+**禁止**：
+```sql
+-- ❌ 二开服务 A 创建外键指向二开服务 B 的表
+ALTER TABLE t_order_a ADD CONSTRAINT fk_order_user FOREIGN KEY (user_id) REFERENCES service_b.t_user(id);
+```
+
+**必须**：跨服务通过应用层维护一致性（ID 引用 + 应用服务编排），数据库不加外键。
+
+**理由**：
+- 服务拆分要求数据自治
+- 跨服务外键导致级联删除/更新跨网络，事务无法保证
+- 部署独立化失败
+
+---
+
+## §3 平台语义硬规则（强制）
+
+### 3.1 平台字段类型与存储约束
+
+| 语义 | 字段命名 | UI 组件 | 服务路由 |
+|------|---------|---------|---------|
+| 人员 | `*_user_id`（必要时快照姓名） | `meritdata-platform-ui-components` 人员弹框 | Feign 批量装配（详见 `meritdata-platform-data-access`） |
+| 组织/部门 | `*_org_id` / `*_dept_id` | 部门/组织树组件 | 同上 |
+| 角色 | `*_role_id` / `*_role_code` | 角色选择组件 | `IAssignService` |
+| 字典 | `*_type` / `*_status`（稳定 code） | `ILookupService` + 字典选择器 | Feign 批量装配 |
+| 附件 | 业务附件关联表（不把二进制放主表） | 平台上传组件 | `meritdata-platform-impexp` |
+| 审批状态 | 业务状态与流程实例 ID 分离 | — | `meritdata-platform-bpm` |
+
+**禁止**：
+- 把人员/组织名称当主键（已在 §2.1）
+- 附件二进制直接存业务表
+- 业务状态与流程实例 ID 混用
+
+### 3.2 二开库 JOIN 平台表（已在 data-boundary 拦截）
+
+**禁止**：二开库任何 SQL/JPA 跨库 JOIN cloud 平台表（`PF_` 前缀）。
+
+**详见**：`~/.claude/rules/meritdata-platform-data-boundary.md` §1.1
+
+---
+
+## §4 软删除实体硬规则（与 data-boundary 联动）
+
+### 4.1 唯一性校验必须穿透软删除
+
+详见：`~/.claude/rules/code-dev-rules.md` §八（在 data-boundary §1.1 之后强制）。
+
+**禁止**：
+```java
+// ❌ JPQL 受 @Where 过滤，看不到软删除记录 → 校验放行 → INSERT 触发 SQLIntegrityConstraintViolationException
+if (repo.findByXxxNo(no).isPresent()) throw new XxxNoDuplicateException();
+```
+
+**必须**：
+```java
+// ✅ nativeQuery = true 的 findXxxIncludingDeleted 穿透 @Where
+if (repo.findXxxIncludingDeleted(no).isPresent()) throw new XxxNoDuplicateException();
+```
+
+---
+
+## §5 触发场景（本规则自动生效）
+
+| 场景 | 是否触发本规则 |
+|------|--------------|
+| 新建二开业务的数据库表 | ✅ 触发 |
+| 修改已有二开业务表的字段名 | ✅ 触发 |
+| 编写 JPA 实体类 / MyBatis Mapper | ✅ 触发 |
+| 跨服务接口契约设计 | ✅ 触发（§2.2） |
+| 涉及平台人员/组织/角色/字典字段 | ✅ 触发（§3.1）|
+| Code Review / PR 评审 | ✅ 触发 |
+
+---
+
+## §6 配套 skill 与文档
+
+| 类别 | 入口 | 内容 |
+|------|------|------|
+| **硬约束（本文件）** | `~/.claude/rules/meritdata-platform-domain-model-rules.md` | 5 节硬规则 + 触发场景 |
+| **操作指南** | `meritdata-platform-domain-model` skill | 业务建模方法论、聚合根设计、QueryDSL 联表 |
+| **数据边界硬约束** | `~/.claude/rules/meritdata-platform-data-boundary.md` | 4 条铁律（PF_ 表、Feign 装配、平台 Entity、异常掩盖）|
+| **命名规范硬约束** | `~/.claude/rules/naming-conventions-rules.md` | Java/类/方法/包/配置命名 |
+
+---
+
+## §7 反模式 vs 正模式速查
+
+| 反模式 | 正模式 | 触发章节 |
+|--------|--------|---------|
+| `CREATE TABLE T_LegacyOrder` | `CREATE TABLE t_legacy_order` | §1.1 |
+| 字段 `orderNo`（无 @Column 映射）| `@Column("order_no") private String orderNo;` | §1.1 |
+| 实体类 `t_purchase_order` | `PurchaseOrder` | §1.1 |
+| `WHERE applicant_name = '张三'` | `WHERE applicant_user_id = '10001'` | §2.1 |
+| 跨服务外键 `FOREIGN KEY ... REFERENCES service_b.t_user` | 应用层 ID 引用 + 应用服务编排 | §2.2 |
+| 主表叫 `T_LEGACY_ORDER`，新加 `T_LEGACY_ORDER_DETAIL` 也用大写 | 主表例外开关声明原因，新表/字段仍小写蛇形 | §1.2 |
+| 附件二进制存业务主表 | 业务附件关联表 + 平台上传组件 | §3.1 |
+| 业务状态与流程实例 ID 混用 | 业务状态独立字段，流程实例 ID 单独存储 | §3.1 |
+
+---
+
+## §8 与全局规则的关系
+
+| 现有 rule | 关系 |
+|----------|------|
+| `~/.claude/rules/meritdata-platform-data-boundary.md` | 本规则 §3.2、§4 与之协同；data-boundary 管"什么不能做"，本规则管"命名与关联" |
+| `~/.claude/rules/code-dev-rules.md` §八 | 软删除实体唯一性校验硬规则（详见该文件） |
+| `~/.claude/rules/naming-conventions-rules.md` | 实体类大驼峰、字段驼峰（与本规则 §1.1 表字段小写蛇形互补） |
+
+**优先级**：本规则与 `meritdata-platform-data-boundary.md` 同等优先级，专项规则优先于通用规则。
+
+---
+
+## §10 CI 校验命令（项目级可执行）
+
+### 10.1 检测大写表名（CREATE TABLE）
+
+```bash
+grep -rE 'CREATE TABLE [A-Z]' src/main/resources/ \
+  && echo "❌ 发现大写表名，违反 §1.1" \
+  && exit 1 \
+  || echo "✅ 未发现大写表名"
+```
+
+### 10.2 检测字段名大写驼峰（@Column 缺失）
+
+```bash
+# 检查实体类中无 @Column 注解的 private String 类型字段（驼峰疑似未映射）
+grep -rE 'private (String|Long|Integer) [a-z]+[A-Z]' src/main/java/ \
+  | grep -v '@Column' \
+  && echo "⚠️ 疑似字段未声明 @Column 映射，违反 §1.1" \
+  || echo "✅ 字段映射完整"
+```
+
+### 10.3 检测 PF_ 前缀引用
+
+```bash
+grep -rE 'CREATE TABLE PF_[A-Z]|@TableName\("PF_' src/main/ \
+  && echo "❌ 发现 PF_ 前缀引用，违反 §1.1（详见 data-boundary.md §1.1）" \
+  && exit 1 \
+  || echo "✅ 未发现 PF_ 引用"
+```
+
+### 10.4 检测姓名做关联键
+
+```bash
+# 在 WHERE/JOIN 中查找疑似姓名/组织名字段
+grep -rE 'WHERE.*(_name|_dept_name|_org_name)|ON.*\.(name|deptName|orgName)' src/main/resources/mapper/ \
+  && echo "⚠️ 疑似用姓名做关联键，请确认是否违反 §2.1（ID 关联为佳）" \
+  || echo "✅ 未发现姓名关联键"
+```
+
+### 10.5 检测跨服务数据库外键
+
+```bash
+# 检测跨服务外键（REFERENCES 指向其他 schema/service）
+grep -rE 'FOREIGN KEY.*REFERENCES.*\.(t_|service_)' src/main/resources/ \
+  | grep -v 'local_schema' \
+  && echo "❌ 发现跨服务外键，违反 §2.2" \
+  && exit 1 \
+  || echo "✅ 未发现跨服务外键"
+```
+
+### 10.6 检测实体类命名（小写实体类）
+
+```bash
+# 检查实体类类名以小写字母开头（应为大驼峰）
+grep -rE '^public class [a-z][a-zA-Z]*' src/main/java/ \
+  | grep -v 'package' \
+  && echo "❌ 发现小写实体类命名，违反 §1.1（大驼峰）" \
+  && exit 1 \
+  || echo "✅ 实体类命名符合大驼峰"
+```
+
+完整脚本（含反模式库）参考 `~/.claude/rules/meritdata-platform-data-boundary.md` §3 的模板。
+
+---
+
+## §9 版本与变更
+
+- v1.0（2026-09-04）：初版，从 `themes/meritdata-platform-domain-model/references/domain-model.md` 第 24、40 行硬约束抽取
+- 来源：domain-model.md §输出契约 第 24 行 + §平台语义路由 第 40 行
+
+后续变更通过 PR review，重大变更需架构组确认。