npm - @alanwang-merit/meritdata-platform-skill-package - Versions diffs - 1.0.10 → 1.0.11 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (631) hide show

package/skills/code-low-level-check/references//344/273/243/347/240/201/344/275/216/347/272/247/351/227/256/351/242/230/346/243/200/346/237/245/346/212/245/345/221/212/346/250/241/346/235/277.md DELETED Viewed

@@ -1,242 +0,0 @@
-# 代码低级问题检查报告 — [项目名]
-**检查对象**：[代码模块/文件路径] V1.0
-**检查日期**：YYYY-MM-DD
-**检查人员**：[开发者/评审人员 姓名]
-**检查视角**：专业开发者
-**当前检查轮次**：V[N]
----
-## 检查迭代历史
-### 迭代概览
-| 轮次 | 检查日期 | 代码版本 | 发现问题数 | 新增问题 | 已解决 | 待解决 | 检查结论 |
-|------|----------|----------|------------|----------|--------|--------|----------|
-| V1 | YYYY-MM-DD | V0.1 | __ | __ | 0 | __ | 通过/有保留通过/不通过 |
-| V2 | YYYY-MM-DD | V0.2 | __ | __ | __ | __ | 通过/有保留通过/不通过 |
-| V3 | YYYY-MM-DD | V0.3 | __ | __ | __ | __ | 通过/有保留通过/不通过 |
-| ... | ... | ... | ... | ... | ... | ... | ... |
-### V1 检查详情（YYYY-MM-DD）
-#### 检查范围
-- 代码版本：V0.1
-- 检查人员：xxx
-- 检查耗时：xx 分钟
-#### 关键发现（按重要性排序）
-| # | 重要性 | 类别 | 位置 | 问题 | 建议 | 修复状态 |
-|---|--------|------|------|------|------|----------|
-| 1 | 高 | xxx | 文件:行号 | xxx | xxx | 待修复 |
-| 2 | 中 | xxx | xxx | xxx | xxx | 待修复 |
-| 3 | 低 | xxx | xxx | xxx | xxx | 待修复 |
-| ... | ... | ... | ... | ... | ... | ... |
-#### V1 结论
-- 检查结论：通过 / 有保留通过 / 不通过
-- 严重问题：__ 个
-- 一般问题：__ 个
-- 建议项：__ 个
-### V2 检查详情（YYYY-MM-DD）
-#### 检查范围
-- 代码版本：V0.2
-- 检查人员：xxx
-- 检查耗时：xx 分钟
-- 修订说明：开发者根据 V1 反馈进行修改，提交 V0.2
-#### V1 问题修复追踪
-| V1 # | 重要性 | 类别 | 问题 | 修复状态 | 修复说明 |
-|------|--------|------|------|----------|----------|
-| 1 | 高 | xxx | xxx | 已解决/未解决/遗留 | xxx |
-| 2 | 中 | xxx | xxx | 已解决/未解决/遗留 | xxx |
-| 3 | 低 | xxx | xxx | 已解决/未解决/遗留 | xxx |
-| ... | ... | ... | ... | ... | ... | ... |
-**V1 修复统计**：
-- 已解决：__ / __ 个
-- 未解决：__ / __ 个
-- 回归问题：__ 个
-#### V2 新发现问题
-| # | 重要性 | 类别 | 位置 | 问题 | 建议 | 修复状态 |
-|---|--------|------|------|------|------|----------|
-| 1 | 高 | xxx | xxx | xxx | xxx | 待修复 |
-| 2 | 中 | xxx | xxx | xxx | xxx | 待修复 |
-#### 各类别变化对比
-| 类别 | V1 问题数 | V2 问题数 | 变化说明 |
-|------|-----------|-----------|----------|
-| 命名规范 | __ | __ | 减少/不变/增加 |
-| 代码风格 | __ | __ | 减少/不变/增加 |
-| 注释和日志 | __ | __ | 减少/不变/增加 |
-| 错误处理 | __ | __ | 减少/不变/增加 |
-| 资源管理 | __ | __ | 减少/不变/增加 |
-| 性能 | __ | __ | 减少/不变/增加 |
-| 安全 | __ | __ | 减少/不变/增加 |
-| SQL/数据库 | __ | __ | 减少/不变/增加 |
-| 前端代码 | __ | __ | 减少/不变/增加 |
-| 工程化 | __ | __ | 减少/不变/增加 |
-#### V2 结论
-- 检查结论：通过 / 有保留通过 / 不通过
-- 严重问题：__ 个
-- 一般问题：__ 个
-- 建议项：__ 个
-### V3 检查详情（YYYY-MM-DD）
-> 按相同格式记录
-### 跨轮次问题汇总
-#### 持续未决问题（跨多轮未解决）
-| 原始轮次 | # | 重要性 | 类别 | 位置 | 问题 | 已迭代轮次 | 处理建议 |
-|----------|---|--------|------|------|------|-----------|----------|
-| V1 | 1 | 高 | xxx | 文件:行号 | xxx | V1, V2, V3 | 升级处理/放弃修复 |
-| ... | ... | ... | ... | ... | ... | ... | ... |
-#### 回归问题（已解决后再次出现）
-| 原始 # | 问题 | 解决轮次 | 回归轮次 | 说明 |
-|--------|------|----------|----------|------|
-| V1-3 | xxx | V2 | V3 | xxx |
-| ... | ... | ... | ... | ... |
----
-## 一、总体判定
-**[通过 / 有保留通过 / 不通过]**
-**核心结论**：
-- 完备项：xxx
-- 缺失项：xxx
-- 建议：xxx
----
-## 二、检查总览（基于当前轮次）
-| 类别 | 发现问题数 | 严重 | 一般 | 建议 | 原始轮次 |
-|------|-----------|------|------|------|----------|
-| 命名规范 | __ | __ | __ | __ | V[N] |
-| 代码风格 | __ | __ | __ | __ | V[N] |
-| 注释和日志 | __ | __ | __ | __ | V[N] |
-| 错误处理 | __ | __ | __ | __ | V[N] |
-| 资源管理 | __ | __ | __ | __ | V[N] |
-| 性能 | __ | __ | __ | __ | V[N] |
-| 安全 | __ | __ | __ | __ | V[N] |
-| SQL/数据库 | __ | __ | __ | __ | V[N] |
-| 前端代码 | __ | __ | __ | __ | V[N] |
-| 工程化 | __ | __ | __ | __ | V[N] |
-| **其他维度** | __ | __ | __ | __ | V[N] |
-| **合计** | **__** | **__** | **__** | **__** | — |
-> 说明：10 大类详细检查项见 `references/代码低级问题检查清单.md`
----
-## 三、严重问题（基于当前轮次）
-| # | 类别 | 位置 | 问题描述 | 建议修改 | 原始轮次 |
-|---|------|------|----------|----------|----------|
-| 1 | xxx | 文件:行号 | xxx | xxx | V[N] |
-| 2 | xxx | xxx | xxx | xxx | V[N] |
----
-## 四、一般问题（基于当前轮次）
-| # | 类别 | 位置 | 问题描述 | 建议修改 | 原始轮次 |
-|---|------|------|----------|----------|----------|
-| 1 | xxx | xxx | xxx | xxx | V[N] |
-| 2 | xxx | xxx | xxx | xxx | V[N] |
----
-## 五、建议项（基于当前轮次）
-| # | 类别 | 位置 | 问题描述 | 建议修改 | 原始轮次 |
-|---|------|------|----------|----------|----------|
-| 1 | xxx | xxx | xxx | xxx | V[N] |
-| 2 | xxx | xxx | xxx | xxx | V[N] |
----
-## 六、按类别详细问题
-> 按需填写，只记录有缺失项的类别。
-### 6.X [类别名称]
-#### 问题 1
-- **问题描述**：xxx
-- **影响**：xxx
-- **建议修改**：xxx
----
-（可按需复制 6.X 章节，添加更多类别）
----
-## 七、常见低级错误 Top 10
-| # | 错误类型 | 状态 |
-|---|---------|------|
-| 1 | 字符串拼接 SQL | 出现/未出现 |
-| 2 | 空 catch 块 | 出现/未出现 |
-| 3 | 资源未关闭 | 出现/未出现 |
-| 4 | 密码硬编码 | 出现/未出现 |
-| 5 | 敏感信息日志 | 出现/未出现 |
-| 6 | 循环中查询数据库 | 出现/未出现 |
-| 7 | 未做空指针判断 | 出现/未出现 |
-| 8 | 魔法数字 | 出现/未出现 |
-| 9 | SELECT * 查询 | 出现/未出现 |
-| 10 | 未使用 try-with-resources | 出现/未出现 |
-> 完整 Top 30 见 `references/代码低级问题检查清单.md`
----
-## 八、结论
-- ✅ **通过**（无严重问题）
-- ⚠️ **有保留通过**（一般问题 ≤ 5 个）
-- ❌ **不通过**（严重问题 ≥ 1 个）
-**本检查结论**：[通过/有保留通过/不通过]
-**迭代历史总结**：
-- 共经历 N 轮检查
-- 累计发现问题 __ 个
-- 已解决问题 __ 个
-- 遗留问题 __ 个
----
-## 九、改进建议
-1. xxx
-2. xxx
-3. xxx
----
-**检查人**：xxx
-**检查日期**：YYYY-MM-DD

