Testcase Automation Skills

本仓库包含一组用于测试用例自动化的 Skill，可以独立使用或组合使用。

概述

这些 Skill 提供从 Word 文档提取测试用例、转换为标准化格式、同步到测试管理平台等完整的工作流。

核心流程：

Word 文档 → 测试用例提取 → 标准化格式 → 同步到平台

Skills 列表

1. word-testcase-extractor（测试用例提取）

AI 驱动的测试用例提取工具，从 Word 文档自动提取测试用例并转换为标准化自然语言格式。

功能：

• ✅ 支持 .docx 格式
• ✅ 从 Word 文档提取测试项和测试用例
• ✅ 自动关联测试项与测试用例（通过测试追踪字段）
• ✅ 按”测试类型 > 测试项.txt”结构组织输出
• ✅ 生成 Word 和 TXT 格式的测试用例统计报表
• ✅ 输入及操作步骤自动生成自增序号
• ✅ 兼容性强：支持多种章节命名和测试类型
• ✅ 命令行参数支持：可提取任意Word文档

快速开始：

cd word-testcase-extractor
pip install -r requirements.txt
cd scripts
# 使用默认配置提取
python extract_testcases.py

# 或指定任意Word文档
python extract_testcases.py -d "C:\path\to\document.docx" -o "C:\path\to\output"

配置说明：

支持命令行参数指定路径：

# 完整参数说明
python extract_testcases.py --help

# 指定文档和输出目录
python extract_testcases.py -d "C:\测试文档\测试大纲.docx" -o "C:\输出\测试用例"

# 简写形式
python extract_testcases.py --doc "input.docx" --output "output"

参数说明： | 参数 | 简写 | 说明 | |—–|——|——| | –doc | -d | Word文档路径（必填） | | –output | -o | 输出目录路径（必填） | | –process | -p | 过程文件目录（可选） |

目录结构：

word-testcase-extractor/
├── SKILL.md              # Skill 文档（核心规范）
├── requirements.txt      # 依赖文件
├── scripts/              # 脚本目录
│   └── extract_testcases.py  # 主入口脚本
└── extraction_workspace/ # 辅助文件/过程文件目录
    └── extracted_cases.json

核心流程：

1. 读取 Word 文档
2. 分析文档结构，定位”计划执行的测试项”和测试用例章节
3. 提取测试项和测试用例信息
4. 通过测试追踪字段关联测试项与测试用例
5. 按测试类型组织输出到 testcase 目录
6. 生成 Word 格式的统计报表

支持的章节命名：

• 测试细则
• 测试用例
• 测试用例列表
• 测试用例汇总
• 附录A 测试细则
• 附录B 测试细则

支持的测试类型（动态识别）：

• 功能测试、安全性测试、边界测试、性能测试、兼容性测试
• 接口测试、集成测试、回归测试、压力测试、单元测试等

输出示例：

testcase/
├── 功能测试/
│   └── 功能测试项1-Github跨平台关联功能.txt
├── 安全性测试/
│   └── 安全性测试项1-用户安全防护.txt
├── 边界测试/
│   └── 边界测试项1-数值型参数边界值测试.txt
├── 性能测试/
│   └── 性能测试项1-开源项目承载能力测试.txt
├── 兼容性测试/
│   └── 兼容性测试项1-浏览器兼容性测试.txt
├── 测试用例统计.docx
└── 测试用例统计.txt

2. testcase-sync-to-platform（测试用例同步）

将本地编写的测试用例同步到测试管理平台。

功能：

• ✅ 自动构建模块层级结构
• ✅ 智能匹配测试类型
• ✅ 批量同步
• ✅ 详细同步报告

快速开始：

cd testcase-sync-to-platform
pip install -r requirements.txt
# 编辑 test_sync.py 配置平台信息
python test_sync.py

目录结构：

testcase-sync-to-platform/
├── SKILL.md              # Skill 文档
├── README.md             # 快速入门
├── requirements.txt      # 依赖文件
├── test_sync.py          # 主入口脚本
└── utils/               # 工具类目录
    ├── sync_client.py    # 同步客户端
    ├── module_builder.py # 模块构建器
    └── testcase_parser.py # 测试用例解析器

