wiki2doc
将 Confluence Wiki 页面内容转换为 Word 文档 (.docx) 的工具。
功能特性
- ✅ 自动登录 Confluence（支持账号密码）
- ✅ 提取页面标题（#title-text）
- ✅ 提取 #splitter-content 中的全部文本和图片
- ✅ 过滤 CSS 隐藏的图片（display:none / visibility:hidden）
- ✅ 图片自动转为 JPG 格式
- ✅ 排除 GIF/SVG/视频等非图片文件
- ✅ 保持文本与图片原始顺序
- ✅ 生成可编辑的 .docx Word 文档
- ✅ 支持单个 URL 或批量 URL 处理
- ✅ 自动创建 demand/ 输出目录
- ✅ 需求分析（检测遗漏点、矛盾点、不明确点）
- ✅ 自动生成结构化测试用例（支持多种测试设计方法）
- ✅ 输出测试用例到Markdown和Excel格式
- ✅ 完整自动化工作流：从Wiki到Excel的一键生成
使用方式
工具概览
本技能提供两种使用模式：
模式一：完整自动化流程（推荐）
一键完成从Wiki页面到测试用例Excel的完整转换：
/skill wiki2doc --auto http://10.225.1.76:8090/pages/viewpage.action?pageId=34556052
执行步骤：
- ✓ 从Wiki提取内容生成Word文档
- ✓ 分析需求检测遗漏点、矛盾点
- ✓ 自动生成测试用例（Markdown格式）
- ✓ 转换为Excel格式
模式二：独立工具使用
可以单独使用各个工具模块：
1. 基本用法：Wiki转Word（单个页面）
/skill wiki2doc http://10.225.1.76:8090/pages/viewpage.action?pageId=34556052
2. 批量处理（多个页面）
/skill wiki2doc --batch "http://10.225.1.76:8090/page1,http://10.225.1.76:8090/page2"
3. 需求分析
python bin/analyze/analyze_requirements.py demand/需求文档.docx
输出：
4. 测试用例生成
python bin/generate/generate_testcases.py demand/需求文档.docx
输出：
- Markdown格式测试用例
- JSON格式测试用例
5. Markdown转Excel
python bin/convert/md2excel.py demand/测试用例.md
输出：
输出位置
所有生成的文件保存在：
~/.claude/skills/wiki2doc/demand/
文件命名规范：
- Word文档：
{页面标题}.docx
- 分析报告：
{页面标题}_analysis_report.txt / .json
- 测试用例MD：
{页面标题}_testcases.md / .json
- 测试用例Excel：
{页面标题}_testcases.xlsx
安装依赖
首次使用前请确保已安装依赖：
pip install playwright beautifulsoup4 python-docx requests Pillow lxml
注意事项
示例
# 单个页面
/skill wiki2doc http://10.225.1.76:8090/pages/viewpage.action?pageId=34556052
# 批量处理三个页面
/skill wiki2doc --batch "http://10.225.1.76:8090/page1,http://10.225.1.76:8090/page2,http://10.225.1.76:8090/page3"
故障排查
| 问题 | 解决方案 |
|---|
| 登录失败 | 检查账号密码是否正确，或手动登录后重试 |
| 页面加载超时 | 检查网络连接，或尝试访问 URL 是否正常 |
提示 No such element: #splitter-content | 该页面结构不同，无法提取内容 |
| 图片未显示 | 图片可能被 CSS 隐藏，或链接失效 |
| 生成空文档 | 页面无有效内容，或标题提取失败 |
本技能由 Claude Code 自动生成，适用于内部知识管理场景。
