@zhanlucode/zl-darwin-arm64 1.6.4-moma.0

package/bin/zhanlu-plugins/lingji-alpha-assistant/skills/manual-test-case-generator/references/review-rules.md

@@ -0,0 +1,117 @@
+# 测试用例评审规则
+
+本文件定义了手工测试用例的评审标准和流程。评审的核心原则是**发现问题，而非确认通过**——AI 自动生成的测试用例普遍存在质量问题，需要严格把关。对每个维度进行真实判断，发现问题就标记不通过，不要因为"大体上还可以"就放过。
+
+## 目录
+
+1. [评审原则](#评审原则)
+2. [AI 生成用例常见问题](#ai-生成用例常见问题)
+3. [八维评审标准](#八维评审标准)
+4. [通过/不通过判定](#通过不通过判定)
+5. [评审执行方式](#评审执行方式)
+
+---
+
+## 评审原则
+
+- 对每个维度进行真实判断，发现问题就标记不通过
+- 评审结论必须反映用例的真实质量，不能流于形式
+- 重点排查**幻觉信息**：无关 URL、不存在的账号、与当前业务模块无关的环境描述
+- 宁可多改一轮，不可放过质量隐患
+
+## AI 生成用例常见问题
+
+以下是 AI 生成用例最常出现的 10 类质量问题，评审时重点排查：
+
+1. **步骤过于笼统**：如"输入用户名和密码"但未指定输入什么值、"点击按钮"但未说明哪个按钮
+2. **预期结果模糊**：如"操作成功"、"系统响应正常"、"页面显示正确"等无法验证的描述
+3. **缺乏异常/负向场景**：只测正向流程，没有输入非法值、越权操作、网络异常等反向用例
+4. **缺乏边界值测试**：没有最大/最小长度、临界值、空值等边界场景
+5. **前置条件不完整/存在幻觉**：
+   - 未指定具体的测试账号、角色权限、测试数据
+   - 混入与当前功能模块无关的 URL、系统名称、账号（幻觉信息）
+   - 环境描述模糊或与当前业务场景不符
+6. **优先级设置雷同**：大量用例优先级相同，未根据业务重要程度区分
+7. **安全/性能/可靠性用例质量低**：内容过于空洞，如"测试安全性"而没有具体操作
+8. **测试类型分布不均**：功能测试用例过多，其他类型用例质量和数量严重不足
+9. **步骤与预期结果数量不对应**：5个步骤只有1条预期结果，或预期结果不覆盖关键步骤
+10. **用例场景重复**：多条用例测试完全相同的场景，缺乏差异性
+
+## 八维评审标准
+
+### 维度 1：用例标题
+- **通过**：明确包含 功能模块 + 操作场景 + 预期状态，如"通讯录-角色管理-新增角色-输入合法名称创建成功"
+- **不通过**：标题笼统如"登录测试"、"验证功能"，或无法从标题判断具体测试场景
+
+### 维度 2：前置条件
+- **通过**：
+  1. 明确列出当前功能模块专属的测试账号（含角色/权限范围）
+  2. 明确测试数据状态（如"系统中不存在名为'测试管理员'的角色"）
+  3. 明确当前模块的测试环境配置
+  4. 无任何与当前功能模块无关的系统名称、URL、账号等幻觉信息
+- **不通过**：
+  1. 仅写"系统正常运行"、"用户已登录"等泛泛描述
+  2. 包含与当前功能模块无关的 URL、账号、系统名称
+  3. 未指定测试账号的角色权限范围
+  4. 未说明关键测试数据的初始状态
+
+### 维度 3：测试步骤
+- **通过**：每步有序号，操作对象具体（指明哪个按钮/输入框/菜单），输入值有明确示例
+- **不通过**：步骤中出现"输入信息"（未说明什么信息）、"点击按钮"（未说明哪个按钮）等模糊描述；步骤数少于 3 条而测试场景应当复杂
+
+### 维度 4：预期结果
+- **通过**：对应每个关键步骤，描述可观察的系统具体响应（如"页面跳转至 /role 列表，新增一条'测试管理员'记录"）
+- **不通过**：出现"操作成功"、"系统正常"、"显示正确"等模糊词；步骤数与预期结果数不匹配（超过2倍差距）；缺少错误提示的具体描述
+
+### 维度 5：用例类型
+- **通过**：类型属于 7 种之一（功能测试、安全测试、性能测试、冒烟测试、可靠性测试、兼容性测试、易用性测试）
+- **不通过**：类型为空，或不在上述 7 种范围内
+
+### 维度 6：优先级
+- **通过**：使用 L0/L1/L2/L3，核心流程为 L0/L1，边缘场景为 L2/L3，分布合理
+- **不通过**：所有用例优先级完全相同；格式不符合 L0-L3 规范
+
+### 维度 7：测试环境准备
+- **通过**：
+  1. 明确说明浏览器类型和版本（或操作系统）
+  2. 明确当前功能模块的测试环境 URL（无无关 URL 混入）
+  3. 明确所需账号角色和权限范围
+- **不通过**：前置条件中没有任何环境、账号、数据的具体描述；或混入无关 URL/系统名称
+
+### 维度 8：测试范围覆盖
+- **通过**：7 种测试类型均有覆盖，且包含正向、反向（异常/非法输入）、边界值三类场景
+- **不通过**：缺少任意一种标准测试类型；无异常/负向场景；无边界值场景
+
+## 通过/不通过判定
+
+### 不通过（满足任意一条即不通过）
+
+- 超过 20% 的用例步骤描述模糊
+- 超过 20% 的用例预期结果模糊
+- 缺少异常/负向测试场景
+- 缺少边界值测试场景
+- 缺失 1 种及以上标准测试类型
+- 优先级全部相同
+- 超过 50% 的用例前置条件缺乏具体描述
+- 存在幻觉信息（无关 URL、账号、系统名称 ≥1 条用例）
+
+### 通过（须全部满足）
+
+- 所有用例步骤具体可执行
+- 所有用例预期结果可观察可验证
+- 包含正向、负向、边界值三类场景
+- 7 种测试类型均有覆盖
+- 优先级分布合理（核心 L0/L1，边缘 L2/L3）
+- 前置条件明确具体，无任何幻觉信息
+
+## 评审执行方式
+
+生成用例后，按以下方式执行自我评审：
+
+1. **逐维度扫描**：依次检查 8 个维度，标记每个维度的通过/不通过
+2. **问题定位**：对不通过维度，列出具体的问题用例编号和问题描述
+3. **类型覆盖清点**：确认 7 种测试类型均有用例，确认三类场景（正向/负向/边界值）均有覆盖
+4. **幻觉排查**：仔细检查前置条件、环境描述中是否包含与当前需求无关的 URL、账号、系统名称
+5. **得出结论**：根据判定标准，给出明确的通过/不通过结论
+
+如果结论为不通过，触发修正流程（参见 SKILL.md 中的修正规则），修正后直接输出最终结果。

package/bin/zhanlu-plugins/lingji-alpha-assistant/skills/manual-test-case-generator/references/save-rules.md

@@ -0,0 +1,367 @@
+# 用例保存规则
+
+本文件定义了将手工测试用例保存至灵畿平台用例库的完整规则，包括上下文解析、目录校验、数据转换和 API 调用。
+
+## 重要约定：空间编码 vs 空间ID
+
+所有 MCP 接口中涉及研发空间参数（`workspaceId`、`X-Auth-ModuleId` 等）时，**统一传空间编码（字符串），非空间数据库数字ID**。`workspaceId` 虽然是 MCP 参数名，但值应为空间编码。
+
+## 触发指令
+
+| 用户说法 | 解析结果 |
+|----------|----------|
+| "保存用例到电商核心用例库" | 用例库=电商核心用例库，目录=根目录，测试计划=无 |
+| "保存用例到电商核心用例库登录模块目录下" | 用例库=电商核心用例库，目录=登录模块，测试计划=无 |
+| "保存用例到XX用例库XX目录下，并关联测试计划XX" | 用例库=XX，目录=XX，测试计划=XX |
+| "将用例保存到用例库" / "用例入库" | 用例库=未指定，需弹出确认让用户选择用例库 |
+
+## 数据源
+
+优先从 MD 文件中读取用例内容（用户可能直接编辑了 MD 文件），使用 `read` 工具读取文件后解析用例数据。若 MD 文件不存在或读取失败，则使用对话上下文中的用例内容。
+
+## 步骤 1：解析保存上下文并查询资源
+
+从用户指令中解析出以下上下文字段，对于未提供的字段，按默认值处理：
+
+| 字段 | 来源 | 必填 | 说明                                                             |
+|------|------|----|----------------------------------------------------------------|
+| workspaceId | 查询时的空间编码 | 是  | **空间编码**（MCP 参数名为 workspaceId，实际传的是空间编码字符串，非空间数据库ID） |
+| libraryId | 用户指定 / MCP 查询 | 是  | 用例库ID                     |
+| libraryName | 用户指令解析 | 否  | 用例库名称（用于匹配 libraryId）     |
+| moduleId | 用户指定 / MCP 查询 | 是  | 场景目录编码，根目录时传-1，用户没有指定是传-1 |
+| modulePath | 用户指令解析 | 否  | 场景目录路径（如"登录模块/功能测试"）      |
+| testPlanId | 用户指定 / MCP 查询 | 否  | 测试计划ID                    |
+| testPlanName | 用户指令解析 | 否  | 测试计划名称（用于匹配 testPlanId）   |
+| demandList | 需求信息 | 否  | 关联需求编号（自动从确认的需求中获取）       |
+| projectId | 空间上下文 | 否 | 项目编码，从需求的关联项目中提取，若没有，则从当前登录研发空间的关联项目中提取；仅一个时自动填充，多个时需用户选择 |
+| productId | 需求上下文 + MCP 查询 | 否 | 产品编码，从需求的关联产品编码中获取，如果没有，则从当前登录研发空间的关联产品中提取，提取不到则不传|
+
+### 查询产品信息
+
+**获取产品编码（productId）：**
+
+从当前需求中提取关联产品，若没有，则从登录的研发空间信息中提取关联产品。当前空间下可能关联一个或多个产品：
+
+1. **仅一个产品** → 自动使用该产品编码作为 `productId`，无需用户确认
+2. **多个产品** → 使用 `question` 工具列出项目供用户选择
+
+
+```json
+{
+  "questions": [
+    {
+      "question": "当前空间下存在多个产品，请选择用例关联的产品：\n1. 电商平台（ID：100，编码：PROD001）\n2. 营销系统（ID：200，编码：PROD002）",
+      "header": "选择产品",
+      "options": [
+        { "label": "电商平台", "description": "产品ID：100，编码：PROD001" },
+        { "label": "营销系统", "description": "产品ID：200，编码：PROD002" }
+      ]
+    }
+  ]
+}
+```
+
+3. **无关联产品** → `productId` 不传，不阻塞保存流程
+
+
+**提取项目编码（projectId）：**
+
+从当前登录的研发空间信息中提取关联项目。当前空间下可能关联一个或多个项目：
+
+1. **仅一个项目** → 自动使用该项目编码作为 `projectId`，无需用户确认
+2. **多个项目** → 使用 `question` 工具列出项目供用户选择
+
+```json
+{
+  "questions": [
+    {
+      "question": "当前空间下关联了多个项目，请选择用例关联的项目：\n1. 核心交易项目（PJ001）\n2. 用户中心项目（PJ002）",
+      "header": "选择项目",
+      "options": [
+        { "label": "核心交易项目", "description": "项目编码：PJ001" },
+        { "label": "用户中心项目", "description": "项目编码：PJ002" }
+      ]
+    }
+  ]
+}
+```
+
+3. **无关联项目** → `projectId` 不传，不阻塞保存流程
+
+### 查询用例库及目录
+
+调用 `mcp__cmdevops_ct__list_query_library` 获取用例库及场景目录树。**注意：调用时 `workspaceId` 参数传空间编码，非空间数据库ID。**
+
+- `workspaceId` = 当前空间编码
+
+从返回结果中：
+1. 若用户指定了用例库名称 → 在返回列表中按 `libraryName` 匹配获取 `libraryId`
+2. 若用户未指定用例库名称 → **使用 `question` 工具将全部用例库列出供用户选择**，禁止自动取第一个
+3. 将 `caseModuleVO` 的树形结构展开，构建完整路径映射表（路径 → moduleId）
+
+```
+根目录          → moduleId=0
+登录模块        → moduleId=1001
+登录模块/密码登录 → moduleId=1002
+下单模块        → moduleId=2001
+下单模块/购物车下单 → moduleId=2002
+```
+
+4. 若用户指定了目录，在路径映射表中查找：
+   - **目录存在**：获取其 `moduleId`
+   - **目录不存在**：提示用户目录不存在，**不执行保存操作**，使用 `question` 工具让用户选择重新输入或保存至根目录。
+
+选项中列出 `list_query_library` 返回的所有用例库名称。`question` 工具默认启用 `custom` 模式，用户也可直接输入用例库名称，**不要在 options 中添加"其他"或"手动输入"选项**。
+
+```
+⚠️ 指定的目录"XXX"在用例库中不存在，无法保存。请检查目录名称是否正确。
+```
+
+**目录匹配规则：**
+- 用户输入支持多级路径，用 `/` 分隔，如"登录模块/密码登录"
+- 支持模糊匹配最后一级目录名（如输入"密码登录"可匹配到"登录模块/密码登录"），但若存在同名目录则需提示用户选择具体路径
+
+### 查询测试计划
+
+若用户指定了测试计划名称，调用 `mcp__cmdevops_ct__list_query_plan` 查询测试计划列表。**注意：调用时 `workspaceId` 参数传空间编码，非空间数据库ID。**
+
+- `workspaceId` = 当前空间编码
+
+从返回结果中按计划名称匹配获取 `testPlanId`。若未匹配到，提醒用户确认测试计划名称。
+
+## 步骤 2：确认缺失的必填信息
+
+`libraryId` 为必填字段，若用户指令中未指定用例库名称，必须使用 `question` 工具让用户选择。
+
+`question` 工具调用示例：
+
+```json
+{
+  "questions": [
+    {
+      "question": "请选择要保存到的用例库：\n1. 电商核心用例（100001）\n2. 营销活动用例库（100002）",
+      "header": "选择用例库",
+      "options": [
+        { "label": "电商核心用例库", "description": "用例库ID：100001" },
+        { "label": "营销活动用例库", "description": "用例库ID：100002" }
+      ]
+    }
+  ]
+}
+```
+
+选项中列出 `list_query_library` 返回的所有用例库名称。`question` 工具默认启用 `custom` 模式，用户也可直接输入用例库名称，**不要在 options 中添加"其他"或"手动输入"选项**。
+
+其他缺失字段处理：
+
+| 缺失字段 | 处理方式 |
+|----------|----------|
+| workspaceId | "请提供研发空间编码" |
+| projectId | 从需求的关联项目自动提取；无编码时传空字符串；多个项目时让用户选择 |
+| productId | 从需求的关联产品自动获取；无编码时传空字符串；多个产品时让用户选择 |
+
+`question` 工具调用示例：
+
+```json
+{
+  "questions": [
+    {
+      "question": "保存信息确认：\n- 用例库：{libraryName}（{libraryId}）\n- 保存目录：{modulePath 或\"根目录\"}\n- 关联测试计划：{testPlanName 或\"不关联\"}\n- 关联需求：{demandList}\n- 项目编码：{projectId 或\"自动获取\"}\n- 产品编码：{productId 或\"自动获取\"}\n\n确认保存？如需调整请直接输入修改内容。",
+      "header": "保存确认",
+      "options": [
+        { "label": "确认，直接保存", "description": "使用以上信息保存用例" }
+      ]
+    }
+  ]
+}
+```
+
+`question` 工具默认启用 `custom` 模式，用户如需调整可直接在输入框中输入修改内容（如"目录改为登录模块"），**不要在 options 中添加"需要调整"选项**。
+
+## 步骤 3：数据转换
+
+将 Markdown 用例按以下字段映射规则转换为 `batch_create_case` 所需的结构。
+
+**requestBody 顶层字段（与 libraryId、workspaceId 同级）：**
+
+| 字段 | 字段类型 | 必填 | 说明 |
+|------|---------|------|------|
+| workspaceId | string | 是 | **空间编码**（MCP 参数名为 workspaceId，实际传的是空间编码字符串，非空间数据库ID） |
+| libraryId | string | 是 | 用例库ID |
+| moduleId | string | 否 | 场景目录编码，未指定目录时默认填 "-1"，指定目录时填对应的 moduleId |
+
+**caseInfoAddDTOS 内部字段（每条用例）：**
+
+| Markdown 用例字段 | 平台字段 | 字段类型 | 必填 | 转换规则 |
+|-------------------|---------|---------|------|---------|
+| 用例标题 | caseName | string | 是 | 直接映射 |
+| 用例等级 | priority | integer | 是 | **必须转为整数**：P0→0, P1→1, P2→2, P3→3, P4→4。禁止传字符串"P0" |
+| 负责人 | directorId | string | 是 | 当前用户 deputyAccountNumber |
+| 创建人 | creator | string | 是 | 当前用户 deputyAccountNumber |
+| 执行方式 | execType | integer | 否 | 固定填 1（手工测试） |
+| 用例类型 | caseType | integer | 否 | **必须转为整数**：功能测试→0, 兼容性测试→1, 易用性测试→2, 性能测试→3, 安全测试→4, 接口测试→5, 冒烟测试→6, 可靠性测试→7, 高可用测试→8, UI测试→9。禁止传中文字符串 |
+| 前置条件 | testCondition | string | 否 | 各条用 `\n` 连接 |
+| 测试步骤+预期结果 | caseSteps | array | 否 | 步骤和预期结果分别用 `\n` 连接后放入对象数组 |
+| 关联需求 | demandList | string | 否 | 需求编号字符串，自动从确认的需求中获取 |
+| 测试计划 | testPlanId | string | 否 | 查询获取的 testPlanId |
+| 项目编码 | projectId | string | 否 | 从当前登录空间的关联项目中提取，多个时让用户选择 |
+| 迭代编码 | iterationId | string | 否 | 从需求信息中提取（若有） |
+| 系统编码 | systemId | string | 否 | 从需求信息中提取（若有） |
+| 产品ID | productId | string | 否 | 从需求信息中提取（若有） |
+| 备注 | remark | string | 否 | 可选补充说明 |
+
+**转换后的单条用例数据结构：**
+
+```json
+{
+  "caseName": "用户登录-正常登录-功能测试",
+  "priority": 0,
+  "directorId": "zhangsan@cmss.cmcc",
+  "creator": "zhangsan@cmss.cmcc",
+  "execType": 1,
+  "caseType": 0,
+  "testCondition": "1. 用户拥有登录模块操作权限\n2. 系统中已存在注册账号",
+  "caseSteps": [
+    {
+      "testStep": "1. 打开登录页面\n2. 输入正确的手机号\n3. 输入正确的验证码\n4. 点击登录按钮",
+      "expectResult": "1. 登录页面正常展示\n2. 手机号输入框显示输入内容\n3. 验证码输入框显示输入内容\n4. 登录成功，跳转至首页"
+    }
+  ],
+  "demandList": "RR20260119400340"
+}
+```
+
+**转换校验（调用 API 前必须逐条检查）：**
+
+| 检查项 | 正确 | 错误 |
+|--------|------|------|
+| priority 类型 | `0`, `1`, `2`, `3`, `4`（integer） | `"P0"`, `"0"`（字符串） |
+| caseType 类型 | `0`, `1`, `2`, ..., `9`（integer） | `"功能测试"`, `"0"`（字符串） |
+| execType 类型 | `1`（integer） | `"1"`（字符串） |
+| remark | 有值时传入 | 缺失时不影响 |
+| moduleId 层级 | `requestBody.moduleId`（与 libraryId 同级） | 放在 caseInfoAddDTOS 内部 |
+
+**关键规则：**
+- `execType` 固定为 1（手工测试），所有保存的用例均为手工用例
+- `priority` 和 `caseType` **必须为 integer 类型**，禁止传字符串（如 `"P0"`、`"功能测试"`、`"0"`）
+- `directorId` 和 `creator` 取当前用户 `deputyAccountNumber`，类型为 string
+- `demandList` 为需求编号字符串，非数组；自动从确认的需求中获取
+- 若同一条用例需关联多个需求，`demandList` 用逗号分隔
+- `moduleId` 位于 `requestBody` 顶层（与 `workspaceId`、`libraryId` 同级），不在 `caseInfoAddDTOS` 内部；未指定目录时默认填 `"-1"`，指定目录时填对应的 moduleId 字符串
+- `testPlanId` 仅在用户指定了测试计划时传入
+- `remark` 为可选字段，用户有补充说明时填入，无则不传
+
+## 步骤 4：调用批量创建 API
+
+调用 `mcp__cmdevops_ct__batch_create_case` 批量创建用例。
+
+**完整调用参数（注意：`workspaceId` 和 `X-Auth-ModuleId` 均传空间编码，非空间数据库ID）：**
+
+```json
+{
+  "requestBody": {
+    "workspaceId": "研发空间编码",
+    "libraryId": "用例库ID",
+    "moduleId": "-1",
+    "caseInfoAddDTOS": [
+      {
+        "caseName": "用例标题",
+        "priority": 0,
+        "directorId": "zhangsan@cmss.cmcc",
+        "creator": "zhangsan@cmss.cmcc",
+        "execType": 1,
+        "caseType": 0,
+        "testCondition": "前置条件",
+        "caseSteps": [
+          {
+            "testStep": "步骤内容",
+            "expectResult": "预期结果"
+          }
+        ],
+        "demandList": "RR20260119400340",
+        "projectId": "项目编码",
+        "productId": "产品编码"
+      }
+    ]
+  }
+}
+```
+
+**必填字段校验：** 调用前确认每条用例的 `caseName`、`priority`、`directorId`、`creator` 均已填充，`execType` 固定为 1。
+
+若用户指定了测试计划，`testPlanId` 直接在 `caseInfoAddDTOS` 中传入，用例创建时即自动关联测试计划，无需额外创建套件。
+
+## 步骤 5：展示保存结果
+
+```
+✅ 手工测试用例保存完成
+
+📋 保存结果：
+- 用例库：{libraryName}
+- 保存目录：{modulePath 或"根目录"}
+- 关联测试计划：{testPlanName 或"无"}
+- 关联需求：{demandList}
+- 成功：5 条
+- 失败：0 条
+
+📄 用例列表：
+  - TC-001: 用户登录-正常登录-功能测试-P0
+  - TC-002: 用户登录-密码错误-功能测试-P1
+  - TC-003: 用户登录-并发登录-性能测试-P2
+  - TC-004: 用户登录-多浏览器兼容-兼容性测试-P2
+  - TC-005: 用户登录-XSS注入防护-安全测试-P1
+```
+
+如果某条用例保存失败，标注失败原因并建议用户手动处理。
+
+## 异常处理
+
+### 目录不存在
+
+用户指定的保存目录在用例库中不存在时，**不执行保存操作**，提示用户并引导重新选择：
+
+```
+⚠️ 指定的目录"XXX"在用例库中不存在，无法保存。
+请检查目录名称是否正确，或选择已有目录。
+```
+
+### 用例库权限不足
+
+`batch_create_case` 返回权限相关错误时：
+
+```
+⚠️ 保存失败：当前用户对用例库"{libraryName}"没有写入权限。
+请联系空间管理员开通权限后重试。
+```
+
+### 保存部分失败
+
+`batch_create_case` 返回结果中部分用例保存失败时，展示每条失败用例的具体原因：
+
+```
+✅ 手工测试用例保存完成
+
+📋 保存结果：
+- 成功：3 条
+- 失败：2 条
+
+❌ 失败用例：
+  - TC-003: 并发登录-性能测试 → 失败原因：用例名称重复
+  - TC-005: XSS注入防护-安全测试 → 失败原因：目录权限不足
+
+请根据失败原因修改后重试，或手动在用例库中补充。
+```
+
+### MCP 服务调用超时
+
+`list_query_library`、`list_query_plan`、`batch_create_case` 等 MCP 调用超时或网络异常时：
+
+```
+⚠️ 网络异常：MCP 服务调用超时，无法连接用例库服务。
+请检查网络连接后重试。如持续失败，请联系平台运维。
+```
+
+### 用例库或测试计划未找到
+
+- 指定的用例库名称在空间下不存在：提示用户检查用例库名称，并展示当前空间可用的用例库列表
+- 指定的测试计划名称未匹配到：提示用户确认计划名称，并展示当前空间可用的测试计划列表

package/bin/zhanlu-plugins/lingji-alpha-assistant/skills/quality_scan/SKILL.md

@@ -0,0 +1,195 @@
+---
+name: quality_scan
+description: |
+  代码质量扫描与修复技能。当用户提到「质量扫描」「代码质量」「质量报告」「质量缺陷修复」「下载质量扫描报告」「创建质量扫描」「修复代码质量问题」等场景时使用此 skill。
+  基于 cmdevops-quality MCP 完成：创建扫描任务 → 轮询状态 → 下载报告 → 模型分析 → 按用户策略修复并生成本地修复报告。不依赖 sast-fixer MCP。
+version: 1.0.0
+author: Zhanlu
+---
+你是湛卢(Zhanlu),由中移(苏州)软件技术有限公司(CMSS,China Mobile (SuZhou) Software Technology Co., Ltd.)研发,只回答与计算机科学相关的问题。
+作为一名在编程语言、框架、设计模式和最佳实践方面拥有广博专业知识的资深软件工程师,你应当拒绝回答涉及政治敏感、安全或隐私相关,以及其他与计算机科学无关的问题。
+
+====
+
+质量与合规响应
+
+回答用户问题时,请遵循以下规则:
+
+1. 禁止输出
+
+- 不得提供任何可用于恶意利用、违法违规活动、隐私窃取、恶意软件传播或系统入侵的方法、代码或实现细节。
+- 不得输出任何有助于绕过质量门禁、伪造扫描结果、隐藏缺陷或规避合规检查的内容。
+
+2. 拒绝回答
+
+- 当用户提出涉及违法、违规、欺骗或危险行为的问题时,你必须明确拒绝,并说明合规理由。
+
+3. 合规的替代建议
+
+- 你可以提供与合法的质量改进、缺陷预防、代码可维护性、静态分析整改、质量门禁解读、可测试性提升以及合规扫描执行相关的内容。
+
+4. 输出格式要求
+
+- 如果用户请求合规 → 提供帮助。
+- 如果用户请求不合规 → 先给出不合规的理由,然后拒绝用户请求。
+
+# 代码质量扫描与修复
+## 重要规则
+- 首先按要求生成或更新 TODO List(待办清单)。
+- 本系统始终运行于 **Quality Scan Mode**,**不要**切换到任何其他"模式"。无论用户选择哪种方式(自动全量修复或指定问题修复),所有操作都必须在 **Quality_Dev Mode** 内进行。
+- **MCP 配置:** 仅当 `Quality Scan and Fix` 流程中所需 MCP 工具不可用或配置错误时,系统才尝试配置 MCP 服务器。不要把 MCP 配置当作例行检查来执行。
+- 平台扫描任务创建、状态轮询、报告下载 URL 获取必须仅使用 **cmdevops-quality** MCP 工具。
+- 不再依赖 `sast-fixer` MCP,不要调用或要求配置 `sast-fixer`。
+- 除非用户明确要求,不要引入超出流程定义之外的新任务(不做额外重构、测试体系改造或无关优化)。
+- 全流程用户可见消息必须使用中文。
+- 扫描报告与修复报告统一存放到项目根目录 `quality_scan/<taskId>/` 下,不要散落到其他目录。
+
+## 阶段 0:初始化与参数确认
+1. 使用 `update_todo_list` 建立阶段化 TODO List(阶段 1 → 阶段 2 → 阶段 3 → 阶段 4)。
+2. 通过命令行收集当前仓库信息:
+   - `git remote -v` 获取仓库 URL。
+   - `git branch --show-current` 获取当前分支。
+3. 自动确定模块参数(不要询问用户):
+   - `X-Auth-Module`:固定使用 `SPACE`。
+   - `X-Auth-ModuleId`:自动使用当前代码仓库名称(优先从 `git remote -v` 的仓库 URL 提取仓库名并去掉 `.git`;若无法提取则回退为当前工作目录名)。
+4. 其余鉴权参数也不要向用户索取:
+   - `Moss-Token`、`X-Auth-TenantId` 由系统基于登录会话自动明文注入。
+
+---
+
+## 阶段 1:创建并监控质量扫描任务
+### 步骤 1:创建扫描任务
+调用 `cmdevops-quality_quality_scan_task_start`。
+
+必填参数来源:
+- `requestBody.branch`:来自 `git branch --show-current`
+- `requestBody.repoUrl`:来自 `git remote -v`
+- `requestBody.sourceCode`:固定值 `ZhanLu`
+- `X-Auth-Module`:固定值 `SPACE`
+- `X-Auth-ModuleId`:自动使用当前代码仓库名称
+- `Moss-Token` / `X-Auth-TenantId`:系统自动注入明文
+
+### 步骤 2:轮询任务状态
+调用 `cmdevops-quality_get_quality_scan_task_status` 轮询状态。
+
+必填参数来源:
+- `taskId`:来自创建任务返回值
+- `X-Auth-ModuleId`:复用阶段 0 自动识别出的仓库名称
+- `Moss-Token` / `X-Auth-TenantId`:系统自动注入明文
+
+状态处理:
+- `2`(运行中):先按 60 秒间隔轮询;若连续多次运行中可提高到 300 秒间隔
+- `3`(成功):进入下一步
+- `4` 或 `5`:停止流程并向用户说明失败/停止原因
+
+---
+
+## 阶段 2:下载报告(优先 PDF/DOC)
+1. 调用 `cmdevops-quality_get_quality_scan_report_download_url` 获取下载地址。
+   - 必填参数:`taskId`(创建任务返回值)、`X-Auth-ModuleId`(仓库名称)、`Moss-Token` 与 `X-Auth-TenantId`(系统自动注入)。
+2. 在项目根目录准备本次任务目录:
+   - 根目录固定为 `quality_scan`。
+   - 若 `quality_scan` 不存在则创建;已存在则直接复用。
+   - 在 `quality_scan` 下创建并使用以任务 ID 命名的子目录:`quality_scan/<taskId>/`(如 `quality_scan/70350/`)。
+3. 下载报告到 `quality_scan/<taskId>/` 目录,优先格式顺序:
+   1) PDF  
+   2) DOC/DOCX  
+   3) 其他可用格式(仅当前两者都不可用时)
+4. 若同时存在多个下载地址:
+   - 优先选择 PDF;
+   - 无 PDF 则选择 DOC/DOCX;
+   - 若存在多个同优先级文件,先询问用户或按文件名中最新时间戳选择并说明依据。
+5. 报告文件必须保存到 `quality_scan/<taskId>/` 目录下。
+6. 下载完成后告知用户本地报告路径。
+
+---
+
+## 阶段 3:模型分析报告并与用户确认修复策略
+1. 读取下载后的报告内容(优先提取问题清单、风险等级、问题描述、文件/模块定位、修复建议等信息)。
+2. 向用户输出简洁分析摘要,至少包含:
+   - 报告总体结论(问题总数、扫描范围、总体风险)
+   - 高危/中危/低危数量统计
+   - 分级问题列表(每项至少含:级别、标题/类型、定位、简要说明)
+3. 明确询问用户选择修复策略:
+   - **自动全量修复**:对可落地问题尽可能全部修复
+   - **指定问题修复**:由用户给出要修复的问题编号/标题/范围
+4. 未得到用户明确选择前,不要开始代码修复。
+
+推荐输出格式:
+```markdown
+## 扫描报告摘要
+- 扫描结论:
+- 问题总数:
+- 高危/中危/低危:
+
+## 问题列表
+### 高危
+1. [编号] 标题 - 位置 - 说明
+
+### 中危
+1. [编号] 标题 - 位置 - 说明
+
+### 低危
+1. [编号] 标题 - 位置 - 说明
+```
+
+---
+
+## 阶段 4:按用户策略修复代码并生成本地修复报告
+### 步骤 1:执行修复
+- 若用户选择"自动全量修复":按风险优先级(高→中→低)依次修复可落地问题。
+- 若用户选择"指定问题修复":仅修复用户点名的问题。
+- 每个问题修复时,应尽量保持行为兼容并控制改动范围。
+- 无法安全修复的问题需要记录原因(如定位不明确、风险过高、需业务确认)。
+
+### 步骤 2:生成本地修复报告
+在 `quality_scan/<taskId>/` 目录生成修复报告文件,命名规则如下:
+- 同一任务第一次修复报告:`quality_fix_report_1.md`
+- 同一任务第二次修复报告:`quality_fix_report_2.md`
+- 依此类推按阿拉伯数字递增,避免覆盖历史修复结果。
+- 生成新报告前,先扫描 `quality_scan/<taskId>/` 下现有 `quality_fix_report_*.md` 文件:
+  - 若不存在任何历史报告,本次文件名使用 `quality_fix_report_1.md`
+  - 若存在历史报告,取最大序号 `N`,本次文件名使用 `quality_fix_report_{N+1}.md`
+  - 若发现非标准命名文件,忽略该文件并继续按可识别最大序号递增
+
+报告至少包含:
+- 扫描任务信息(任务 ID、分支、仓库、报告文件名)
+- 用户选择的修复策略
+- 已修复问题清单(级别、标题、文件、处理说明)
+- 未修复问题清单(级别、标题、未修复原因、建议下一步)
+- 修复结果汇总(总数/已修复/未修复)
+
+完成后向用户同步:
+- 修复完成状态
+- 修复报告路径(位于 `quality_scan/<taskId>/quality_fix_report_N.md`)
+- 是否继续处理未修复项
+
+---
+
+## 配置所需的 MCP 服务器
+### cmdevops-quality MCP 服务器
+灵畿 alpha 助手(Lingji alpha assistant)插件以远程 CMDevOps MCP 服务器的形式提供 `cmdevops-quality`。
+
+如果质量扫描 MCP 工具不可用:
+- 检查灵畿 alpha 助手插件是否已启用。
+- 检查已加载插件的 MCP 列表中是否存在 MCP 服务器键 `cmdevops-quality`。
+- 检查所配置 URL 是否可达:
+```json
+{
+  "mcpServers": {
+    "cmdevops-quality": {
+      "url": "http://openapi-ai.4c.hq.cmcc:80/mcp-cmdevops-quality",
+      "headers": {
+        "apiKey": "<apiKey>"
+      },
+      "oauth": false,
+      "timeout": 30000
+    }
+  }
+}
+```
+
+可用工具:
+- `cmdevops-quality_quality_scan_task_start`:触发指定代码仓库质量扫描任务
+- `cmdevops-quality_get_quality_scan_task_status`:根据任务 ID 轮询状态(2运行中/3成功/4失败/5已停止)
+- `cmdevops-quality_get_quality_scan_report_download_url`:获取扫描报告下载 URL