完整工作流

步骤 1：提取测试用例

cd word-testcase-extractor/scripts
# 使用默认配置
python extract_testcases.py

# 或指定文档路径
python extract_testcases.py -d "C:\测试文档\测试大纲.docx" -o "C:\输出\测试用例"

输出：

testcase/
├── 功能测试/
│   └── 功能测试项1-Github跨平台关联功能.txt
├── 安全性测试/
│   └── 安全性测试项1-用户安全防护.txt
├── 边界测试/
│   └── 边界测试项1-数值型参数边界值测试.txt
├── 性能测试/
│   └── 性能测试项1-开源项目承载能力测试.txt
├── 兼容性测试/
│   └── 兼容性测试项1-浏览器兼容性测试.txt
├── 测试用例统计.docx
└── 测试用例统计.txt

步骤 2：同步到平台

cd ../testcase-sync-to-platform
# 编辑 test_sync.py 配置平台信息
python test_sync.py

输出：

=== 同步完成 ===
总成功: 248
总失败: 0
已创建模块: 63
已创建测试用例: 222

安装

方式一：单独安装

# 安装 word-testcase-extractor
cd word-testcase-extractor
pip install -r requirements.txt

# 安装 testcase-sync-to-platform
cd ../testcase-sync-to-platform
pip install -r requirements.txt

方式二：共享依赖

# 安装所有依赖
pip install python-docx requests

配置说明

word-testcase-extractor

在 utils/config.py 中配置文档路径：

DOC_PATH = r"c:\autogencase\系统测试大纲(含细则)-20260604.docx"
OUTPUT_DIR = r"c:\autogencase\testcase"

testcase-sync-to-platform

在 test_sync.py 中配置平台信息：

client = TestcaseSyncClient(
    base_url="https://testforgeplus.trustie.net",
    username="floraachy",
    password="wIFnUVLCrLjJPjX+H8IY6w==",
    project_id=543
)

目录结构规则

word-testcase-extractor 按”测试类型 > 测试项.txt”的扁平结构组织输出：

testcase/
├── 功能测试/
│   ├── 功能测试项1-Github跨平台关联功能.txt
│   └── ...
├── 安全性测试/
│   ├── 安全性测试项1-用户安全防护.txt
│   └── ...
├── 边界测试/
│   └── ...
├── 性能测试/
│   └── ...
├── 兼容性测试/
│   └── ...
└── 测试用例统计.docx

测试类型目录（自动识别）：

• 功能测试
• 安全性测试
• 边界测试
• 性能测试
• 兼容性测试
• 接口测试
• 其他自定义测试类型

测试类型映射

前缀	测试类型	typeId
gn_	功能测试	1
xn_	性能测试	2
jk_	接口测试	3
az_	安装部署	4
aq_	安全性测试	5
pz_	配置相关	6
其他	其他	7

示例

示例 1：提取并同步完整流程

# 1. 提取测试用例
cd word-testcase-extractor/scripts
python extract_testcases.py -d "C:\测试文档\测试大纲.docx" -o "C:\输出\测试用例"

# 2. 同步到平台
cd ../../testcase-sync-to-platform
python test_sync.py

示例 2：仅提取测试用例

cd word-testcase-extractor/scripts
# 使用默认配置
python extract_testcases.py

# 或指定文档
python extract_testcases.py -d "C:\测试文档\测试大纲.docx" -o "C:\输出\测试用例"

示例 3：仅同步特定模块

编辑 test_sync.py 中的目录路径，指向特定模块的目录。

故障排除

问题 1：未提取到测试用例

原因： 文档格式不符合要求

解决方法：

• 检查文档是否使用标准标题样式
• 确认测试用例使用表格格式

问题 2：登录失败

原因： 用户名或密码错误

解决方法：

• 检查用户名密码是否正确
• 检查平台是否可访问

问题 3：模块创建失败

原因： 父模块不存在或网络问题

解决方法：

• 检查网络连接
• 查看错误日志

相关资源

• GitLink CLI - GitLink 命令行工具
• GitLink Skills - 更多 Skill

贡献

欢迎提交 Issue 和 Pull Request 来改进这些 Skill！

许可证

本项目遵循项目的开源许可证。