一键生成需求分析&测试check list
- Skill 标识
qa-architect-requirement-specialist- 所属分类
- 软件测试 / 需求分析
评审前先把需求拆透:从 PRD 和截图中梳理业务链路、状态变化与技术风险,同时产出需求分析文档和开发自测 Checklist,让测试与研发对齐同一套验收依据。
本文目录
- Skill 概览
- 适合谁、用在什么场景
- 需要准备什么、能得到什么
- 核心能力与使用边界
- 实战教程与使用说明
- 一、为什么需要这个 Skill?
- 二、这个 Skill 是什么?解决什么问题?
- 三、适用人群与典型场景
- 四、输入与输出
- 4.1 你需要提供什么(输入)
- 4.2 你会得到什么(输出)
- 五、在 Cursor 里怎么用?
- 六、分析质量是怎么保障的?
- 6.1 能力矩阵(expertise-matrix.md)
- 6.2 专家 Checklist(qa-expert-checklist.md)
- 6.3 报告结构规范(output-template.md)
- 6.4 开发用 Checklist 模板(dev-checklist-template.md)
- 6.5 填写原则(在 SKILL.md 中)
- 七、Skill 目录结构(给想二次开发或迁移的测试人)
- 八、小结与使用建议
- 九、实操&附件下载
Skill 概览
适合谁、用在什么场景
参加需求评审、联调验收及开发自测协作的测试工程师和质量负责人。
需要准备什么、能得到什么
- 输入材料:PRD 或需求截图、业务描述及补充约束。
- 交付产物:结构固定的需求分析文档与开发用需求测试点 Checklist。
核心能力与使用边界
- 核心能力:通过能力矩阵、专家检查项和输出模板分析显性需求、隐性风险与验证方向。
- 使用边界:技术风险是待验证方向;材料未给出的规则需确认,不能替产品决策。
实战教程与使用说明
一、为什么需要这个 Skill?
做需求分析和测试设计的同事大多有过类似经历:
PRD 或原型一摞:产品给的是飞书文档、几张截图或原型图,结论要自己梳理成「业务全景、状态机、测试点、风险」,写进分析文档。
文档格式不统一:有时用 Word,有时用 Confluence,有时临时贴几段话,领导和开发看得费劲,评审时对不齐。
隐性需求容易漏:幂等性、主从延迟、兼容性、可观测性——需求里经常不写,但线上容易出事,分析时不知道从哪几层过一遍。
开发要一份「能照着测」的清单:光有需求分析不够,开发自测、联调验收时希望有一份可勾选的测试点清单,和需求一一对应,而不是在长文档里自己扒。
如果有一件事能自动完成——你提供「PRD 或需求截图 + 简单文字说明」,AI 帮你做深度解构、技术风险预判、隐性需求检查,并输出一份结构固定的需求分析文档 + 一份可直接给开发看的 Checklist——就能把更多时间留给评审沟通和用例细化。
资深质量架构师(QA Architect & Requirement Specialist)Skill 就是为这个场景设计的:在 Cursor 里,通过一个可复用的 Skill,把「PRD/截图 + 描述」变成「需求分析文档 + 开发用需求测试点 Checklist」。
二、这个 Skill 是什么?解决什么问题?
资深质量架构师是一个 Cursor Agent Skill(技能),主要做三件事:
看你的需求素材:支持 PRD 全文、需求文档(文本),或 1 张或多张需求相关图片(原型图、流程图、界面截图等),以及你补充的文字描述(场景、关注点等);支持图文混合。
做专业需求分析:结合内置的「能力矩阵」与「专家 Checklist」,按固定工作流:深度解析(Context、角色权限、状态机)→ 技术风险预判(数据流、性能边界、逆向异常流)→ 输出高级测试点,从截图和描述里提取功能/模块,按「架构级 / 业务级 / 性能安全」做分层分析,并强制过一遍幂等性、一致性、兼容性、可观测性四类隐性需求。
输出两份标准文档:
需求分析完整文档:包含「业务全景图、逻辑与状态机、深度测试点、风险建议/缺陷预警」四部分;多图时按图1、图2…组织,便于评审与追溯。
开发用需求测试点 Checklist:从分析结论提炼的可执行、可勾选条目,按「功能与界面、字段与接口、状态与权限、异常与边界、性能与安全」分块,带「来源」「开发自测」列,便于开发自测与联调验收。
解决的问题可以概括为:
分析产出效率:从「自己整理 PRD + 码字 + 列测试点」变成「提供 PRD/截图和说明 → 拿到需求分析文档 + 开发用 Checklist」。
分析规范性:分析逻辑和表述由 Skill 内的「报告结构说明」和「能力矩阵 / 专家 Checklist」约束,减少遗漏和随意发挥。
格式统一:每次生成的需求分析文档和 Checklist 都基于同一套模板,结构固定,便于团队沉淀和对外呈现。
开发可落地:开发拿到的是可勾选、带来源的 Checklist,而不是只有长文档,联调与验收有据可依。
三、适用人群与典型场景
角色 | 典型场景 |
测试工程师 / 测试分析 | 需求评审前需要快速产出「业务全景、状态机、深度测试点、风险建议」;多轮需求变更时,希望每轮分析结构一致、便于对比。 |
测试开发 / 业务测试 | 产品只给原型或截图,需要系统化拆解成需求分析文档,并给开发一份可自测的 Checklist,减少来回扯皮。 |
开发 / 产品 | 自己做需求澄清或技术方案时,需要一份「带状态机、数据流和风险挑战」的简要分析,而不是只有原始 PRD 段落。 |
典型使用场景:
单模块需求(如登录、订单、支付流程)需要完整分析并留档。
多页/多图原型,希望按图序号整理成一份完整需求分析,每条结论可追溯。
需要把「截图 + 口头结论」整理成正式需求分析文档 + 开发用 Checklist,便于归档或跨团队沟通。
需求评审/Kickoff 前,希望提前过一遍幂等性、一致性、兼容性、可观测性,并在风险建议里挑战模糊点。
四、输入与输出
4.1 你需要提供什么(输入)
必选之一:
文本:PRD 全文、需求文档、功能说明、接口/业务描述(可直接粘贴或提供文件路径)。
或图片:1 张或多张需求相关图片(原型图、流程图、界面截图等);在 Cursor 里可直接粘贴截图,或提供已保存的图片路径。
支持图文混合(例如「图1~图3 是界面,下面这段是补充说明」)。
建议补充:简短文字描述,例如:
业务背景或模块名(如「门诊医生站-排队与接诊」);
关注点(如「重点看状态流转和权限边界」);
环境或版本说明(可选)。
描述越清晰,生成的「业务全景图」和「风险建议」越贴你的实际诉求。
若为多图,分析结果会按图1、图2、… 组织章节或段落,使每条分析可对应到具体图片。
4.2 你会得到什么(输出)
文档 | 内容说明 |
需求分析完整文档 | 一、业务全景图:一句话核心商业逻辑与价值。<br>二、逻辑与状态机:核心状态节点、触发条件、合法/非法迁移;多图时按图号分节。<br>三、深度测试点:架构级(接口、数据一致性、索引等)、业务级(Happy Path、边界、逆向异常)、性能/安全(并发、权限、脱敏与审计);多图时按图号分节。<br>四、风险建议/缺陷预警:针对需求中的模糊点、矛盾点、遗漏点提出挑战与改进建议,可标注优先级与归属(需求澄清/设计补充/测试重点关注)。 |
开发用需求测试点 Checklist | 文档头(需求/模块名、分析日期、需求来源)。<br>一、功能与界面:按图/模块分节,每条含序号、测试点描述、来源、开发自测☐。<br>二、字段与接口校验:必填/格式/范围/接口等,开发自测☐。<br>三、状态与权限:状态迁移、角色边界、越权关注点,开发自测☐。<br>四、异常与边界:重复提交、超时回滚、边界值等,开发自测☐。<br>五、性能与安全(若适用):TPS/RT、脱敏、日志与审计等,开发自测☐。 |
默认先在对话中输出 Markdown;若你说「保存到 output」或指定路径,会写入两份文件:
需求分析_<模块或需求简称>_<日期>.md需求测试点Checklist_<模块或需求简称>_<日期>.md
默认目录为当前工作区下的
output/(若目录不存在会先创建)。该 Skill 不负责编写逐条详细测试用例、不生成 XMind 测试用例树,产出的是「需求分析结论 + 给开发用的检查清单」。
五、在 Cursor 里怎么用?
确保 Skill 已启用
将
qa-architect-requirement-specialist放到当前项目或 Cursor 可识别的技能目录中(如.cursor/skills/),并在 Cursor 里启用/引用该 Skill(具体方式以你使用的 Cursor 版本为准)。
发起一次对话
在对话中上传 PRD 文本或 1 张乃至多张需求相关图片(粘贴或拖拽),并用文字简单说明业务/模块、关注点(见上一节)。
明确说出你的需求,例如:
「根据这些截图和描述做需求分析,并输出开发用 Checklist。」
「对这份 PRD 做需求分析,保存到 output。」
「这是门诊医生站的三张界面图,请做图片需求分析,按图序号整理,并生成开发用 Checklist。」
触发词(任选其一或组合即可)
「需求分析」「PRD 解构」「测试点设计」「图片需求分析」「截图需求」「多图需求」「质量架构」「风险预判」「状态机梳理」「做质量保证」「风险治理」。
等待生成
AI 会按 Skill 内的工作流:深度解析 → 技术风险预判 → 输出高级测试点 → 过专家 Checklist → 填写需求分析四部分 → 同步产出开发用 Checklist。
若你要求保存,两份文档会写入
output/或你指定的路径。
查看与二次编辑
需求分析文档与 Checklist 均为 Markdown,用任意编辑器打开即可;如需微调表述或补充信息,可直接编辑,或让 AI 再改一版。
六、分析质量是怎么保障的?
要保证「分析有层次、结论有依据、Checklist 可落地」,Skill 里内置了四类资源,AI 在生成报告时会按需使用。
6.1 能力矩阵(expertise-matrix.md)
定义需求分析阶段的 5 大核心能力:业务与上下文解构、角色与权限分析、状态与生命周期、技术风险与数据流、测试点与质量保障设计。
约定运用顺序:1 → 2 → 3 → 4 → 5,并在步骤 4、5 中结合专家 Checklist 做隐性需求检查。
保证分析不只看「界面有什么」,而是从业务影响、角色边界、状态闭环、数据流与性能、测试点分层 逐层展开。
6.2 专家 Checklist(qa-expert-checklist.md)
分析时强制自检四类「隐性需求」:幂等性、一致性、兼容性、可观测性。
每类有「关注点、典型场景、检查方式、输出建议」,避免只写「正常流程」而忽略重复提交、主从延迟、老数据兼容、日志埋点等问题。
结论会体现在【风险建议/缺陷预警】中,并对未覆盖项给出优先级与改进建议。
6.3 报告结构规范(output-template.md)
明确定义需求分析文档四部分各自写什么、怎么写(业务全景图、逻辑与状态机的表格/描述、深度测试点的三个子维度、风险建议的优先级与归属)。
约定多图时按图号分节,保证每条分析可对应到具体图片。
约定双输出:需求分析完整文档 + 开发用需求测试点 Checklist,便于团队统一格式。
6.4 开发用 Checklist 模板(dev-checklist-template.md)
定义 Checklist 的文档头与五块结构(功能与界面、字段与接口、状态与权限、异常与边界、性能与安全)。
约定「序号、测试点描述、来源、开发自测☐」等列,便于开发勾选与追溯需求。
保证 Checklist 内容与需求分析文档中的【深度测试点】及专家 Checklist 结论一致。
6.5 填写原则(在 SKILL.md 中)
客观:基于 PRD/截图可见内容和用户描述进行分析,不臆测无依据的结论。
可读:结论与建议分条、分表列出;面向领导与开发,避免过多行话并适当解释术语。
可操作:风险建议尽量具体(如涉及幂等键、主从延迟、兼容字段时指明方向),并区分需求澄清、设计补充、测试重点关注。
综合以上,分析既有固定的工作流和结构,又有「能力矩阵 + 专家 Checklist + 输出/Checklist 模板」作支撑,适合作为团队内标准的需求分析与开发对接方式。
七、Skill 目录结构(给想二次开发或迁移的测试人)
只想用:只要保证
qa-architect-requirement-specialist整体被 Cursor 识别为 Skill,按上文「怎么用」操作即可。想改分析维度或 Checklist 项:可编辑
references/qa-expert-checklist.md、expertise-matrix.md。想改输出结构或 Checklist 分块:编辑
references/output-template.md、dev-checklist-template.md。想改保存路径或文件名规则:在
SKILL.md的「输出文档的保存与落盘」小节中调整。
八、小结与使用建议
资深质量架构师 Skill 面向的是「有 PRD 或需求截图、需要快速产出规范需求分析 + 开发用 Checklist」的场景,尤其适合软件测试工程师在 Cursor 里把「PRD/截图 + 描述」变成「可直接给领导、开发看的需求分析文档和可勾选 Checklist」。
分析有固定工作流(深度解析 → 技术风险预判 → 测试点设计)和专家 Checklist(幂等性、一致性、兼容性、可观测性),输出结构统一;你只需提供需求素材和简单说明,即可在几分钟内得到两份可分享、可归档的文档。
使用建议:
描述中尽量写清「业务/模块、关注点」,便于 AI 写好业务全景图和风险建议。
若有多张图(如多页原型),可一并上传,报告中会按图1、图2…分节并综合分析。
若你们有内部需求分析模板或 Checklist 分块习惯,可将通用部分沉淀进
references/对应文件,让生成结果更贴团队习惯。需求变更时,建议同步更新需求分析文档与开发用 Checklist,保持两份文档一致。
如果你在需求分析上经常耗时、文档格式不统一,或对隐性需求(幂等、一致性、兼容性、可观测性)拿不准,可以尝试把本 Skill 接入当前工作流,把重复性的「整理 PRD + 写分析 + 列 Checklist」交给 AI,把时间留给评审沟通和用例设计。
九、实操&附件下载
实操需求分析截图:
实际输出的需求分析文档&check list:
需求分析输出结果文档
check list文档
扫码添加辅导员,发送 Skill 名称,领取源码与配套资料。