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

package/rules/README.md

@@ -0,0 +1,112 @@
+# pfsuite 系统级 Rules 索引
+
+> **抽取日期**：2026-09-04  
+> **入套件日期**：2026-09-08  
+> **最近治理**：2026-09-09（清理冗余 + 恢复 `coding-standards-rules.md` + 下放 6 个全局独有 rule）  
+> **来源**：研发侧 `rules/` v1.0（2026-08 收录） + 全局 `~/.claude/rules/` 兜底  
+> **范围**：18 个跨项目、跨团队的硬约束规则 + 1 个索引 README（**套件自包含**，复制即可用）
+
+---
+
+## 一、抽取原则
+
+1. **系统级**：抽取的是与具体业务无关的"硬约束/铁律"，不随项目变化
+2. **可独立引用**：每个 rules 文件可被 `CLAUDE.md` 单独引用
+3. **来源透明**：每个文件顶部有来源 banner，便于追溯
+4. **自包含**：套件复制到任意项目即可作为完整铁律源（不再依赖全局 `~/.claude/rules/`）
+
+---
+
+## 二、18 个 rules 清单
+
+### 2.1 通用开发类（12 个）
+
+| 文件 | 范围 | 触发条件 | 来源 |
+|------|------|---------|------|
+| `api-design-rules.md` | REST API | 设计接口、编写接口文档、Controller | 研发 v1.0 |
+| `code-dev-rules.md` | Java 代码（含 §八方法论铁律）| 编写 Java、功能模块开发 | 研发+石油 v1.0 |
+| `coding-standards-rules.md` | 通用编码 | 资源/集合/字符串/异常/并发/对象/日志 | 研发 v1.0（2026-09-09 从全局恢复） |
+| `frontend-coding-rules.md` | Vue/Element UI | 前端开发 | 研发 v1.0 |
+| `frontend-component-rules.md` | 前端组件交互 | 设计前端组件、Element UI | 研发 v1.0 |
+| `git-workflow-rules.md` | Git | 版本控制、分支/提交/合并 | 研发 v1.0 |
+| `nacos-rules.md` | Nacos | cloud_back 项目 Nacos 配置 | 研发 v1.0 |
+| `naming-conventions-rules.md` | 命名 | 类/方法/常量/变量/包/配置/文件命名 | 研发 v1.0 |
+| `performance-rules.md` | 性能 | DB/缓存/并发/大数据量/响应时间 | 研发 v1.0 |
+| `security-rules.md` | 安全 | 认证/传输/权限/敏感信息 | 研发 v1.0 |
+| `sql-naming-rules.md` | SQL 命名 | 表/字段/索引命名 | 研发 v1.0 |
+| `sql-script-rules.md` | SQL 脚本 | 编写 SQL、迁移、DML/DDL | 研发 v1.0 |
+
+### 2.2 MeritData 平台硬规则（2 个 + §八摘要）
+
+| 文件 | 范围 | 触发条件 | 来源 |
+|------|------|---------|------|
+| `meritdata-platform-data-boundary.md` | 数据边界 4 铁律（完整版） | 数据访问代码生成 / PR / CI 扫描 | 全局 `~/.claude/rules/`（2026-09-09 下放） |
+| `meritdata-platform-domain-model-rules.md` | 业务建模 5 硬规则（完整版） | 数据库表设计 / 实体类生成 / PR | 全局 `~/.claude/rules/`（2026-09-09 下放） |
+
+> **注 1**：`code-dev-rules.md` §八的 §8.1 / §8.2 是上面两份完整版的"摘要版"，方便快速查阅；完整版在同名文件。
+>
+> **注 2**：详细文档、反模式对比、根因分析、回归用例见 3 个 L2-M skill 的 `references/`：
+> - §8.1 data-boundary → `skills/meritdata-platform-data-boundary/references/`
+> - §8.2 domain-model → `skills/meritdata-platform-domain-model/references/`
+> - §8.3 code-spec → `skills/meritdata-platform-code-spec/references/`
+
+### 2.3 流程 & 文档类（4 个，2026-09-09 下放）
+
+| 文件 | 范围 | 触发条件 | 来源 |
+|------|------|---------|------|
+| `documentation-rules.md` | 文档规范 | 编写注释 / Javadoc / README / 接口文档 / 变更日志 | 全局 `~/.claude/rules/`（2026-09-09 下放） |
+| `requirement-dev-rules.md` | 需求开发 | 需求分析 / 设计 / 编写 PRD | 全局 `~/.claude/rules/`（2026-09-09 下放） |
+| `system-test-rules.md` | 系统测试设计 | 系统测试 / 集成测试 / UAT | 全局 `~/.claude/rules/`（2026-09-09 下放） |
+| `test-case-dev-rules.md` | 测试用例开发 | 单元测试 / 集成测试 / 开发者测试 | 全局 `~/.claude/rules/`（2026-09-09 下放） |
+
+---
+
+## 三、与 CLAUDE.md 集成方式
+
+在 `CLAUDE.md`（项目根目录）顶部加入：
+
+```markdown
+# 项目级 Rules（18 条铁律）
+## 通用开发类（12）
+- [API 设计规范](rules/api-design-rules.md)
+- [代码开发指南](rules/code-dev-rules.md)
+- [编码规范](rules/coding-standards-rules.md)
+- [Git 工作流](rules/git-workflow-rules.md)
+- [命名规范](rules/naming-conventions-rules.md)
+- [性能规范](rules/performance-rules.md)
+- [安全编码规范](rules/security-rules.md)
+- [Nacos 配置中心规范](rules/nacos-rules.md)
+- [SQL 命名规范](rules/sql-naming-rules.md)
+- [SQL 脚本提交规范](rules/sql-script-rules.md)
+- [前端编程规范](rules/frontend-coding-rules.md)
+- [前端组件和交互规范](rules/frontend-component-rules.md)
+
+## MeritData 平台硬规则（2 + §八摘要）
+- [数据边界硬规则](rules/meritdata-platform-data-boundary.md)
+- [业务建模硬规则](rules/meritdata-platform-domain-model-rules.md)
+
+## 流程 & 文档类（4）
+- [文档规范](rules/documentation-rules.md)
+- [需求开发指南](rules/requirement-dev-rules.md)
+- [系统测试设计指南](rules/system-test-rules.md)
+- [测试用例开发指南](rules/test-case-dev-rules.md)
+```
+
+---
+
+## 四、后续治理
+
+- **三方差异**：工业/石油侧如有冲突规则，合并到对应文件
+- **版本号**：每文件顶部加 `<!-- version: x.y.z -->` 记录升级
+- **CI 校验**：在 `tools/skill-vetter/validate.ps1` 中检测 `rules/` 文件的 frontmatter
+- **变更日志**：每文件底部加 `## 变更记录` 表格
+
+---
+
+## 五、清理记录
+
+| 日期 | 变更 |
+|------|------|
+| 2026-09-08 | 入套件（与项目级 `rules/` 字节相同） |
+| 2026-09-09 | **P0 治理**：①恢复 `coding-standards-rules.md`（从全局 92 行真实内容恢复，stub 已删除）②项目根的 `rules/` 与 `skills/` 因字节级冗余已删除，**唯一权威来源 = 套件 rules/** |
+| 2026-09-09 | **v2.6.3 自包含升级**：下放 6 个全局独有 rules 到套件（`meritdata-platform-data-boundary.md` / `meritdata-platform-domain-model-rules.md` / `documentation-rules.md` / `requirement-dev-rules.md` / `system-test-rules.md` / `test-case-dev-rules.md`），套件从 12 条铁律 → **18 条**，**复制即用、不再依赖全局**。同步更新 `code-dev-rules.md §8.1/§8.2` 引用路径指向套件内版本 |

package/rules/api-design-rules.md

@@ -0,0 +1,96 @@
+<!--
+来源：研发skills/rules v1.0（2026-08 收录）
+抽取到 pfsuite/rules：2026-09-04
+后续治理：合并三方意见后再升级
+-->
+
+
+# REST API 设计规范
+
+**触发条件**：设计REST API、编写接口文档、创建Controller时
+
+---
+
+## 一、URL 路径规范
+
+**必须执行**：
+- 使用名词而非动词：`/users` 而非 `/getUsers`
+- 使用复数形式：`/users` 而非 `/user`
+- 使用小写和连字符：`/user-profiles` 而非 `/userProfiles`
+- 嵌套资源表示层级：`/users/{id}/orders`
+- 版本控制：`/api/v1/users`
+
+**禁止执行**：
+- URL中不能包含文件扩展名（.json等）
+- 不能使用动词命名接口
+
+---
+
+## 二、HTTP 方法规范
+
+**必须执行**：
+- GET：查询资源（幂等，不修改数据）
+- POST：创建资源（非幂等）
+- PUT：更新资源（幂等，完全替换）
+- PATCH：部分更新资源（非幂等）
+- DELETE：删除资源（幂等）
+
+---
+
+## 三、请求 & 响应规范
+
+**必须执行**：
+- 请求参数使用 `application/json`
+- 分页参数统一：`page`、`size`、`sort`
+- 时间格式使用 ISO 8601：`2024-01-15T10:30:00Z`
+- 响应包装：`{ "code": 200, "data": ..., "message": "success" }`
+- 错误响应包含错误码、消息、详情
+
+**禁止执行**：
+- 不能在URL中传递敏感信息
+- 不能返回明文密码、token等敏感数据
+
+---
+
+## 四、状态码规范
+
+**必须执行**：
+| 状态码 | 用途 |
+|--------|------|
+| 200 | 成功 |
+| 201 | 创建成功 |
+| 204 | 删除成功，无返回内容 |
+| 400 | 请求参数错误 |
+| 401 | 未认证 |
+| 403 | 无权限 |
+| 404 | 资源不存在 |
+| 409 | 资源冲突 |
+| 500 | 服务器内部错误 |
+
+---
+
+## 五、版本管理
+
+**必须执行**：
+- URL路径中包含版本号：`/api/v1/`
+- 不兼容的变更必须升级版本
+- 旧版本提供合理的过渡期
+- 废弃版本明确标注废弃时间
+
+---
+
+## 六、文档规范
+
+**必须执行**：
+- 使用 OpenAPI/Swagger 文档
+- 文档包含接口说明、参数说明、返回值说明
+- 文档包含错误码说明
+- 文档包含调用示例
+
+---
+
+## 重要提醒
+
+- REST API 是公开契约，保持稳定性
+- 错误消息不能泄露内部实现细节
+- 分页、排序、过滤参数要统一

package/rules/code-dev-rules.md

@@ -0,0 +1,167 @@
+<!--
+来源：研发skills/rules v1.0（2026-08 收录）
+抽取到 pfsuite/rules：2026-09-04
+后续治理：合并三方意见后再升级
+-->
+
+
+# 代码开发指南
+
+**触发条件**：编写Java代码、开发功能模块时
+
+---
+
+## 一、结构规范
+
+**必须执行**：
+- 代码通过编码规约扫描
+- 类名、方法名符合命名规范
+- 删除无用的代码、日志、临时代码
+- 合理引用三方库，避免重复造轮子
+- 使用设计模式时确保理解其意图
+
+**禁止执行**：
+- 不能有未被调用的代码（死代码）
+- 不能有能被复用代码重复实现的逻辑
+- 不能有过于复杂的模块（需要拆分）
+
+---
+
+## 二、SQL 安全
+
+**必须执行**：
+- 使用预编译语句（PreparedStatement）
+- SQL拼接时对用户输入进行严格校验
+- like过滤时对 `_%` 进行特殊处理
+- 禁止字符串拼接SQL
+
+---
+
+## 三、资源管理
+
+**必须执行**：
+- 使用 try-with-resources 关闭流、连接、Channel
+- 文件读取前检查是文件而非文件夹
+- 关闭顺序与开启顺序相反
+
+**禁止执行**：
+- 禁止在finally中抛出异常
+- 禁止关闭连接后继续使用
+
+---
+
+## 四、流程控制
+
+**必须执行**：
+- 循环必须有明确的结束条件
+- 必要的业务处理后通过 break 跳出
+- if判断业务逻辑要完整
+- 通过 return 减少不必要的逻辑判断
+
+**禁止执行**：
+- 禁止在循环内调用数据库、Redis、HTTP等外部资源
+- 禁止无限循环
+
+---
+
+## 五、异常处理
+
+**必须执行**：
+- 验证导入数据和输入参数的正确性、完整性
+- 进行准确合理的空指针判断
+- 异常捕获、处理、抛出要合理
+- 接口调用要进行超时处理
+
+**禁止执行**：
+- 禁止空的catch块
+- 禁止吞掉异常不处理
+
+---
+
+## 六、敏感信息
+
+**必须执行**：
+- 敏感信息在日志中必须脱敏
+- 禁止在日志中打印密码、token、keytab
+- 禁止在代码中硬编码密码或密钥
+
+---
+
+## 七、数据库设计
+
+**必须执行**：
+- 表名、列名大写，长度小于30
+- 插入数据满足列的大小约束
+- Redis缓存要有过期策略
+
+---
+
+## 八、方法论铁律（双轨制：rules 摘要 + skill 详细）
+
+> **双轨制原则**：本节是"铁律摘要"，自动随 rules 加载生效；完整文档、反模式对比、根因分析、回归用例 见对应 skill 的 references/。详情见 `meritdata-platform-code-spec`、`meritdata-platform-data-boundary`、`meritdata-platform-domain-model` 三个 L2 方法论 skill。
+
+### 8.1 数据访问边界（data-boundary）
+
+**铁律 4 条**（完整版见 [`meritdata-platform-data-boundary.md`](./meritdata-platform-data-boundary.md)）：
+
+- 🔴 **不映射 `PF_` 前缀平台表**：二开库禁止 `@TableName("PF_*")` / 跨库 JOIN / 直连平台数据库
+- 🔴 **不分页循环逐条 Feign**：必须一次 Feign 批量装配 + 内存 join，禁止 `for + userClient.getById`
+- 🔴 **不复制平台 Entity/Repository**：独立部署场景下禁止 `import com.meritdata.cloud.platform.entity.*`
+- 🔴 **不掩盖平台故障**：禁止 `catch (Exception) { return Collections.emptyList(); }`，必须显式上抛
+
+### 8.2 业务建模规则（domain-model）
+
+**铁律 4 条**（完整版见 [`meritdata-platform-domain-model-rules.md`](./meritdata-platform-domain-model-rules.md)）：
+
+- 🔴 **二开业务表/字段必须小写蛇形**：`t_purchase_order`、`order_no`；实体类大驼峰 + `@Column` 显式映射
+- 🔴 **不得把人员/组织名称作为唯一关联键**：必须用稳定 `*_user_id` / `*_dept_id`，名称仅作冗余快照
+- 🔴 **跨服务禁止数据库外键**：通过应用层维护一致性，禁止 `FOREIGN KEY REFERENCES other_service.t_*`
+- 🔴 **唯一性校验必须穿透软删除**（见 §8.3）：`nativeQuery + findXxxIncludingDeleted` 穿透 `@Where`
+
+### 8.3 code-spec 补充铁律（编码层）
+
+**软删除实体**（核心反模式，根因：DB 唯一约束含软删除记录 + JPQL 受 `@Where` 过滤 → INSERT 500）：
+
+- ✅ 唯一性校验 `findXxxNo` 必须用 `findXxxIncludingDeleted`（`nativeQuery = true`）
+- ✅ 编号生成器"查已用编号"必须用 `findAllNosStartingWithIncludingDeleted`
+- ✅ 业务查询 / 全量查询必须**成对出现**（业务查询无后缀、全量查询 `IncludingDeleted` 后缀）
+
+**循环与外部资源**（重复 §四，再强调）：
+
+- 🔴 禁止 `for` 内调用 DB / Redis / HTTP / Feign
+- ✅ 必须批量查询 + 内存 join
+
+**异常处理**（重复 §五，再强调）：
+
+- 🔴 禁止空 catch / 吞异常（`return Collections.emptyList()` 是不掩盖的反例）
+- ✅ 必须 `throw new ServiceException("CODE", "msg", e)` 上抛 + 上下文
+
+**敏感信息**（重复 §六，再强调）：
+
+- 🔴 禁止日志打印 password / token / keytab / principal
+- ✅ 必须脱敏后打印（手机号、身份证、银行卡号）
+
+**架构层**：
+
+- 🔴 Controller / Service / Dao 层禁止有成员变量（除注解和常量）——避免线程安全问题
+- 🔴 Shell 脚本必须使用 Linux 换行符（`\n`，非 `\r\n`）——避免 Windows 部署脚本执行失败
+
+### 8.4 与 skill 的协作
+
+```
+[自动加载] rules 本节 → 所有 skill 都受硬约束
+    ↓ 开发者问"为什么这样" / "完整例子"
+[触发] 对应 skill（code-spec / data-boundary / domain-model）→ 加载 references/anti-patterns.md
+    ↓ 提交前
+[校验] skill 的 references/validate-rules.md 给出 CI 命令
+```
+
+---
+
+## 重要提醒
+
+- 循环内禁止调用外部资源
+- 任何密码等敏感信息严禁打印到日志
+- Controller/Service/Dao层禁止有成员变量（除注解和常量）
+- Shell脚本必须使用Linux换行符
+- **方法论铁律更新先改本 rules，再同步 skill 的 references/**（保证两边一致）

package/rules/coding-standards-rules.md

@@ -0,0 +1,99 @@
+<!--
+来源：研发skills/rules v1.0（2026-08 收录）
+抽取到 pfsuite/rules：2026-09-04
+合并入套件：2026-09-08
+修复说明：v2.6.x 抽取时丢失全部正文（仅留 198 字节 TODO stub），从全局 `~/.claude/rules/coding-standards-rules.md` 恢复 92 行真实内容。
+-->
+
+# 编码规范
+
+**触发条件**：编写Java代码、开发功能模块时
+
+---
+
+## 一、资源管理
+
+**必须执行**：
+- 使用 `try-with-resources` 自动关闭资源
+- 关闭顺序与开启顺序相反
+- 文件读取前检查是文件而非文件夹
+
+**禁止执行**：
+- 禁止在 `finally` 块中抛出异常
+- 禁止关闭连接后继续使用
+
+**正确示例**：
+```java
+try (InputStream in = new FileInputStream(file);
+     BufferedReader reader = new BufferedReader(new InputStreamReader(in))) {
+    // 使用 reader
+} // 自动关闭
+```
+
+---
+
+## 二、集合处理
+
+**必须执行**：
+- 创建集合时指定初始容量：`new ArrayList<>(16)`、`new HashMap<>(16)`
+- 方法返回集合时，**返回空集合而非 null**：`return Collections.emptyList()`
+- 判断集合为空使用 `isEmpty()` 而非 `size() == 0`
+- 使用 `CollectionUtils.isEmpty()` 判断 null 或空
+
+---
+
+## 三、字符串处理
+
+**必须执行**：
+- `equals` 比较时，**常量写在前面**：`"constant".equals(str)`
+- 避免不必要的字符串拼接，优先使用 StringBuilder
+- 拼接路径时使用 `/` 或 `Paths.get()`，避免硬编码分隔符
+
+---
+
+## 四、异常处理
+
+**必须执行**：
+- 异常信息**脱敏后再记录日志**（移除 password、keytab、principal 等）
+- 使用自定义异常类 + 错误码，不直接暴露 JDK 异常
+- 接口调用要进行超时处理
+
+**禁止执行**：
+- 禁止空的 catch 块
+- 禁止吞掉异常不处理
+
+---
+
+## 五、并发处理
+
+**必须执行**：
+- 线程池使用 `Executors` 工厂方法创建后，务必指定队列大小
+- 使用 `RateLimiter` 限流时设置合理的 QPS
+- 缓存 key **必须包含用户标识**实现用户隔离：`userId:appId`
+
+---
+
+## 六、对象创建
+
+**禁止执行**：
+- 禁止在循环内创建大对象引用
+- 禁止在循环内调用外部资源（数据库、Redis、HTTP）
+
+---
+
+## 七、日志规范
+
+**必须执行**：
+- 使用 SLF4J 日志门面
+- 日志级别：`ERROR`（业务异常）、`WARN`（降级处理）、`INFO`（关键流程）、`DEBUG`（调试）
+
+**禁止执行**：
+- **禁止记录敏感信息**：password、keytab、principal、token
+
+---
+
+## 重要提醒
+
+- 资源必须及时关闭，否则会导致连接泄漏
+- 用户输入永远不可信，必须校验
+- 敏感信息最小化原则：只收集必要的信息

package/rules/documentation-rules.md

@@ -0,0 +1,102 @@
+<!--
+来源：全局 ~/.claude/rules/documentation-rules.md v1.0（2026-04 起累计）
+下放到套件：2026-09-09（v2.6.3）
+后续治理：套件内自包含权威版本；全局版可作为兜底但优先以本文件为准
+-->
+
+# 文档规范
+
+**触发条件**：编写代码注释、Javadoc、README、技术文档时
+
+---
+
+## 一、代码注释
+
+**必须执行**：
+- 注释解释"为什么"，不解释"是什么"（代码本身已说明）
+- 复杂业务逻辑添加注释说明
+- 关键决策和技术选型添加注释
+- TODO/FIXME要标注负责人和日期
+
+**禁止执行**：
+- 禁止注释描述明显的代码
+- 禁止注释掉的代码不删除
+- 禁止中文拼音注释
+- 禁止过时或错误的注释
+
+---
+
+## 二、Javadoc 规范
+
+**必须执行**：
+- 公开API必须添加Javadoc
+- @param/@return/@throws要完整
+- 方法说明要包含：功能、参数含义、返回值、异常
+- 包含作者和版本信息（可选）
+
+**示例**：
+```java
+/**
+ * 根据用户ID查询用户信息
+ *
+ * @param userId 用户ID，不能为空
+ * @return 用户信息，不存在返回null
+ * @throws IllegalArgumentException userId为空时抛出
+ */
+User getUserById(String userId);
+```
+
+---
+
+## 三、README 规范
+
+**必须执行**：
+- 项目简介：一句话说明项目做什么
+- 快速开始：环境要求、安装步骤、运行方法
+- 目录结构：说明各目录用途
+- 配置说明：主要配置项及说明
+- 常见问题：FAQ
+
+**禁止执行**：
+- README不能太长（超过500行要拆分）
+- 不能包含过时信息
+
+---
+
+## 四、接口文档
+
+**必须执行**：
+- 说明接口功能
+- 列出所有参数（含类型、是否必填、含义）
+- 说明返回值（含成功和错误情况）
+- 提供调用示例
+- 说明错误码
+
+---
+
+## 五、变更日志
+
+**必须执行**：
+- 版本号使用语义化版本（SemVer）
+- 说明每个版本的变化
+- 包含Breaking Changes说明
+- 标注发布日期
+
+---
+
+## 六、技术文档
+
+**必须执行**：
+- 架构图要清晰展示组件和关系
+- 流程图展示关键流程
+- 序列图展示调用顺序
+- 数据库设计说明表关系
+
+---
+
+## 重要提醒
+
+- 文档和代码要同步更新
+- 过时文档比没文档更危险
+- 好的文档是给未来自己和其他人看的
+- 图表比文字更容易理解复杂系统

package/rules/frontend-coding-rules.md

@@ -0,0 +1,128 @@
+<!--
+来源：研发skills/rules v1.0（2026-08 收录）
+抽取到 pfsuite/rules：2026-09-04
+后续治理：合并三方意见后再升级
+-->
+
+# 前端编程规范
+
+**触发条件**：编写Vue/Element UI前端代码、开发前端功能模块时
+
+---
+
+## 一、Vue 2 开发规范
+
+**必须执行**：
+- 使用Vue 2.6.10 + Element UI
+- 组件文件采用PascalCase命名：`UserDialog.vue`
+- 组件内部样式使用scoped隔离
+- 使用watch和computed合理分工
+- 路由跳转使用name而非path
+
+**禁止执行**：
+- 禁止在mounted中进行异步数据获取后不处理loading状态
+- 禁止在组件内部修改props值
+- 禁止使用v-html渲染不可信内容
+
+---
+
+## 二、组件规范
+
+**必须执行**：
+- 组件拆分保持单一职责
+- 公共组件放在`cloud-module`目录
+- 使用props进行父子通信
+- 使用$emit进行事件传递
+- 合理使用slot分发内容
+
+**禁止执行**：
+- 组件层级不能超过5层
+- 单个组件不能超过500行
+- 禁止在template中使用复杂计算
+
+---
+
+## 三、状态管理
+
+**必须执行**：
+- 全局状态使用Vuex管理
+- 每个module单独管理对应状态
+- mutation必须同步操作
+- action可以包含异步操作
+- 页面级状态使用组件内部data
+
+**禁止执行**：
+- 禁止跨模块直接修改state
+- 禁止在mutation中执行异步操作
+
+---
+
+## 四、样式规范
+
+**必须执行**：
+- 使用BEM命名规范：`.block__element--modifier`
+- 公共样式放在`assets/styles`
+- 使用CSS变量管理主题色
+- 响应式布局使用flex/grid
+- 样式文件不超过300行
+
+**禁止执行**：
+- 禁止使用!important覆盖组件样式
+- 禁止使用行内样式（动态样式除外）
+- 禁止使用calc嵌套过深
+
+---
+
+## 五、API调用规范
+
+**必须执行**：
+- 使用axios封装请求拦截器
+- 统一处理错误和loading状态
+- 请求方法统一使用async/await
+- 接口按模块划分文件
+- 敏感参数放在请求头
+
+**禁止执行**：
+- 禁止在组件内直接调用API
+- 禁止硬编码接口地址
+- 禁止在请求中暴露敏感信息
+
+---
+
+## 六、性能优化
+
+**必须执行**：
+- 使用v-show替代v-if处理频繁切换
+- 使用Object.freeze冻结静态数据
+- 合理使用keep-alive缓存组件
+- 图片懒加载使用v-lazy
+- 路由懒加载使用动态import
+
+**禁止执行**：
+- 禁止在template中使用过长的v-for
+- 禁止在watch中使用$watch
+- 禁止大数据渲染不使用虚拟滚动
+
+---
+
+## 七、代码质量
+
+**必须执行**：
+- ESLint + Prettier代码规范
+- 提交前运行lint检查
+- 关键逻辑添加注释
+- 使用ES6+语法
+- 模块导出使用export default
+
+**禁止执行**：
+- 禁止console.log提交到代码库
+- 禁止使用var声明变量
+- 禁止使用未定义的变量
+
+---
+
+## 重要提醒
+
+- Vue组件是响应式系统，保持数据流单向
+- 组件拆分要平衡粒度，避免过度抽象
+- 样式隔离使用scoped，防止污染全局