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

package/skills/developer-testcase-review/SKILL.md

@@ -0,0 +1,191 @@
+---
+name: developer-testcase-review
+description: |
+  开发者测试用例评审skill。根据开发者测试用例检查单对测试用例文档进行系统性审查，检查逻辑：通过填"是"，不通过填"否"并说明原因，不适用填"不适用"。
+  使用场景：用户提到"开发者测试用例评审"、"开发者测试用例检查"、"评审开发者测试用例"、"检查开发者测试用例完整性"，或提供开发者测试用例文档路径时触发。
+  输出：填写完整检查结果的评审报告。
+author: maohan
+source: project
+date_added: "2026-07-08"
+risk: low
+---
+
+# 开发者测试用例评审Skill
+
+## 概述
+
+本skill用于对测试用例文档进行系统性评审，基于预设的检查单逐项验证测试用例的完整性、边界值覆盖、安全性、性能测试等方面。
+
+## 输入
+
+- **测试用例文档路径**：待评审的测试用例文档（Markdown、Excel、文本文件均可）
+
+## 检查逻辑
+
+对每个检查项应用以下规则：
+
+| 条件 | 检查结果 | 说明 |
+|------|----------|------|
+| 检查通过 | 是 | - |
+| 检查不通过 | 否 | 需在说明列填写未通过原因 |
+| 不适用 | 不适用 | 不适用项不参与通过率计算 |
+
+## 评审流程
+
+### 第一步：读取文件
+
+读取以下两个文件：
+1. 测试用例文档（用户提供的路径）
+2. 检查单模板（`references/开发者测试用例检查单.md`）
+
+### 第二步：逐项检查
+
+按照检查单从以下4个维度进行评审：
+
+#### 1. 完整性（4项）
+- 测试用例命名、格式是否规范
+- 集成测试是否满足需求目的
+- 测试用例是否覆盖接口/功能容错机制的场景
+- 开发平台基础包是否升级到最新版本
+
+#### 2. 边界值分析/参数组合（8项）
+- 参数数据类型取值范围边界内是否符合预期
+- 参数数据类型取值范围边界外是否符合预期
+- 参数限制输入数据的全职范围边界内是否符合预期
+- 参数限制输入数据的全职范围边界外是否符合预期
+- 参数值为空时是否符合预期
+- 参数值包含特殊字符时是否符合预期
+- 是否覆盖所有必选参数
+- 是否组合所有可选参数
+
+#### 3. 安全（4项）
+- 是否包含重复提交的场景
+- 是否包含SQL注入、XSS攻击的场景
+- 敏感数据是否进行加密
+- 是否考虑到越权的场景
+
+#### 4. 性能测试（5项）
+- 是否考虑到系统响应时间
+- 是否考虑到系统服务器资源使用率
+- 是否考虑不同规模数据下系统响应时间和资源使用率
+- 是否考虑最大并发数
+- 是否考虑系统文件句柄占用
+
+### 第三步：生成评审报告
+
+按照以下Markdown格式生成报告：
+
+```markdown
+# 测试用例评审报告
+
+## 基本信息
+- **评审日期**：[填写当前日期]
+- **测试用例文档**：[文档名称]
+- **评审人员**：AI小助手
+
+---
+
+## 一、完整性
+
+| 序号 | 检查内容 | 检查结果 | 说明 |
+| ---- | -------- | -------- | ---- |
+| 1 | [检查项] | 是/否/不适用 | [说明] |
+| ... | ... | ... | ... |
+
+**[维度通过率]**：X/X 通过 (XX%)  
+**不适用项**：X项
+
+---
+
+## 二、边界值分析/参数组合
+
+| 序号 | 检查内容 | 检查结果 | 说明 |
+| ---- | -------- | -------- | ---- |
+| 1 | [检查项] | 是/否/不适用 | [说明] |
+| ... | ... | ... | ... |
+
+**[维度通过率]**：X/X 通过 (XX%)  
+**不适用项**：X项
+
+---
+
+## 三、安全
+
+| 序号 | 检查内容 | 检查结果 | 说明 |
+| ---- | -------- | -------- | ---- |
+| 1 | [检查项] | 是/否/不适用 | [说明] |
+| ... | ... | ... | ... |
+
+**[维度通过率]**：X/X 通过 (XX%)  
+**不适用项**：X项
+
+---
+
+## 四、性能测试
+
+| 序号 | 检查内容 | 检查结果 | 说明 |
+| ---- | -------- | -------- | ---- |
+| 1 | [检查项] | 是/否/不适用 | [说明] |
+| ... | ... | ... | ... |
+
+**[维度通过率]**：X/X 通过 (XX%)  
+**不适用项**：X项
+
+---
+
+## 总体评估
+
+| 维度 | 检查项数 | 通过数 | 通过率 | 不适用项 |
+|------|----------|--------|--------|----------|
+| 完整性 | 4 | X | XX% | X |
+| 边界值分析/参数组合 | 8 | X | XX% | X |
+| 安全 | 4 | X | XX% | X |
+| 性能测试 | 5 | X | XX% | X |
+| **总计** | **21** | **X** | **XX%** | **X** |
+
+---
+
+## 问题汇总
+
+### 高优先级问题
+[列出所有"否"的检查项，说明原因]
+
+### 中优先级问题
+[根据具体情况填写]
+
+### 低优先级问题
+[根据具体情况填写]
+
+---
+
+## 评审结论
+
+[根据通过率给出评审结论：优秀/良好/合格/不合格，并说明原因]
+
+---
+
+评审人：AI小助手
+评审日期：[当前日期]
+```
+
+### 第四步：保存报告
+
+将评审报告保存到 `docs/测试用例评审报告-YYYYMMDD.md`
+
+## 输出
+
+生成的测试用例评审报告，包含：
+1. 4个维度的详细检查结果表格
+2. 每个维度的通过率统计
+3. 不适用项统计
+4. 总体通过率（不适用项不参与通过率计算）
+5. 问题汇总（按优先级分类）
+6. 评审结论
+
+## 注意事项
+
+- 评审时需结合测试用例文档的实际内容进行判断，不能仅依赖模板
+- 对于不适用于当前项目的检查项（如性能测试对纯查询接口），标记为"不适用"并简要说明
+- 问题说明需具体、明确，指出具体缺少什么测试场景
+- 生成报告后告知用户报告保存路径
+- 统计通过率时，仅计算适用项数作为分母，不适用项不参与通过率计算

