基于 CodeBuddy Skills 框架构建的 AI 驱动测试管理工具模板仓库，通过自然语言指令完成迭代管理、需求分析、测试用例生成和基线维护的全流程自动化。
| 功能 | 说明 | 触发指令示例 |
|---|---|---|
| 创建迭代 | 自动创建版本迭代目录结构，首次创建时清理示例数据 | 创建v1.2.0.0迭代 |
| 需求分析 | 解析原始需求，对比基线库，拆分功能模块并生成功能文档 | 分析v1.2.0.0需求 |
| 用例生成 | 基于功能文档生成迭代测试用例，同步输出 P0 级基线用例。支持 Excel（.xlsx）和 XMind（.xmind）两种格式 | 生成v1.2.0.0测试用例 |
| 基线合并 | 将迭代变更（新增/变更/下线）合并到基线库，更新基线用例 | 合并v1.2.0.0到基线库 |
所有指令必须包含版本号（格式：
vX.X.X.X），未提供版本号将提示补充。
ssv-partner-ai-tool/ │ ├── README.md # 项目说明 ├── 项目概述.md # 项目基本信息（名称、架构、角色、术语） │ ├── 知识库/ # 核心知识库（迭代库 + 基线库 双库架构） │ ├── 初始化清理脚本.py # 首次创建迭代时自动执行，清理示例数据后自动删除 │ ├── 知识库说明.md │ │ │ ├── 迭代库/ # 各版本迭代数据 │ │ ├── 迭代库目录文件说明.md │ │ └── v{X.X.X.X}/ # 版本迭代目录 │ │ ├── 原始需求.md # 产品原始需求 │ │ ├── 功能模块/ # 按业务拆分的功能文档 │ │ │ └── {模块名}/ │ │ │ └── {功能名}.md │ │ └── 测试用例/ # 生成的用例文件（迭代用例 + 基线用例） │ │ │ └── 基线库/ # 项目当前状态的功能基线 │ ├── 基线库目录文件说明.md │ ├── 合并记录.md # 迭代合并历史 │ ├── 功能模块/ # 基线功能文档（无迭代专属信息） │ ├── 测试用例/ # 纯净版基线用例（P0正向，无变更标记） │ └── 历史归档/ # 下线功能归档 │ └── .codebuddy/skills/ # AI 技能定义 ├── ssv-partner-manager/ # 核心技能：迭代管理与用例生成 │ ├── SKILL.md # 技能入口（触发条件、路由规则、参数校验） │ ├── assets/ # 模板资源 │ │ ├── 测试用例模板.xlsx # Excel 用例模板 │ │ └── 测试用例模板.xmind # XMind 用例模板 │ ├── references/ # 规则文档 │ │ ├── 迭代创建规则.md # 迭代目录创建流程 │ │ ├── 需求分析规则.md # 需求拆解与功能文档生成 │ │ ├── 用例分析规则.md # 用例设计策略与覆盖标准 │ │ ├── 用例输出规则.md # Excel/XMind 输出格式规范 │ │ ├── 基线合并规则.md # 四阶段合并流程 │ │ └── 自定义测试场景.md # 自定义场景扩展 │ └── scripts/ # 执行脚本 │ ├── 生成Excel.py # 基于 openpyxl 生成 .xlsx 文件 │ └── 生成XMind.py # 生成 XMind 2020+ 兼容的 .xmind 文件 └── xlsx-reader/ # 辅助技能：Excel 读取 └── scripts/ └── read_excel.py
项目启动 ──▶ 迭代启动 ──▶ 需求分析 ──▶ 用例生成 ──▶ 迭代结束 │ │ │ ┌────────────────────────────┘ ▼ ▼ 迭代库 ◀─────▶ 基线库（合并同步）
- 以本仓库为模板创建新项目仓库
- 打开
项目概述.md，补充项目名称、系统架构、用户角色等基本信息
项目概述是后续所有环节的前置依据，信息不完善时 AI 会暂停处理并提示补充。
指令：创建v{版本号}迭代
处理逻辑：
解析版本号 → 校验 vX.X.X.X 格式 ↓ 检测清理脚本是否存在（首次创建） ├─ 存在 → 执行清理：移除迭代库/基线库中的示例目录和示例内容 → 删除脚本 └─ 不存在 → 跳过 ↓ 检查目标版本目录是否已存在 ├─ 已存在 → 终止并提示 └─ 不存在 → 创建迭代目录（原始需求.md + 功能模块/）
创建完成后，手动将产品需求粘贴到 原始需求.md。
指令：分析v{版本号}需求
处理逻辑：
校验项目概述完整性 ├─ 不完善 → 暂停，提示补充项目概述 └─ 完善 → 继续 ↓ 扫描基线库功能模块 → 建立现有功能基线快照 ↓ 读取迭代目录下的原始需求.md → 条目化拆解（生成 REQ-xxx 编号） ↓ 逐条对比基线快照，判定变更类型： ├─ 基线无此功能 → 标记【新增】 ├─ 基线有但内容变化 → 标记【变更】，记录差异点 ├─ 基线有但需求要求移除 → 标记【下线】 └─ 无法确定 → 标记"待确认" ↓ 按业务模块拆分，在 功能模块/ 下生成结构化功能文档 （含功能入口、业务流程、约束条件、需求来源追溯） ↓ 输出分析汇总：目录结构 + 需求追溯映射 + 覆盖检查统计
指令：生成v{版本号}测试用例
处理逻辑：
读取迭代功能模块文档 → 提取可测功能点与业务规则 ↓ 场景设计：按功能点展开正向/异常/边界/兼容性场景 ↓ 用例生成：每个场景生成完整用例（模块、标题、优先级P0~P3、前置条件、步骤、预期结果） ↓ 文件输出：调用 Python 脚本生成 Excel / XMind 文件 ↓ 同步生成基线用例： ├─ 从全量用例中筛选：P0级 + 正向功能 + 非下线 ├─ 读取基线库最新基线用例文件 ├─ 逐条匹配（模块路径 + 用例标题）： │ ├─ 基线无 → 标记【新增】 │ ├─ 基线有但内容变化 → 标记【修改】 │ ├─ 基线有但迭代无 → 标记【删除】（从基线库补入列表） │ └─ 内容一致 → 无标记 └─ 输出带变更标记的基线用例到迭代目录
用例输出后，测试人员需根据需求对全量用例进行核对，查漏补缺；基线用例中的变更标记（新增/修改/删除）需同步到用例管理系统。
迭代目录下的基线用例带变更标记（供评审对比），基线库中的基线用例是纯净版（作为下次迭代的对比基准），两者通过合并操作衔接。
指令：合并v{版本号}到基线库
处理逻辑：
阶段1 - 校验 校验版本号格式 → 校验迭代目录存在 → 校验功能文档非空 ├─ 任一不通过 → 终止并提示 └─ 全部通过 → 进入阶段2 ↓ 阶段2 - 分析变更 遍历迭代功能模块文档 → 识别【新增】【变更】【下线】标记 → 逐一对比基线库对应文档 → 汇总变更清单 ↓ 阶段3 - 生成合并预览 输出变更汇总表（新增/变更/下线数量及文件路径） → 等待用户确认 ├─ 用户拒绝 → 终止 └─ 用户确认 → 进入阶段4 ↓ 阶段4 - 执行合并 功能文档合并： ├─【新增】→ 复制到基线库，转换为基线格式（移除迭代专属内容） ├─【变更】→ 合并到基线库对应文档，约束条件标注来源版本号 └─【下线】→ 移动到历史归档，添加归档头信息 ↓ 基线用例合并： ├─ 读取迭代基线用例（带标记版）+ 基线库基线用例（纯净版） ├─【新增】→ 移除标记，追加到基线库 ├─【修改】→ 移除标记，替换基线库中匹配用例 ├─【删除】→ 从基线库中移除该条 └─ 输出新的纯净版基线用例到基线库 ↓ 更新记录： 项目概述版本号 → 功能文档变更记录 → 基线库合并记录
合并完成后提交代码：git commit -m "合并 v{版本号} 迭代到基线库"
# 1. 以本仓库为模板创建新项目
# 2. 打开项目，补充 项目概述.md
# 3. 创建迭代
创建v1.0.0.0迭代
# 4. 粘贴需求到 原始需求.md，然后分析
分析v1.0.0.0需求
# 5. 生成测试用例，并根据需求人工核对一遍用例，查漏补缺
生成v1.0.0.0测试用例
# 6. 迭代完成后合并基线
合并v1.0.0.0到基线库
已有项目接入：若项目已处于持续开发中，可将当前最新版本的全量功能需求整理为一份完整需求文档，按步骤 3~6 执行一次完整流程，即可快速建立基线库，后续迭代在此基线基础上增量管理。
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
