MeterSphere 技能

⚠️ 安装前重要警告

在安装或运行此技能前，请务必完成以下安全检查：

1. 1. 确认元数据：检查 skill-metadata.json 中的必需环境变量和二进制文件要求
2. 使用最小权限凭证：为查询和创建操作使用不同的、有限权限的 API 密钥
3. 检查 .env 文件：确保只包含预期的变量，没有额外敏感信息
4. 警惕 HEADERSJSON：如果设置此变量，不要包含可能泄露数据或向其他服务认证的头部
5. 审查硬编码 ID：设置 METERSPHEREDEFAULTTEMPLATEID 和 METERSPHEREDEFAULTVERSION_ID 环境变量
6. 先在沙箱中运行：在非生产环境测试并监控网络流量
7. 确保二进制文件可信：openssl/curl/python3 必须来自可信的系统包
8. 签名算法验证：如需更强保证，请求发布者解释签名算法

详细检查清单见 INSTALLATION_CHECKLIST.md

---

优先使用本技能自带脚本，不要临时手写 curl。

选择工作流

按任务类型选择最短路径：

1. 查询类

用于：

• - 查询组织 / 项目 / 模块 / 模板
• 查询功能用例 / 接口定义 / 接口用例
• 查询评审单 / 评审详情 / 评审人 / 评审模块
• 回答哪些用例被评审过
• 回答这条用例关联了多少个缺陷 / 哪些用例缺陷最多
• 当用户查询某个功能用例时，返回：用例详情 + 缺陷 + 评审记录

优先命令：

bash
./scripts/ms.sh organization list
./scripts/ms.sh project list
./scripts/ms.sh functional-module list
./scripts/ms.sh functional-template list
./scripts/ms.sh api-module list
./scripts/ms.sh functional-case list
./scripts/ms.sh api list
./scripts/ms.sh api-case list
./scripts/ms.sh functional-case-review list {caseId:<功能用例ID>}
./scripts/ms.sh case-review list {projectId:<项目ID>}
./scripts/ms.sh case-review get
./scripts/ms.sh case-review-detail list {projectId:<项目ID>,reviewId:<评审ID>,viewStatusFlag:false}
./scripts/ms.sh case-review-module list
./scripts/ms.sh case-review-user list
./scripts/ms.sh reviewed-summary [keyword]
./scripts/ms.sh case-report
./scripts/ms.sh case-report-md

2. 需求 → 功能用例

用于：

• - 根据一句需求生成测试用例
• 根据需求文档批量生成功能用例
• 先出草稿，再让 AI 补充场景
• 最终写入 MeterSphere

默认流程：

bash
./scripts/ms.sh functional-case generate
./scripts/ms.sh functional-case batch-create

需要一步直写时：

bash
./scripts/ms.sh functional-case generate-create

3. Swagger / OpenAPI → 接口定义 + 接口用例

用于：

• - 根据 Swagger / OpenAPI 导入接口定义
• 自动生成成功 / 必填缺失 / 边界场景接口用例
• 先本地生成，再批量写入

默认流程：

bash
./scripts/ms.sh api import-generate
./scripts/ms.sh api batch-create

需要一步直写时：

bash
./scripts/ms.sh api import-create

处理哪些用例被评审过

优先使用：

bash
./scripts/ms.sh reviewed-summary [keyword]

这是最高层入口，直接输出：

• - 项目内总用例数
• 已被评审的用例数
• 未被评审的用例数
• 项目内总缺陷关联数 totalBugLinks
• 每条功能用例的 reviewed: true/false
• 每条功能用例参与过哪些评审单
• 每条功能用例关联了多少个缺陷 bugCount

如果用户直接询问某条功能用例，优先使用：

bash
./scripts/ms.sh case-report-md

如果需要结构化 JSON 再使用：

bash
./scripts/ms.sh case-report

其中 Markdown 版更适合直接回复用户；JSON 版更适合继续加工。

case-report 返回四块：

• - summary：用例基础信息、缺陷数、评审数、测试计划数、需求数
• detail：前置条件、备注、步骤、标签、附件
• bugs：已关联缺陷列表
• reviews：评审记录列表

如果用户追问某条用例的评审来源，再补充：

bash
./scripts/ms.sh functional-case-review list {caseId:<功能用例ID>}

如果用户要看某个评审单里的全部用例状态，再补充：

bash
./scripts/ms.sh case-review-detail list {projectId:<项目ID>,reviewId:<评审ID>,viewStatusFlag:false}

判断口径：

• - functional-case-review list 返回非空：该功能用例可视为被评审过
• case-review-detail list 中每条记录的 status 代表该用例在该评审单中的当前状态，如：UNREVIEWED / UNDERREVIEWED / PASS / UN_PASS
• functional/case/detail/{id} 中的 bugCount 代表该用例当前关联缺陷数

默认执行顺序

查询项目或模块前

先确认：

1. 1. project list
2. 需要时再查询 functional-module list / api-module list

生成功能用例前

先确认：

1. 1. 项目 ID
2. 功能模块 ID
3. 模板 ID

命令顺序：

bash
./scripts/ms.sh project list
./scripts/ms.sh functional-module list
./scripts/ms.sh functional-template list

生成功能用例后

如需提升质量，再读取：

• - references/ai-functional-case-prompt.md

导入 OpenAPI 后

如需补充断言、补充异常场景、补充命名，再读取：

• - references/ai-api-bundle-prompt.md

需要确认接口字段 / 路径 / 评审 API 时

再读取：

• - references/ms-api.md

本地生成能力边界

功能用例草稿

默认能稳定生成：

• - 主流程
• 异常场景
• 边界场景
• 基础优先级
• 基础标签

接口定义 / 接口用例草稿

默认能稳定生成：

• - 1 条接口定义
• 3 条接口用例：成功 / 必填缺失 / 边界
• 基于 example/schema 自动带值
• 基础状态码断言

评审与关联查询

默认能稳定回答：

• - 有哪些评审单
• 某条功能用例是否参与过评审
• 某个评审单下有哪些功能用例
• 当前评审状态统计
• 哪些用例已评审 / 未评审
• 某条功能用例关联了多少个缺陷
• 某个功能用例的详情、缺陷、评审记录
• 哪些功能用例的缺陷关联数更多

环境变量

必需环境变量

bash METERSPHEREBASEURL= # MeterSphere 实例地址（如：http://172.16.200.18:8081） METERSPHEREACCESSKEY= # API 访问密钥 METERSPHERESECRETKEY= # API 密钥（用于本地签名，不传输）

可选环境变量

bash METERSPHEREPROJECTID= # 默认项目 ID METERSPHEREORGANIZATIONID=100001 # 默认组织 ID METERSPHEREHEADERSJSON= # 额外的 HTTP 头（JSON 格式，谨慎使用） METERSPHEREPROTOCOLSJSON=[HTTP] # 支持的协议 METERSPHEREDEFAULTTEMPLATE_ID= # 默认模板 ID（避免使用硬编码值） METERSPHEREDEFAULTVERSION_ID= # 默认版本 ID（避免使用硬编码值）

依赖要求

• - python3：运行辅助脚本和数据处理
• openssl