package/skills/developer-testcase-review/references//345/274/200/345/217/221/350/200/205/346/265/213/350/257/225/347/224/250/344/276/213/346/243/200/346/237/245/345/215/225.md

@@ -0,0 +1,40 @@
+# 1.完整性
+
+| 序号 | 检查内容                                  | 检查结果     | 说明 |
+| ---- | ----------------------------------------- | ------------ | ---- |
+| 1    | 测试用例命名、格式是否规范？              | 是/否/不适用 |      |
+| 2    | 集成测试用是否满足需求目的？              | 是/否/不适用 |      |
+| 3    | 测试用例是否覆盖接口/功能容错机制的场景？ | 是/否/不适用 |      |
+| 4    | 开发平台基础包是否已经升级到最新版本？    | 是/否/不适用 |      |
+
+# 2.边界值分析/参数组合
+
+| 序号 | 检查内容                                               | 检查结果     | 说明 |
+| ---- | ------------------------------------------------------ | ------------ | ---- |
+| 1    | 参数数据类型的取值范围边界内是否符合预期是否正常？     | 是/否/不适用 |      |
+| 2    | 参数数据类型的取值范围边界外是否符合预期是否正常？     | 是/否/不适用 |      |
+| 3    | 参数限制输入数据的全职范围边界内是否符合预期是否正常？ | 是/否/不适用 |      |
+| 4    | 参数限制输入数据的全职范围边界外是否符合预期是否正常？ | 是/否/不适用 |      |
+| 5    | 参数值为空时是否符合预期是否正常？                     | 是/否/不适用 |      |
+| 6    | 参数值包含特殊字符时是否符合预期是否正常？             | 是/否/不适用 |      |
+| 7    | 是否覆盖所有必选参数？                                 | 是/否/不适用 |      |
+| 8    | 是否组合所有可选参数？                                 | 是/否/不适用 |      |
+
+# 3.安全
+
+| 序号 | 检查内容                         | 检查结果     | 说明 |
+| ---- | -------------------------------- | ------------ | ---- |
+| 1    | 是否包含重复提交的场景？         | 是/否/不适用 |      |
+| 2    | 是否包含SQL注入、XSS攻击的场景？ | 是/否/不适用 |      |
+| 3    | 敏感数据是否进行加密？           | 是/否/不适用 |      |
+| 4    | 是否考虑到越权的场景？           | 是/否/不适用 |      |
+
+# 4.性能测试
+
+| 序号 | 检查内容                                           | 检查结果     | 说明 |
+| ---- | -------------------------------------------------- | ------------ | ---- |
+| 1    | 是否考虑到系统响应时间？                           | 是/否/不适用 |      |
+| 2    | 是否考虑到系统服务器资源使用率？                   | 是/否/不适用 |      |
+| 3    | 是否考虑不同规模的数据下系统响应时间和资源使用率？ | 是/否/不适用 |      |
+| 4    | 是否考虑最大并发数？                               | 是/否/不适用 |      |
+| 5    | 是否考虑系统文件句柄占用？                         | 是/否/不适用 |      |

