一键生成需求分析&测试check list

Skill 标识
qa-architect-requirement-specialist

评审前先把需求拆透:从 PRD 和截图中梳理业务链路、状态变化与技术风险,同时产出需求分析文档和开发自测 Checklist,让测试与研发对齐同一套验收依据。

扫码添加辅导员,发送 Skill 名称领取源码
本文目录
  1. Skill 概览
  2. 适合谁、用在什么场景
  3. 需要准备什么、能得到什么
  4. 核心能力与使用边界
  5. 实战教程与使用说明
  6. 一、为什么需要这个 Skill?
  7. 二、这个 Skill 是什么?解决什么问题?
  8. 三、适用人群与典型场景
  9. 四、输入与输出
  10. 4.1 你需要提供什么(输入)
  11. 4.2 你会得到什么(输出)
  12. 五、在 Cursor 里怎么用?
  13. 六、分析质量是怎么保障的?
  14. 6.1 能力矩阵(expertise-matrix.md)
  15. 6.2 专家 Checklist(qa-expert-checklist.md)
  16. 6.3 报告结构规范(output-template.md)
  17. 6.4 开发用 Checklist 模板(dev-checklist-template.md)
  18. 6.5 填写原则(在 SKILL.md 中)
  19. 七、Skill 目录结构(给想二次开发或迁移的测试人)
  20. 八、小结与使用建议
  21. 九、实操&附件下载

Skill 概览

适合谁、用在什么场景

参加需求评审、联调验收及开发自测协作的测试工程师和质量负责人。

需要准备什么、能得到什么

  • 输入材料:PRD 或需求截图、业务描述及补充约束。
  • 交付产物:结构固定的需求分析文档与开发用需求测试点 Checklist。

核心能力与使用边界

  • 核心能力:通过能力矩阵、专家检查项和输出模板分析显性需求、隐性风险与验证方向。
  • 使用边界:技术风险是待验证方向;材料未给出的规则需确认,不能替产品决策。

实战教程与使用说明


一、为什么需要这个 Skill?

做需求分析和测试设计的同事大多有过类似经历:

  • PRD 或原型一摞:产品给的是飞书文档、几张截图或原型图,结论要自己梳理成「业务全景、状态机、测试点、风险」,写进分析文档。

  • 文档格式不统一:有时用 Word,有时用 Confluence,有时临时贴几段话,领导和开发看得费劲,评审时对不齐。

  • 隐性需求容易漏:幂等性、主从延迟、兼容性、可观测性——需求里经常不写,但线上容易出事,分析时不知道从哪几层过一遍。

  • 开发要一份「能照着测」的清单:光有需求分析不够,开发自测、联调验收时希望有一份可勾选的测试点清单,和需求一一对应,而不是在长文档里自己扒。

如果有一件事能自动完成——你提供「PRD 或需求截图 + 简单文字说明」,AI 帮你做深度解构、技术风险预判、隐性需求检查,并输出一份结构固定的需求分析文档 + 一份可直接给开发看的 Checklist——就能把更多时间留给评审沟通和用例细化。

资深质量架构师(QA Architect & Requirement Specialist)Skill 就是为这个场景设计的:在 Cursor 里,通过一个可复用的 Skill,把「PRD/截图 + 描述」变成「需求分析文档 + 开发用需求测试点 Checklist」。


二、这个 Skill 是什么?解决什么问题?

资深质量架构师是一个 Cursor Agent Skill(技能),主要做三件事:

  1. 看你的需求素材:支持 PRD 全文、需求文档(文本),或 1 张或多张需求相关图片(原型图、流程图、界面截图等),以及你补充的文字描述(场景、关注点等);支持图文混合。

  2. 做专业需求分析:结合内置的「能力矩阵」与「专家 Checklist」,按固定工作流:深度解析(Context、角色权限、状态机)→ 技术风险预判(数据流、性能边界、逆向异常流)→ 输出高级测试点,从截图和描述里提取功能/模块,按「架构级 / 业务级 / 性能安全」做分层分析,并强制过一遍幂等性、一致性、兼容性、可观测性四类隐性需求。

  3. 输出两份标准文档:

    1. 需求分析完整文档:包含「业务全景图、逻辑与状态机、深度测试点、风险建议/缺陷预警」四部分;多图时按图1、图2…组织,便于评审与追溯。

    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 里怎么用?

  1. 确保 Skill 已启用

    1. 将 qa-architect-requirement-specialist 放到当前项目或 Cursor 可识别的技能目录中(如 .cursor/skills/),并在 Cursor 里启用/引用该 Skill(具体方式以你使用的 Cursor 版本为准)。

  2. 发起一次对话

    1. 在对话中上传 PRD 文本或 1 张乃至多张需求相关图片(粘贴或拖拽),并用文字简单说明业务/模块、关注点(见上一节)。

    2. 明确说出你的需求,例如:

      • 「根据这些截图和描述做需求分析,并输出开发用 Checklist。」

      • 「对这份 PRD 做需求分析,保存到 output。」

      • 「这是门诊医生站的三张界面图,请做图片需求分析,按图序号整理,并生成开发用 Checklist。」

  3. 触发词(任选其一或组合即可)

    1. 「需求分析」「PRD 解构」「测试点设计」「图片需求分析」「截图需求」「多图需求」「质量架构」「风险预判」「状态机梳理」「做质量保证」「风险治理」。

  4. 等待生成

    1. AI 会按 Skill 内的工作流:深度解析 → 技术风险预判 → 输出高级测试点 → 过专家 Checklist → 填写需求分析四部分 → 同步产出开发用 Checklist。

    2. 若你要求保存,两份文档会写入 output/ 或你指定的路径。

  5. 查看与二次编辑

    1. 需求分析文档与 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文档

开始使用 qa-architect-requirement-specialist

扫码添加辅导员,发送 Skill 名称,领取源码与配套资料。

同类 Skills