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 和 TXT 格式的统计报表

支持的章节命名：

• 测试细则
• 测试用例
• 测试用例列表
• 测试用例汇总
• 附录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
# 使用默认配置同步
python scripts/test_sync.py

# 或指定参数
python scripts/test_sync.py -j 545 -i "C:\path\to\testcase"

目录结构：

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

参数说明： | 参数 | 简写 | 说明 | 默认值 | |—–|——|——|——–| | –url | -u | 平台基础地址 | https://testforgeplus.trustie.net | | –username | -n | 登录账号 | floraachy | | –password | -w | 登录密码 | (加密密码) | | –project | -j | 项目ID | 544 | | –input | -i | 测试用例目录 | C:\autogencase\testcase |

完整工作流

步骤 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
# 使用默认配置同步
python scripts/test_sync.py

# 或指定项目ID和输入目录
python scripts/test_sync.py -j 545 -i "C:\输出\测试用例"

输出：

=== 同步完成 ===
总成功: 236
总失败: 0
已创建模块: 50
已创建测试用例: 234

安装

方式一：单独安装

# 安装 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

使用命令行参数配置：

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

testcase-sync-to-platform

使用命令行参数配置：

python scripts/test_sync.py -u "https://testforgeplus.trustie.net" -n "user" -w "password" -j 545 -i "C:\输出\测试用例"

目录结构规则

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

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

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

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

测试类型映射

testcase-sync-to-platform 根据测试用例中的”测试类型”字段自动匹配：

测试类型字段值	平台测试类型	typeId
功能测试	功能测试	1
性能测试	性能测试	2
接口测试	接口测试	3
安装测试/部署测试	安装部署	4
安全性测试/安全测试	安全性测试	5
配置测试	配置相关	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 scripts/test_sync.py -j 545 -i "C:\输出\测试用例"

示例 2：仅提取测试用例

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

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

示例 3：仅同步测试用例

cd testcase-sync-to-platform
# 使用默认配置
python scripts/test_sync.py

# 或指定参数
python scripts/test_sync.py -j 545 -i "C:\输出\测试用例"

故障排除

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

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

解决方法：

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

问题 2：登录失败

原因： 用户名或密码错误

解决方法：

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

问题 3：模块创建失败

原因： 网络问题或权限不足

解决方法：

• 检查网络连接
• 查看错误日志
• 确认项目ID是否正确

问题 4：Unicode编码错误

原因： Windows终端不支持特殊字符

解决方法：

• 已修复，使用ASCII字符替代特殊字符

相关资源

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

贡献

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

许可证

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