解析原始需求文档为 Markdown
npx skills add https://github.com/chyax98/twu --skill req-parser이 명령을 Claude Code에 복사하여 붙여넣어 스킬을 설치하세요
| name | req-parser |
| description | 解析原始需求文档为 Markdown |
| allowed-tools | Read, Write, Bash, Glob |
把各种格式的原始需求文档转换成统一的 Markdown 格式，确保可读性和可测试性。
original-requirements/（PDF/DOCX/图片等各种格式）cleaned-requirements/index.md、cleaned-requirements/assets/（图片）original-requirements/ 目录.claude/skills/req-parser/scripts/parse_doc.py，脚本会自动解析并生成 Markdown 片段到 chunks/assets/，在片段中插入占位符chunks/chunks/ 中的所有 Markdown 片段index.md（同时替换图片占位符为描述）解析脚本调用：
uv run .claude/skills/req-parser/scripts/parse_doc.py \
--input-dir "original-requirements" \
--output-dir "cleaned-requirements/chunks"
图片处理分两步：
步骤1：解析时
cleaned-requirements/assets/<!-- image: figure-1.png -->步骤2：生成 index.md 时
描述要求：
多模态分析引导：
在分析原型图或界面截图时，必须进行深度思考和详细描述：
描述格式要求：
常见问题及处理：
问题1：乱码
问题2：格式错乱
问题3：重复内容
将 chunks/ 下的所有文件合并到 index.md：
--- 分隔<!-- 来源：文件名.md -->解析时生成：
用户登录流程如下：
<!-- image: login-flow.png -->
AI 读取后替换为：
用户登录流程如下：
[流程图描述]
这是一个登录流程图，包含以下步骤：
1. 用户输入手机号和验证码
2. 系统验证验证码有效性
3. 验证成功后跳转到首页
4. 验证失败显示错误提示
图中还标注了两个分支：
- 验证码过期：提示"验证码已过期，请重新获取"
- 验证码错误：提示"验证码错误，还可尝试X次"
原文（乱码）：
用户可以上传图片，支持jpg、png、gif格式，大小不超过5MB。
用户可以上传图片，支持jpg、png、gif格式，大小不超过5MB。（重复）
修复后：
用户可以上传图片，支持jpg、png、gif格式，大小不超过5MB。
chunks/ 目录：
PRD.md
原型图.md
接口文档.md
合并后的 index.md：
<!-- 来源：PRD.md -->
# 产品需求文档
...
---
<!-- 来源：原型图.md -->
# 原型设计
...
---
<!-- 来源：接口文档.md -->
# 接口说明
...
cleaned-requirements/
├── index.md # 合并后的完整需求文档
├── chunks/ # 解析片段（按原文件名）
│ ├── 01-功能需求.md
│ ├── 02-接口文档.md
│ └── 03-原型说明.md
└── assets/ # 图片资源
├── figure-1.png
└── figure-2.png
| 错误 | 处理方式 |
|---|---|
| PDF 加密 | 提示用户提供解密密码 |
| 文件损坏 | 跳过并记录错误 |
| 编码问题 | 尝试自动检测编码（UTF-8, GBK, GB2312） |
| Docling 失败 | 降级使用 PyPDF2 |
| 图片识别失败 | 保留原图，添加"待补充"标记 |
uv run .claude/skills/req-parser/scripts/parse_doc.py \
--input-dir <输入目录> \
--output-dir <输出目录> \
[--force] # 强制覆盖已有文件
返回值：
输出：解析统计 JSON
{
"total": 5,
"success": 4,
"failed": 1,
"failed_files": ["encrypted.pdf"]
}
合并需求问题答案，生成完备需求
识别需求文档中的问题
测试用例生成器 - 基于等价类划分和边界值分析理论,按测试点(POINT)分批生成高质量测试用例,输出为 Markdown 格式。当用户执行 /testcase-gen 命令或需要生成测试用例时使用。
测试规划器 - 基于软件测试理论(场景法、等价类划分、边界值分析)将完备需求拆解为结构化的测试规划,输出测试项(ITEM)和测试点(POINT)。当用户执行 /testcase-plan 命令或需要生成测试规划时使用。