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

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Kilo Code
+Copyright (c) 2025 opencode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/zhanlu-plugins/bundle-index.json

@@ -0,0 +1,60 @@
+{
+  "schemaVersion": 1,
+  "deliveryProfile": "default",
+  "sourceCommit": "unknown",
+  "profileDigest": "37a8eec1ce19687d132fe29051dca629d164e2c4958ba141d5f4133a33f0688f",
+  "plugins": [
+    {
+      "id": "lingji-alpha-assistant",
+      "name": "灵畿α助手",
+      "namespace": "灵畿α助手",
+      "version": "1.0.0",
+      "origin": "base",
+      "requiredEnv": [
+        "ZHANLU_CMDEVOPS_API_KEY"
+      ],
+      "components": {
+        "skills": [
+          "灵畿α助手:code-check",
+          "灵畿α助手:code-review",
+          "灵畿α助手:manual-test-case-generator",
+          "灵畿α助手:quality_scan",
+          "灵畿α助手:requirement-analysis",
+          "灵畿α助手:requirement-review",
+          "灵畿α助手:requirements-gather",
+          "灵畿α助手:sast_scan",
+          "灵畿α助手:story-decomposer"
+        ],
+        "agents": [],
+        "commands": [],
+        "mcpServers": [
+          "灵畿α助手:cmdevops-ct",
+          "灵畿α助手:cmdevops-quality",
+          "灵畿α助手:cmdevops-req",
+          "灵畿α助手:sast-fixer"
+        ]
+      }
+    },
+    {
+      "id": "lingji-beta-assistant",
+      "name": "灵畿β助手",
+      "namespace": "灵畿β助手",
+      "version": "1.0.0",
+      "origin": "base",
+      "requiredEnv": [],
+      "components": {
+        "skills": [
+          "灵畿β助手:beta-requirement-analysis",
+          "灵畿β助手:beta-requirement-decomposer",
+          "灵畿β助手:beta-requirement-review",
+          "灵畿β助手:beta-requirements-gather"
+        ],
+        "agents": [],
+        "commands": [],
+        "mcpServers": [
+          "灵畿β助手:lingji-beta"
+        ]
+      }
+    }
+  ]
+}

package/bin/zhanlu-plugins/lingji-alpha-assistant/.claude-plugin/plugin.json

@@ -0,0 +1,42 @@
+{
+  "name": "灵畿α助手",
+  "namespace": "灵畿α助手",
+  "version": "1.0.0",
+  "description": "灵畿α助手 — 支持需求工程、手工测试用例生成与入库、代码评审、安全扫描与质量扫描报告分析修复",
+  "author": { "name": "Zhanlu" },
+
+  "skills": "skills/",
+
+  "mcp_servers": {
+    "cmdevops-req": {
+      "url": "http://openapi-ai.4c.hq.cmcc:80/mcp-cmdevops-req",
+      "headers": {
+        "apiKey": "${ENV:ZHANLU_CMDEVOPS_API_KEY}"
+      },
+      "oauth": false,
+      "timeout": 30000
+    },
+    "sast-fixer": {
+      "command": "node",
+      "args": ["${ZHANLU_PLUGIN_ROOT}/mcps/sast_fixer_mcp/dist/index.mjs"]
+    },
+    "cmdevops-ct": {
+      "url": "http://openapi-ai.4c.hq.cmcc:80/mcp-cmdevops-ct",
+      "headers": {
+        "apiKey": "${ENV:ZHANLU_CMDEVOPS_API_KEY}"
+      },
+      "oauth": false,
+      "timeout": 30000
+    },
+    "cmdevops-quality": {
+      "url": "http://openapi-ai.4c.hq.cmcc:80/mcp-cmdevops-quality",
+      "headers": {
+        "apiKey": "${ENV:ZHANLU_CMDEVOPS_API_KEY}"
+      },
+      "oauth": false,
+      "timeout": 30000
+    }
+  },
+
+  "enabled": false
+}

package/bin/zhanlu-plugins/lingji-alpha-assistant/README.md