package/skills/development-code-review/SKILL.md

@@ -0,0 +1,138 @@
+---
+name: development-code-review
+description: |
+  开发代码评审skill。根据开发代码评审检查单对代码进行系统性审查，检查逻辑：通过填"是"，不通过填"否"并说明原因，不适用填"不适用"。
+  使用场景：用户提到"开发代码评审"、"代码评审"、"代码检查"、"评审代码"、"检查代码是否规范"，或提供代码文件/模块路径时触发。
+  输出：填写完整检查结果的评审报告。
+author: maohan
+source: project
+date_added: "2026-07-08"
+risk: low
+---
+
+# 开发代码评审 Skill
+
+本技能用于对代码进行系统性评审，基于预设的检查单逐项验证代码结构、流程控制、存储、防御性编程、前端规范、发布流程等维度。
+
+---
+
+## 输入
+
+- **代码路径**：待评审的代码文件或模块路径（Java/前端代码等）
+
+---
+
+## 检查逻辑
+
+对每个检查项应用以下规则：
+
+| 条件 | 检查结果 | 说明 |
+|------|----------|------|
+| 检查通过 | 是 | - |
+| 检查不通过 | 否 | 需在说明列填写未通过原因 |
+| 不适用 | 不适用 | 不适用项不进行通过率计算 |
+
+---
+
+## 使用方法
+
+1. 加载检查单 `references/开发代码评审检查单.md`
+2. 加载报告模板 `references/开发代码评审报告模板.md`
+3. 加载待评审的代码文件
+4. 按 6 个维度逐项检查
+5. 按报告模板生成评审报告
+6. 保存报告到 `docs/开发代码评审报告-YYYYMMDD.md`
+
+---
+
+## 6 个评审维度
+
+| 维度 | 检查项数 | 说明 |
+|------|---------|------|
+| 1. 结构 | 20 | 编码规约、命名规范、无用代码、日志、注释等 |
+| 2. 流程控制 | 8 | 短路判断、循环、break/return、资源关闭等 |
+| 3. 存储 | 9 | 表名/列名规范、SQL安全、Redis缓存、Nacos配置等 |
+| 4. 防御性编程 | 9 | 边界检查、空指针、异常处理、超时控制、敏感信息等 |
+| 5. 前端 | 3 | top/window.parent、全局样式、新建/编辑区分 |
+| 6. 发布流程 | 4 | 版本升级、数据源适配、脚本用例 |
+| **总计** | **53** | — |
+
+> 详细检查项见 `references/开发代码评审检查单.md`
+> 报告模板见 `references/开发代码评审报告模板.md`
+
+---
+
+## 输出
+
+生成的开发代码评审报告，包含：
+
+1. 6 个维度的详细检查结果表格
+2. 每个维度的通过率统计
+3. 不适用项统计
+4. 总体通过率（不适用项不进行通过率计算）
+5. 问题汇总（按优先级分类）
+6. 评审结论
+
+---
+
+## 触发场景
+
+- "开发代码评审"
+- "代码评审"
+- "代码检查"
+- "评审代码"
+- "检查代码是否规范"
+- "代码走查"
+
+---
+
+## 注意事项
+
+- 评审时需结合代码的实际内容进行判断，不能仅依赖模板
+- 对于不适用于当前项目的检查项（如前端相关检查对纯后端项目），标记为"不适用"并简要说明
+- 问题说明需具体、明确，指出具体是缺少什么内容或存在什么问题
+- 生成报告后告知用户报告保存路径
+- 统计通过率时，仅计算适用项数作为分母，不适用项不进行通过率计算
+
+---
+
+## 多轮迭代评审支持
+
+**场景**：代码评审后，开发者根据反馈修改代码；评审员再次评审，如此往复。
+
+**核心要求**：
+- 评审报告必须**完整记录每次评审的详细结果**
+- 每次评审的问题必须**追踪修复状态**
+- **不能只记录最后一次评审结果**，必须展示**完整迭代历史**
+- 最终结论必须基于**当前最新状态**
+
+### 迭代评审记录字段
+
+每次评审记录必须包含：
+
+| 字段 | 说明 |
+|------|------|
+| 评审轮次 | V1/V2/V3... |
+| 评审日期 | 评审发生日期 |
+| 代码版本 | 被评审的代码版本 |
+| 检查项数 | 本轮检查项总数 |
+| 通过数 / 失败数 / 不适用数 | 评审结果统计 |
+| 通过率 | 本轮通过率 |
+| 发现问题数 | 本轮发现的问题总数 |
+| 已解决问题数 | 本轮前已解决的问题数（累计） |
+| 新增问题数 | 本轮新发现的问题数 |
+| 待解决问题数 | 本轮结束时的待解决总数 |
+| 评审结论 | 通过/有保留通过/不通过 |
+
+### 修复状态追踪规则
+
+- **待修复**：本轮评审发现，尚未修复
+- **修复中**：开发者正在修复
+- **已解决**：开发者已修复完成（本轮或后续轮次需验证）
+- **未解决/遗留**：多轮评审后仍未解决，需升级处理
+
+### 历史问题追溯
+
+- **新增**：本轮第一次发现的问题
+- **回归**：之前已解决的问题再次出现
+- **持续未决**：跨多轮评审仍未解决的问题

