القائمة
解析原始需求文档为 Markdown
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
合并需求问题答案，生成完备需求
识别需求文档中的问题
测试用例生成器 - 基于等价类划分和边界值分析理论,按测试点(POINT)分批生成高质量测试用例,输出为 Markdown 格式。当用户执行 /testcase-gen 命令或需要生成测试用例时使用。
测试规划器 - 基于软件测试理论(场景法、等价类划分、边界值分析)将完备需求拆解为结构化的测试规划,输出测试项(ITEM)和测试点(POINT)。当用户执行 /testcase-plan 命令或需要生成测试规划时使用。
| 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"]
}