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=345560522. 批量处理（多个页面）
/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输出：
- JSON格式分析报告
- TXT格式人类可读报告
4. 测试用例生成
python bin/generate/generate_testcases.py demand/需求文档.docx输出：
- Markdown格式测试用例
- JSON格式测试用例
5. Markdown转Excel
python bin/convert/md2excel.py demand/测试用例.md输出：
- Excel格式测试用例表格
输出位置
所有生成的文件保存在：
~/.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注意事项
- 仅支持内网 Confluence（默认地址：http://10.225.1.76:8090/login.action）
- 默认账号：
yanghua，密码：Aa123123 - 图片将自动转换为 JPG，保留原始顺序
- 如果页面无
#splitter-content元素，将返回空文档 - 部分图片下载失败不影响其他内容
- 会话 Cookie 在运行期间保持，批量处理时无需重复登录
示例
# 单个页面
/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 自动生成，适用于内部知识管理场景。