package/skills/development-code-review/references//345/274/200/345/217/221/344/273/243/347/240/201/350/257/204/345/256/241/346/212/245/345/221/212/346/250/241/346/235/277.md

@@ -0,0 +1,260 @@
+# 开发代码评审报告
+
+## 基本信息
+
+- **评审日期**：[填写当前日期]
+- **代码模块**：[模块名称]
+- **代码路径**：[文件/模块路径]
+- **评审人员**：AI小助手
+- **当前评审轮次**：V[N]
+
+---
+
+## 评审迭代历史
+
+### 迭代概览
+
+| 轮次 | 评审日期 | 代码版本 | 检查项数 | 通过数 | 失败数 | 不适用数 | 通过率 | 评审结论 |
+|------|----------|----------|----------|--------|--------|----------|--------|----------|
+| V1 | YYYY-MM-DD | V0.1 | __ | __ | __ | __ | __% | 通过/有保留通过/不通过 |
+| V2 | YYYY-MM-DD | V0.2 | __ | __ | __ | __ | __% | 通过/有保留通过/不通过 |
+| V3 | YYYY-MM-DD | V0.3 | __ | __ | __ | __ | __% | 通过/有保留通过/不通过 |
+| ... | ... | ... | ... | ... | ... | ... | ... | ... |
+
+### V1 评审详情（YYYY-MM-DD）
+
+#### 评审范围
+
+- 代码路径：[文件/模块路径] V0.1
+- 评审人员：AI小助手
+- 评审耗时：xx 分钟
+
+#### 各维度检查结果
+
+| 维度 | 检查项数 | 通过 | 失败 | 不适用 | 通过率 |
+|------|----------|------|------|--------|--------|
+| 结构 | 20 | __ | __ | __ | __% |
+| 流程控制 | 8 | __ | __ | __ | __% |
+| 存储 | 9 | __ | __ | __ | __% |
+| 防御性编程 | 9 | __ | __ | __ | __% |
+| 前端 | 3 | __ | __ | __ | __% |
+| 发布流程 | 4 | __ | __ | __ | __% |
+
+#### 发现问题清单
+
+| # | 维度 | 优先级 | 位置 | 问题描述 | 修复状态 |
+|---|------|--------|------|----------|----------|
+| 1 | 结构 | 高/中/低 | 文件:行号 | xxx | 待修复 |
+| 2 | 流程控制 | 高/中/低 | xxx | xxx | 待修复 |
+| 3 | 存储 | 高/中/低 | xxx | xxx | 待修复 |
+| 4 | 防御性编程 | 高/中/低 | xxx | xxx | 待修复 |
+| ... | ... | ... | ... | ... | ... |
+
+#### V1 结论
+
+- 评审结论：通过 / 有保留通过 / 不通过
+- 必须修复项：__ 个
+- 建议修复项：__ 个
+
+### V2 评审详情（YYYY-MM-DD）
+
+#### 评审范围
+
+- 代码路径：[文件/模块路径] V0.2
+- 评审人员：AI小助手
+- 评审耗时：xx 分钟
+- 修订说明：开发者根据 V1 反馈进行修改，提交 V0.2
+
+#### V1 问题修复追踪
+
+| V1 # | 维度 | 优先级 | 问题描述 | 修复状态 | 修复说明 |
+|------|------|--------|----------|----------|----------|
+| 1 | 结构 | 高 | xxx | 已解决/未解决/遗留 | xxx |
+| 2 | 流程控制 | 中 | xxx | 已解决/未解决/遗留 | xxx |
+| 3 | 存储 | 高 | xxx | 已解决/未解决/遗留 | xxx |
+| ... | ... | ... | ... | ... | ... |
+
+**V1 修复统计**：
+
+- 已解决：__ / __ 个
+- 未解决：__ / __ 个
+- 回归问题：__ 个
+
+#### V2 新发现问题
+
+| # | 维度 | 优先级 | 位置 | 问题描述 | 修复状态 |
+|---|------|--------|------|----------|----------|
+| 1 | xxx | xxx | xxx | xxx | 待修复 |
+| 2 | xxx | xxx | xxx | xxx | 待修复 |
+
+#### 各维度变化对比
+
+| 维度 | V1 通过率 | V2 通过率 | 变化说明 |
+|------|-----------|-----------|----------|
+| 结构 | __% | __% | 改善/不变/退步 |
+| 流程控制 | __% | __% | 改善/不变/退步 |
+| 存储 | __% | __% | 改善/不变/退步 |
+| 防御性编程 | __% | __% | 改善/不变/退步 |
+| 前端 | __% | __% | 改善/不变/退步 |
+| 发布流程 | __% | __% | 改善/不变/退步 |
+| **总体** | **__%** | **__%** | **改善/不变/退步** |
+
+#### V2 结论
+
+- 评审结论：通过 / 有保留通过 / 不通过
+- 必须修复项：__ 个
+- 建议修复项：__ 个
+
+### V3 评审详情（YYYY-MM-DD）
+
+> 按相同格式记录
+
+### 跨轮次问题汇总
+
+#### 持续未决问题（跨多轮未解决）
+
+| 原始轮次 | # | 优先级 | 维度 | 位置 | 问题描述 | 已迭代轮次 | 处理建议 |
+|----------|---|--------|------|------|----------|-----------|----------|
+| V1 | 1 | 高 | 存储 | 文件:行号 | xxx | V1, V2, V3 | 升级处理/放弃修复 |
+| ... | ... | ... | ... | ... | ... | ... | ... |
+
+#### 回归问题（已解决后再次出现）
+
+| 原始 # | 问题描述 | 解决轮次 | 回归轮次 | 说明 |
+|--------|----------|----------|----------|------|
+| V1-3 | xxx | V2 | V3 | xxx |
+| ... | ... | ... | ... | ... |
+
+---
+
+## 一、结构（基于当前轮次）
+
+| 序号 | 检查内容 | 检查结果 | 原始轮次 | 说明 |
+| ---- | -------- | -------- | -------- | ---- |
+| 1 | [检查项] | 是/否/不适用 | V[N] | [说明] |
+| ... | ... | ... | ... | ... |
+
+**[维度通过率]**：X/20 通过 (XX%)
+
+**不适用项**：X 项
+
+---
+
+## 二、流程控制（基于当前轮次）
+
+| 序号 | 检查内容 | 检查结果 | 原始轮次 | 说明 |
+| ---- | -------- | -------- | -------- | ---- |
+| 1 | [检查项] | 是/否/不适用 | V[N] | [说明] |
+| ... | ... | ... | ... | ... |
+
+**[维度通过率]**：X/8 通过 (XX%)
+
+**不适用项**：X 项
+
+---
+
+## 三、存储（基于当前轮次）
+
+| 序号 | 检查内容 | 检查结果 | 原始轮次 | 说明 |
+| ---- | -------- | -------- | -------- | ---- |
+| 1 | [检查项] | 是/否/不适用 | V[N] | [说明] |
+| ... | ... | ... | ... | ... |
+
+**[维度通过率]**：X/9 通过 (XX%)
+
+**不适用项**：X 项
+
+---
+
+## 四、防御性编程（基于当前轮次）
+
+| 序号 | 检查内容 | 检查结果 | 原始轮次 | 说明 |
+| ---- | -------- | -------- | -------- | ---- |
+| 1 | [检查项] | 是/否/不适用 | V[N] | [说明] |
+| ... | ... | ... | ... | ... |
+
+**[维度通过率]**：X/9 通过 (XX%)
+
+**不适用项**：X 项
+
+---
+
+## 五、前端（基于当前轮次）
+
+| 序号 | 检查内容 | 检查结果 | 原始轮次 | 说明 |
+| ---- | -------- | -------- | -------- | ---- |
+| 1 | [检查项] | 是/否/不适用 | V[N] | [说明] |
+| ... | ... | ... | ... | ... |
+
+**[维度通过率]**：X/3 通过 (XX%)
+
+**不适用项**：X 项
+
+---
+
+## 六、发布流程（基于当前轮次）
+
+| 序号 | 检查内容 | 检查结果 | 原始轮次 | 说明 |
+| ---- | -------- | -------- | -------- | ---- |
+| 1 | [检查项] | 是/否/不适用 | V[N] | [说明] |
+| ... | ... | ... | ... | ... |
+
+**[维度通过率]**：X/4 通过 (XX%)
+
+**不适用项**：X 项
+
+---
+
+## 当前未解决问题（基于当前轮次）
+
+### 高优先级问题（必须修复）
+
+| # | 维度 | 位置 | 问题描述 | 建议修复 | 原始轮次 |
+|---|------|------|----------|----------|----------|
+| 1 | xxx | xxx | xxx | xxx | V[N] |
+
+### 中优先级问题（建议修复）
+
+| # | 维度 | 位置 | 问题描述 | 建议修复 | 原始轮次 |
+|---|------|------|----------|----------|----------|
+| 1 | xxx | xxx | xxx | xxx | V[N] |
+
+### 低优先级问题
+
+| # | 维度 | 位置 | 问题描述 | 建议修复 | 原始轮次 |
+|---|------|------|----------|----------|----------|
+| 1 | xxx | xxx | xxx | xxx | V[N] |
+
+---
+
+## 总体评估
+
+| 维度 | 检查项数 | 通过数 | 通过率 | 不适用项 | 变化（vs V1） |
+|------|----------|--------|--------|----------|---------------|
+| 结构 | 20 | X | XX% | X | ±X% |
+| 流程控制 | 8 | X | XX% | X | ±X% |
+| 存储 | 9 | X | XX% | X | ±X% |
+| 防御性编程 | 9 | X | XX% | X | ±X% |
+| 前端 | 3 | X | XX% | X | ±X% |
+| 发布流程 | 4 | X | XX% | X | ±X% |
+| **总计** | **53** | **X** | **XX%** | **X** | **±X%** |
+
+---
+
+## 评审结论
+
+[根据通过率给出评审结论：优秀/良好/合格/不合格，并说明原因]
+
+**迭代历史总结**：
+
+- 共经历 N 轮评审
+- 累计发现问题 __ 个
+- 已解决问题 __ 个
+- 遗留问题 __ 个
+- 通过率从 V1 的 __% 提升到当前的 __%
+
+---
+
+评审人：AI小助手
+
+评审日期：[当前日期]