@@ -0,0 +1,29 @@
+# 灵畿α助手（内置 Plugin）
+随 Zhanlu CLI 分发的内置插件，提供需求工程、手工测试用例、安全扫描与质量扫描相关 Skill 及 CMDevOps MCP 集成。
+
+## 包含内容
+
+| 类型 | 说明 |
+|---|---|
+| **Skills** | `requirement-analysis`、`requirement-review`、`requirements-gather`、`story-decomposer`、`manual-test-case-generator`（手工测试用例生成/查询/入库）、`sast_scan`（四共 SAST 扫描 + 漏洞报告解析修复）、`quality_scan`（基于 `cmdevops-quality` 执行扫描、下载报告、模型分析与修复报告生成）、`code_review`（项目级代码评审）、`req_code_consistency_check`（需求-代码一致性检查） |
+| **MCP** | `cmdevops-req` → `http://openapi-ai.4c.hq.cmcc:80/mcp-cmdevops-req`（`apiKey` 请求头认证）；`cmdevops-ct` → `http://openapi-ai.4c.hq.cmcc:80/mcp-cmdevops-ct`（用例库查询与批量创建）；`cmdevops-quality` → `http://openapi-ai.4c.hq.cmcc:80/mcp-cmdevops-quality`（`apiKey` 请求头认证）；`sast-fixer`（本地内置 TypeScript MCP，主要供 `sast_scan` skill 使用） |
+
+Skill 目录名与运行时 ID 一致（如 `skills/sast_scan/` → `灵畿α助手:sast_scan`）。安全扫描与质量扫描已改为 Skill，不再提供独立 Agent。
+## 品牌用字（写 Skill / 对用户回复时强制）
+
+完整规范见仓库 [`packages/opencode/src/kilocode/brand-naming.md`](../../../brand-naming.md)（与运行时 `ZhanluLanguageReminder`、CI `check-forbidden-strings` 同源）。Skill 与对用户回复只写正确形式，勿罗列近音错写。
+
+正确用字：
+- zhanlu → 湛卢、湛卢 IDE
+- lingji → 灵畿、灵畿平台、灵畿α助手
+- kylin → 麒麟、银河麒麟
+- uos → 统信、统信 UOS
+- 账号登录语义使用「登录」
+## 覆盖安装
+
+如需修改 MCP `apiKey` 或其它配置，可将本目录复制到：
+
+- `~/.zhanlu/plugins/lingji-alpha-assistant/`（全局）
+- `<project>/.zhanlu/plugins/lingji-alpha-assistant/`（项目）
+
+用户目录中的同名插件会覆盖内置版本。

package/bin/zhanlu-plugins/lingji-alpha-assistant/mcps/sast_fixer_mcp/README.md

@@ -0,0 +1,10 @@
+# SAST MCP runtime artifact
+
+This directory is the bundled plugin runtime target for `sast-fixer`.
+
+The TypeScript source lives in `packages/sast-fixer-mcp`. During the opencode CLI
+build, `packages/sast-fixer-mcp/dist/index.mjs` is copied here as
+`dist/index.mjs`, matching the path used by the plugin manifest.
+This runtime directory must stay artifact-only: keep `README.md` and `dist/index.mjs`.
+Do not run package manager commands in this folder, and do not keep `node_modules`
+or source files here.

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