package/skills/code-low-level-check/references//344/273/243/347/240/201/344/275/216/347/272/247/351/227/256/351/242/230/346/243/200/346/237/245/346/270/205/345/215/225.md DELETED Viewed

@@ -1,353 +0,0 @@
-# 代码低级问题检查清单
-> ⚠️ **重要**：本清单仅作为参考框架，**开发者应发散性识别更多低级问题**，不局限于固定类别。
-本清单覆盖开发代码中常见的低级问题，分为 **10 大类 80+ 项**，用于在正式代码评审前发现明显的低级错误。
----
-## 一、命名规范问题
-### 1.1 类/方法/变量命名
-- [ ] 类名不符合 PascalCase 规范
-- [ ] 方法名不符合 camelCase 规范
-- [ ] 常量未使用全大写下划线
-- [ ] 变量名使用拼音或无意义缩写（如 `yonghu`、`a1`、`tmp`）
-- [ ] 命名包含类型前缀（如 `strName`、`iCount`）
-- [ ] 命名出现下划线开头或结尾
-- [ ] 命名中出现数字编号（如 `data1`、`data2`）
-- [ ] 命名含义不清（如 `do`、`handle`）
-- [ ] 抽象类未使用 Abstract 前缀
-- [ ] 接口未使用 I 前缀（Java/C# 风格）
-### 1.2 包/目录命名
-- [ ] 包名包含大写字母
-- [ ] 包名过长或含义不清
-- [ ] 目录结构混乱（如按类型而非业务）
----
-## 二、代码风格问题
-### 2.1 格式规范
-- [ ] 缩进不一致（Tab vs Space）
-- [ ] 大括号风格不一致
-- [ ] 行长度超过规范（如 120 字符）
-- [ ] 文件末尾有多余空行
-- [ ] 运算符前后空格不一致
-- [ ] 命名空间/包声明顺序不规范
-### 2.2 代码结构
-- [ ] 方法过长（> 50 行）
-- [ ] 类过大（> 500 行）
-- [ ] 嵌套层级过深（> 4 层）
-- [ ] 圈复杂度过高（> 10）
-- [ ] if/else 嵌套过多
-- [ ] 重复代码块未抽取
-- [ ] 硬编码字符串/数字（魔法数字）
-- [ ] 长方法未拆分
----
-## 三、注释和日志问题
-### 3.1 注释问题
-- [ ] 缺少必要的注释说明
-- [ ] 注释与代码不同步（过时）
-- [ ] 注释使用错误的格式（如 Javadoc 格式错误）
-- [ ] 注释解释"是什么"而非"为什么"
-- [ ] 注释中存在敏感信息
-- [ ] 注释是中文拼音
-- [ ] TODO/FIXME 未标注负责人和日期
-- [ ] 类/方法缺少必要的 Javadoc
-### 3.2 日志问题
-- [ ] 缺少必要的日志记录
-- [ ] 日志级别使用不当（DEBUG 用于生产）
-- [ ] 日志打印敏感信息（密码、token、身份证）
-- [ ] 日志格式不统一
-- [ ] 日志缺少关键上下文（traceId、userId）
-- [ ] 异常日志缺少堆栈信息
-- [ ] 使用 System.out.println 而非日志框架
-- [ ] 日志拼接字符串而非使用占位符
----
-## 四、错误处理问题
-### 4.1 异常处理
-- [ ] 空的 catch 块（catch 后无处理）
-- [ ] 吞掉异常不处理
-- [ ] catch 后仅打印日志不处理
-- [ ] 捕获过于宽泛的异常（如 Exception）
-- [ ] 不应在 finally 中抛出异常
-- [ ] finally 中有关闭连接等资源
-- [ ] 异常类型使用不当（RuntimeException 滥用）
-- [ ] 未处理 InterruptedException
-### 4.2 错误码/返回值
-- [ ] 错误码未统一管理（魔法错误码）
-- [ ] 返回值含义不清（null/-1/0）
-- [ ] 错误码定义重复
-- [ ] 错误码未文档化
-### 4.3 防御性编程
-- [ ] 未做空指针判断
-- [ ] 未做边界检查（数组越界、空集合）
-- [ ] 未做参数校验
-- [ ] 未做类型转换异常处理
-- [ ] 缺少输入校验
-- [ ] 未对外部输入做编码检查
----
-## 五、资源管理问题
-### 5.1 连接/流关闭
-- [ ] 数据库连接未关闭
-- [ ] 文件流未关闭
-- [ ] HTTP 连接未关闭
-- [ ] 未使用 try-with-resources
-- [ ] 关闭顺序错误
-- [ ] 关闭后继续使用
-### 5.2 锁/线程
-- [ ] 锁未释放（finally 中释放）
-- [ ] 死锁风险
-- [ ] 线程池未优雅关闭
-- [ ] 共享变量未保护
-- [ ] ThreadLocal 未清理
-### 5.3 内存管理
-- [ ] 大对象未及时释放
-- [ ] 静态集合持有大对象（内存泄漏）
-- [ ] 缓存无过期策略
-- [ ] 未关闭的资源监听器
----
-## 六、性能问题
-### 6.1 数据库性能
-- [ ] 循环中执行 SQL
-- [ ] 未使用索引的查询
-- [ ] SELECT * 查询
-- [ ] N+1 查询问题
-- [ ] 大事务问题
-- [ ] 未使用批量操作
-- [ ] 连接池配置不当
-### 6.2 代码性能
-- [ ] 字符串拼接使用 + 而非 StringBuilder
-- [ ] 循环中重复计算
-- [ ] 不必要的对象创建
-- [ ] 大数据量未分页/分批
-- [ ] 同步锁粒度过大
-- [ ] 频繁的 IO 操作
-- [ ] 不合理的递归（栈溢出风险）
-### 6.3 缓存问题
-- [ ] 缓存未设置过期时间
-- [ ] 缓存 key 设计不合理
-- [ ] 缓存与数据库不一致
-- [ ] 缓存击穿/穿透/雪崩未防护
-- [ ] 大 key/热 key 问题
----
-## 七、安全问题
-### 7.1 注入防护
-- [ ] SQL 注入（字符串拼接）
-- [ ] NoSQL 注入
-- [ ] 命令注入（Shell 命令拼接）
-- [ ] LDAP 注入
-- [ ] XPath 注入
-### 7.2 数据安全
-- [ ] 敏感信息硬编码（密码、密钥）
-- [ ] 敏感信息在日志中明文
-- [ ] 密码未加密存储
-- [ ] 个人信息未脱敏
-- [ ] 错误信息泄露内部细节（堆栈、SQL）
-- [ ] 不安全的随机数（Random 用于安全场景）
-- [ ] 硬编码密钥/Token
-### 7.3 接口安全
-- [ ] 缺少权限校验
-- [ ] 缺少水平越权防护
-- [ ] 缺少垂直越权防护
-- [ ] 缺少接口鉴权
-- [ ] 缺少防重放攻击
-- [ ] 缺少防 CSRF
-- [ ] 缺少防 XSS（前端）
-- [ ] 缺少输入长度限制
-### 7.4 加密与密钥
-- [ ] 使用弱加密算法（MD5、SHA1）
-- [ ] 加密密钥硬编码
-- [ ] 密钥未定期轮换
-- [ ] 未使用 HTTPS
-- [ ] 敏感数据传输未加密
----
-## 八、SQL/数据库问题
-### 8.1 SQL 编写
-- [ ] 使用 SELECT *
-- [ ] 缺少 WHERE 条件的 UPDATE/DELETE
-- [ ] 隐式类型转换导致索引失效
-- [ ] 子查询过多（应使用 JOIN）
-- [ ] ORDER BY 未使用索引
-- [ ] 大表 COUNT 全部数据
-- [ ] 缺少 LIMIT 限制
-### 8.2 事务管理
-- [ ] 事务范围过大
-- [ ] 事务中包含外部调用
-- [ ] 未处理事务回滚
-- [ ] 嵌套事务未考虑传播行为
-### 8.3 数据库设计
-- [ ] 缺少必要的索引
-- [ ] 主键设计不当（如 UUID 性能）
-- [ ] 缺少时间戳字段
-- [ ] 缺少版本号字段（乐观锁）
-- [ ] 缺少逻辑删除标识
-- [ ] 大字段使用不当
----
-## 九、前端代码问题
-### 9.1 JavaScript/TypeScript
-- [ ] 使用 var 而非 let/const
-- [ ] 未处理的 Promise rejection
-- [ ] 回调地狱
-- [ ] 未使用 TypeScript 严格模式
-- [ ] 滥用 any 类型
-- [ ] 未处理的异步错误
-### 9.2 Vue/React 组件
-- [ ] 组件过大（> 200 行）
-- [ ] 缺少 props 校验
-- [ ] 缺少 key 导致列表渲染问题
-- [ ] 直接修改 props
-- [ ] 缺少组件复用
-- [ ] 缺少错误边界（React）
-- [ ] 内存泄漏（未清理的定时器/事件监听）
-### 9.3 前端安全
-- [ ] innerHTML 注入风险
-- [ ] eval() 使用
-- [ ] 敏感信息存储在 localStorage
-- [ ] 缺少 CSRF token
-- [ ] 跨域配置过宽（Access-Control-Allow-Origin: *）
-### 9.4 前端性能
-- [ ] 未做代码分割
-- [ ] 未做图片懒加载
-- [ ] 重复请求未防抖/节流
-- [ ] 大列表未虚拟滚动
-- [ ] 重复渲染未优化
----
-## 十、工程化问题
-### 10.1 依赖管理
-- [ ] 依赖未声明在 package.json/pom.xml
-- [ ] 使用过时/有漏洞的依赖
-- [ ] 循环依赖
-- [ ] 依赖版本锁定（避免使用 latest）
-- [ ] 重复依赖不同版本
-### 10.2 配置管理
-- [ ] 配置硬编码在代码中
-- [ ] 配置文件提交到仓库
-- [ ] 缺少环境变量管理
-- [ ] 缺少配置中心（如 Nacos）
-### 10.3 测试相关
-- [ ] 关键方法缺少单元测试
-- [ ] 测试覆盖度低
-- [ ] 测试用例不覆盖边界
-- [ ] 测试使用硬编码数据
----
-## 附：常见代码低级错误 Top 30
-| # | 错误类型 | 示例 |
-|---|---------|------|
-| 1 | 字符串拼接 SQL | "SELECT * FROM user WHERE id=" + id |
-| 2 | 空 catch 块 | catch(Exception e) {} |
-| 3 | 资源未关闭 | Connection conn = ...; // 没有 finally 关闭 |
-| 4 | 密码硬编码 | String password = "123456"; |
-| 5 | 敏感信息日志 | log.info("password=" + password); |
-| 6 | 循环中查询数据库 | for (id : ids) { userMapper.find(id); } |
-| 7 | 未做空指针判断 | user.getName().toUpperCase(); |
-| 8 | 魔法数字 | if (status == 3) { ... } |
-| 9 | SELECT * 查询 | SELECT * FROM user |
-| 10 | 未使用 try-with-resources | 手写 finally 关闭 |
-| 11 | 长方法未拆分 | 一个方法 200+ 行 |
-| 12 | 缺少必要的日志 | 关键操作无日志 |
-| 13 | 嵌套层级过深 | 5 层以上 if 嵌套 |
-| 14 | 缺少参数校验 | public void delete(Integer id) {} |
-| 15 | 重复代码 | 多个地方复制相同逻辑 |
-| 16 | 硬编码 URL/路径 | "http://192.168.1.1/api" |
-| 17 | System.out.println 调试 | 应该用日志框架 |
-| 18 | 异常信息泄露 | e.printStackTrace() 返回给前端 |
-| 19 | 缺少事务回滚 | @Transactional 但未处理异常 |
-| 20 | 缺少权限校验 | Controller 未校验权限 |
-| 21 | 缓存无过期 | redis.set(key, value) 无 TTL |
-| 22 | 数据库连接未关闭 | new Connection() 后未关闭 |
-| 23 | 大事务 | 一个事务包含 10 个写操作 |
-| 24 | 缺少乐观锁 | UPDATE 无 version 字段 |
-| 25 | 索引失效 | 隐式类型转换 |
-| 26 | 缺少输入长度限制 | 接收无限制字符串 |
-| 27 | 缺少分页 | 全量查询 |
-| 28 | 缺少超时设置 | HTTP 调用无 timeout |
-| 29 | 缺少重试机制 | 失败就放弃 |
-| 30 | 配置硬编码 | URL、密钥写在代码里 |
----
-## 使用说明
-本清单应作为**正式代码评审前的快速预检工具**，由开发人员或评审人员按清单逐项检查，10-15 分钟内完成。
-- 适用于：开发代码评审前预检
-- 不适用于：架构决策、需求评审
-- 检查时机：合并请求前、正式评审前
-- 检查视角：以专业开发者视角，可发散识别更多低级问题