@@ -0,0 +1,179 @@
+---
+name: req_code_consistency_check
+description: 用户输入GitLab仓库地址及需求编号，自动完成代码拉取、需求文档获取和需求-代码一致性评审，生成结构化MD报告
+version: 1.0.0
+author: ReqCodeCheck Team
+trigger_words:
+  - 需求代码一致性
+  - 一致性检查
+  - 代码需求一致性检查
+  - 需求代码核对
+  - 需求评审
+  - 需求代码校验
+  - 核对需求代码
+  - 需求一致性
+instructions: |
+  【强制要求】必须严格按照以下步骤顺序执行，不可跳步或调整顺序：
+
+  **步骤0**: 输入解析与工作目录创建
+  - 解析用户输入，支持以下三种格式：
+    
+    **格式1 - 手动输入需求编号**：
+    - GitLab仓库URL + 需求编号列表（逗号或空格分隔）+ [可选：分支名]
+    - 示例：`需求代码一致性 https://gitlab.com/group/project.git REQ-001,REQ-002 main`
+    
+    **格式2 - 从 Excel 文件读取（通过 @ 选择文件）**：
+    - 用户在输入中通过 `@` 符号附加 Excel 文件
+    - 系统检测到 `.xlsx` 或 `.xls` 文件后，自动提取文件路径
+    - 调用 `scripts/read_excel_requirements.py` 读取 Excel 文件
+    - 自动智能识别包含需求编号的列（优先匹配含"需求"、"编号"等关键词的列）
+    - 获取需求编号列表
+    - 示例：`对需求编号 @需求编号.xlsx 与项目http://code-cmss.rdcloud.4c.hq.cmcc/osc/CMSS/lvjin-cmss.cmcc/mini-apiserver.git进行一致性检查`
+    
+    **格式3 - 从 Excel 文件读取（直接输入文件路径）**：
+    - 用户在输入中直接提供 Excel 文件的完整路径
+    - 系统检测到路径中包含 `.xlsx` 或 `.xls` 扩展名
+    - 调用 `scripts/read_excel_requirements.py` 读取 Excel 文件
+    - 自动智能识别包含需求编号的列
+    - 获取需求编号列表
+    - 示例：`对需求编号文件 D:\需求编号.xlsx 与项目http://code-cmss.rdcloud.4c.hq.cmcc/osc/CMSS/lvjin-cmss.cmcc/mini-apiserver.git进行一致性检查`
+    
+  - 从GitLab URL提取项目名称
+  - 生成工作目录：`D:\ReqCodeCheck_[项目名]_[时间戳]`
+  - 创建子目录：`{工作目录}\code\` 和 `{工作目录}\doc\`
+  - 输出工作目录路径和需求列表给用户
+
+  **步骤1**: 代码拉取与需求文档获取
+  - 📖 首先读取 `prompts/step1_preparation.md` 获取详细执行指南
+  - 调用 `scripts/gitlab_clone.py` 拉取GitLab代码到 `{工作目录}\code\`（仅执行一次）
+  - 对于每个需求编号：
+    - 调用MCP `cmdevops-req` 获取需求文档
+    - 保存为 `{工作目录}\doc\requirement_[需求编号].md`
+  - 若某需求获取失败，记录警告但继续处理其他需求
+  - 若MCP未安装，提示用户在湛卢Code 插件市场安装后重试 <!-- zhanlu_change -->
+  - ✅ 完成后在终端输出: "✅ 步骤1完成：代码与需求文档已准备就绪"
+
+  **步骤2**: 多需求一致性校验与报告生成
+  - 📖 首先读取 `prompts/step2_consistency_check.md` 获取详细执行指南
+  - 对于每个需求：
+    - 从 `{工作目录}\doc\` 读取对应需求文档
+    - 按照6大维度11个评审点逐项校验：
+      1. 核心功能实现完整性（功能点全覆盖、方法/接口匹配）
+      2. 业务逻辑与校验完整性（业务逻辑、参数与数据校验）
+      3. 边界与异常处理合规性（边界场景、异常场景处理）
+      4. 调用与参数传递正确性（服务/接口调用、参数传递）
+      5. 代码结构与实现合理性（代码层级、实现方式）
+      6. 额外功能管控（未定义功能排查）
+    - 记录该需求的评审结果和符合度
+  - 汇总所有需求的评审结果
+  - 生成综合报告 `需求代码一致性评审报告.md`，包含各需求独立章节和汇总对比表格
+  - 保存报告到 `{工作目录}\需求代码一致性评审报告.md`
+  - ✅ 完成后在终端输出: "✅ 步骤2+3完成：一致性校验与评审报告已生成"
+
+  ⚠️ **重要提醒**：
+  - 每个步骤开始前，必须先读取对应的提示词文件（prompts/step*.md）
+  - 严格按照提示词文件中的要求执行，不得跳过任何子步骤
+  - 评审标准详见 `prompts/step2_consistency_check.md`
+  - 禁止输出任何乱码、不可见字符、问号乱码串、特殊控制符、零宽空格
+  - GitLab Token配置：首次使用前需在 `config/gitlab_config.json` 中配置您的GitLab Token
+  - 工作目录默认创建在 D盘根目录
+  - 支持单个或多个需求编号输入，多个需求用逗号或空格分隔
+---
+
+# 需求代码一致性校验 Skill
+
+## 角色定位
+
+你是拥有10年以上后端开发与架构评审经验的**高级代码评审工程师**，精通需求-代码对齐校验、业务逻辑完整性验证与代码规范审查。本次需基于提供的「需求文档」与「项目代码」，开展需求与代码一致性专项评审。
+
+---
+
+## 评审核心目标
+
+1. 验证代码实现与需求文档的**功能点100%对齐**，无遗漏、无反向实现、无理解偏差
+2. 核查业务逻辑、边界处理、参数校验等关键环节的完整性与合规性
+3. 识别超出需求定义的额外功能、不符合架构规范的代码问题
+4. 按问题严重程度分级输出结论，明确影响范围与可落地的修复建议
+
+---
+
+## 执行流程
+
+本Skill采用四阶段执行流程，每个阶段的详细操作指南请参考对应的提示词文件：
+
+### 第一步：输入解析与工作目录创建
+
+📖 **详细指南**：`prompts/step1_preparation.md`
+
+核心任务：
+- 解析用户输入（GitLab URL + 需求编号列表 + 可选分支名）
+- 从GitLab URL提取项目名称
+- 创建工作目录 `D:\ReqCodeCheck_[项目名]_[时间戳]`
+- 创建代码存放子目录 `code\` 和需求文档子目录 `doc\`
+
+⚠️ 必须严格按照提示词文件中的要求执行，完成后在终端输出完成标记。
+
+---
+
+### 第二步：代码拉取与需求文档获取
+
+📖 **详细指南**：`prompts/step1_preparation.md`
+
+核心任务：
+- 调用GitLab克隆脚本拉取代码到 `{工作目录}\code\`（仅执行一次）
+- 对于每个需求编号：
+  - 调用MCP `cmdevops-req` 获取需求文档
+  - 保存为 `{工作目录}\doc\requirement_[需求编号].md`
+- 若某需求获取失败，记录警告但继续处理其他需求
+
+⚠️ 若MCP未安装，提示用户在湛卢Code 插件市场安装后重试。 <!-- zhanlu_change -->
+
+---
+
+### 第三步：多需求一致性校验与报告生成
+
+📖 **详细指南**：`prompts/step2_consistency_check.md`
+
+核心任务：
+- 对于每个需求：
+  - 从 `{工作目录}\doc\` 读取对应需求文档
+  - 按6大维度11个评审点逐项校验
+  - 记录该需求的评审结果和符合度
+- 汇总所有需求的评审结果
+- 生成综合评审报告，包含各需求独立章节和汇总对比表格
+- 保存报告到 `{工作目录}\需求代码一致性评审报告.md`
+
+⚠️ 必须严格按照提示词文件中的要求执行，完成后在终端输出完成标记。
+
+---
+
+## 输出要求与使用说明
+
+📖 **详细说明**：`prompts/step2_consistency_check.md`（包含完整的报告生成模板）
+
+**核心要求**：
+1. 客观准确：每个问题需给出明确判定依据
+2. 建设性：提供可落地的修改方案
+3. 风险分级：清晰区分严重问题与一般性问题
+4. 报告保存：必须保存为 `需求代码一致性评审报告.md`
+5. 禁止输出任何乱码、不可见字符、特殊控制符、零宽空格
+
+**触发方式**：
+- 说出触发词："需求代码一致性"、"需求代码核对"、"需求评审"等
+- 指定格式（手动输入）：`需求代码一致性 <GitLab仓库URL> <需求编号列表> [分支名]`
+- 指定格式（@选择文件）：`需求代码一致性 <GitLab仓库URL> @<Excel文件路径> [分支名]`
+- 指定格式（直接路径）：`需求代码一致性 <GitLab仓库URL> <Excel文件完整路径> [分支名]`
+- 示例：
+  - 单个需求：`需求代码一致性 https://gitlab.com/group/project.git REQ-2024-001 main`
+  - 多个需求：`需求代码一致性 https://gitlab.com/group/project.git REQ-2024-001,REQ-2024-002,REQ-2024-003 main`
+  - @选择文件：`对需求编号 @需求编号.xlsx 与项目http://code-cmss.rdcloud.4c.hq.cmcc/osc/CMSS/lvjin-cmss.cmcc/mini-apiserver.git进行一致性检查`
+  - 直接路径：`对需求编号文件 D:\需求编号.xlsx 与项目http://code-cmss.rdcloud.4c.hq.cmcc/osc/CMSS/lvjin-cmss.cmcc/mini-apiserver.git进行一致性检查`
+
+**注意事项**：
+- 工作目录默认创建在 D盘根目录
+- 代码存放在 `{工作目录}\code\` 目录
+- 需求文档存放在 `{工作目录}\doc\` 目录
+- 评审结果仅供参考，最终修复决策需结合业务实际情况
+- 支持单个或多个需求编号，多个需求用逗号或空格分隔
+- 支持三种方式提供需求编号：手动输入、@符号选择Excel文件、直接输入Excel文件路径
+- Excel 文件会自动智能识别需求编号列（支持常见列名如"需求编号"、"Requirement ID"等）

package/bin/zhanlu-plugins/lingji-alpha-assistant/skills/code-check/config/gitlab_config.json

@@ -0,0 +1,5 @@
+{
+  "gitlab_token": "",
+  "default_branch": "main",
+  "git_path": "git"
+}

package/bin/zhanlu-plugins/lingji-alpha-assistant/skills/code-check/prompts/step1_preparation.md

@@ -0,0 +1,167 @@
+# 步骤1：代码拉取与需求文档获取
+
+本指南详细说明如何完成代码拉取和需求文档获取工作。
+
+## 1.1 解析用户输入
+
+从用户输入中提取以下信息：
+- **GitLab仓库URL**：以 https://gitlab.com/ 或 http://gitlab. 开头的URL
+- **需求编号来源**：支持三种方式
+  - 方式1：直接提供需求编号列表（逗号或空格分隔）
+  - 方式2：通过 `@` 符号附加 Excel 文件（如 `@需求编号.xlsx`），系统自动读取
+  - 方式3：直接输入 Excel 文件的完整路径（如 `D:\需求编号.xlsx`），系统自动识别并读取
+- **分支名**（可选）：用户指定则使用，否则使用默认分支（main）
+
+输入格式示例：
+- 单个需求：需求代码一致性检查 https://gitlab.com/group/project.git REQ-2024-001 main
+- 多个需求：需求代码一致性检查 https://gitlab.com/group/project.git REQ-2024-001,REQ-2024-002,REQ-2024-003 main
+- 空格分隔：需求代码一致性检查 https://gitlab.com/group/project.git REQ-2024-001 REQ-2024-002 main
+- Excel文件（@选择）：对需求编号 @需求编号.xlsx 与项目http://code-cmss.rdcloud.4c.hq.cmcc/osc/CMSS/lvjin-cmss.cmcc/mini-apiserver.git进行一致性检查
+- Excel文件（直接路径）：对需求编号文件 D:\需求编号.xlsx 与项目http://code-cmss.rdcloud.4c.hq.cmcc/osc/CMSS/lvjin-cmss.cmcc/mini-apiserver.git进行一致性检查
+
+Excel 文件处理：
+- 当检测到输入中包含 `.xlsx` 或 `.xls` 文件时（通过 `@` 符号或直接路径）
+- 提取 Excel 文件的完整路径
+  - 如果是 `@` 符号附加，提取 `@` 后的路径
+  - 如果是直接路径，识别路径中的 `.xlsx` 或 `.xls` 文件引用
+- 调用 `scripts/read_excel_requirements.py` 脚本读取需求编号
+- 脚本会智能识别 Excel 中包含需求编号的列
+- 识别策略：
+  1. 优先匹配列名包含"需求"、"编号"、"requirement"、"req"、"id"等关键词的列
+  2. 如果未找到匹配列，默认使用第一列
+- 输出逗号分隔的需求编号列表
+
+## 1.1.1 Excel 文件处理（如适用）
+
+如果用户输入中包含 Excel 文件（通过 `@` 符号或直接路径）：
+
+1. 从用户输入中提取 Excel 文件路径
+   - 检测输入中的 `.xlsx` 或 `.xls` 文件引用
+   - 支持两种形式：
+     a. `@` 符号附加：提取 `@` 后的完整路径
+     b. 直接路径：识别输入中的文件路径（如 `D:\需求编号.xlsx`）
+   - 提取完整的文件路径
+   
+2. 验证 Excel 文件路径是否存在
+
+3. 调用脚本读取需求编号：
+   ```powershell
+   python scripts/read_excel_requirements.py --excel-path "<Excel文件路径>"
+   ```
+
+4. 解析脚本输出的需求编号列表（逗号分隔）
+
+5. 如果读取失败，提示用户检查文件路径和文件格式
+
+6. 继续后续步骤，使用读取到的需求编号列表
+
+成功输出示例：
+✓ 成功读取 Excel 文件
+  文件路径: D:\需求编号.xlsx
+  需求编号: CMSSR2511D2DC03-874,CMSSR2511D2DC03-757,CMSSR2511D2DC03-848
+
+失败处理：
+- 文件不存在：提示用户检查文件路径
+- 文件格式错误：提示用户使用标准的 .xlsx 格式
+- 未找到需求编号列：提示用户确保 Excel 中包含需求编号列
+
+---
+
+## 1.2 创建工作目录
+
+目录命名规则：D:\ReqCodeCheck_[项目名]_[时间戳]
+- 项目名：从GitLab URL中提取（最后一个路径段，去除.git后缀）
+- 时间戳格式：yyyyMMdd_HHmmss
+- 示例：D:\ReqCodeCheck_project_20260518_152000
+
+执行步骤：
+1. 从GitLab URL提取项目名称
+2. 生成目录名称
+3. 使用 PowerShell 创建目录
+4. 在工作目录下创建 code\ 子目录用于存放代码
+5. 在工作目录下创建 doc\ 子目录用于存放需求文档
+6. 终端输出工作目录路径和需求列表
+
+## 1.3 拉取GitLab代码
+
+调用脚本：python scripts/gitlab_clone.py --url <URL> --path <工作目录>\code\ [--branch <分支名>]
+
+脚本说明：
+- 使用 gitlab_clone.py 脚本拉取代码
+- 脚本会自动使用 config/gitlab_config.json 中的GitLab Token进行认证
+- 支持浅克隆（--depth 1）以提高拉取速度
+
+成功输出示例：
+✓ 代码拉取成功！
+本地路径: D:\ReqCodeCheck_REQ-2024-001_xxx\code
+
+失败处理：
+- Token无效：提示用户检查 config/gitlab_config.json 中的Token
+- 权限不足：提示用户确认仓库访问权限
+- 网络问题：提示检查网络连接
+
+## 1.4 获取需求文档
+
+调用MCP：使用 MCP 工具调用 cmdevops-req 获取需求文档
+
+MCP工具说明：
+- MCP名称：cmdevops-req
+- 工具名称：get_requirement
+- 参数：requirement_id - 需求编号
+
+多需求处理流程：
+1. 在工作目录下创建 doc\ 子目录（如果尚未创建）
+2. 对于每个需求编号：
+   a. 调用MCP获取该需求的文档内容
+   b. 将需求文档保存为：{工作目录}\doc\requirement_[需求编号].md
+   c. 若获取失败，记录错误信息但继续处理下一个需求
+3. 输出已成功获取的需求编号列表
+
+获取成功时：
+- 文档内容应为完整的需求规格说明
+
+MCP未安装处理：如果MCP cmdevops-req 未安装或调用失败，显示提示请用户在湛卢IDE插件市场搜索并安装需求管理MCP后重试。
+
+## 1.5 验证准备完成
+
+验证清单：
+- [ ] 工作目录已创建
+- [ ] code\ 子目录已创建
+- [ ] doc\ 子目录已创建
+- [ ] 代码已拉取到 {工作目录}\code\
+- [ ] 所有需求文档已保存到 {工作目录}\doc\（列出成功获取的需求编号列表）
+
+终端输出示例：
+✅ 步骤1完成：代码与需求文档已准备就绪
+ - 工作目录：{工作目录}
+ - 代码路径：{工作目录}\code
+ - 需求文档目录：{工作目录}\doc
+ - 已获取需求：REQ-2024-001, REQ-2024-002, ...
+
+## 1.6 错误处理汇总
+
+| 错误场景 | 处理方式 |
+|----------|----------|
+| GitLab Token未配置 | 提示用户配置 config/gitlab_config.json |
+| GitLab Token无效 | 提示用户更换Token |
+| 仓库访问被拒绝 | 提示用户检查仓库权限 |
+| MCP未安装 | 提示用户在插件市场安装 |
+| MCP调用失败 | 提示用户检查MCP配置 |
+| 目录创建失败 | 提示检查D盘权限 |
+
+## 1.7 快速参考
+
+完整执行命令示例：
+1. 创建工作目录及子目录
+New-Item -ItemType Directory -Path "D:\ReqCodeCheck_project_20260518_152000\code" -Force
+New-Item -ItemType Directory -Path "D:\ReqCodeCheck_project_20260518_152000\doc" -Force
+
+2. 拉取代码
+python scripts/gitlab_clone.py --url "https://gitlab.com/group/project.git" --path "D:\ReqCodeCheck_project_20260518_152000\code" --branch "main"
+
+3. 循环调用MCP获取多个需求文档（伪代码）：
+$requirements = @("REQ-2024-001", "REQ-2024-002", "REQ-2024-003")
+foreach ($reqId in $requirements) {
+    # 使用 @mcp cmdevops-req get_requirement --requirement_id $reqId
+    # 保存结果到 "D:\ReqCodeCheck_project_20260518_152000\doc\requirement_$reqId.md"
+}