研发协作
需要为功能或发布编写 QA 测试计划、手工测试用例…
当 QA 工程师要围绕某功能/发布快速产出测试计划、手工用例、回归套件、设计验证清单和 bug 报告时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
需要为功能或发布编写 QA 测试计划、手特定
解决思路
- 仅在显式调用时激活:通过 `/qa-test-planner`、`qa-test-planner` 或 `use the skill qa-test-planner` 调用。
- 创建测试计划:使用请求「Create a test plan for the user authentication feature」。
- 生成手工测试用例:使用请求「Generate manual test cases for the checkout flow」。
- 构建回归测试套件:使用请求「Build a regression test suite for the payment module」。
- 对照 Figma 验证:使用请求「Compare the login page against the Figma design at [URL]」。
- 创建 bug 报告:使用请求「Create a bug report for the form validation issue」。
- 生成测试计划时输出策略、范围、排期、风险,预计 10-15 分钟。
- 生成测试用例时输出分步说明、预期结果,每个 5-10 分钟。
- 生成回归套件时输出冒烟测试、关键路径、执行顺序,预计 15-20 分钟。
- 执行 Figma 验证时输出设计-实现比较、差异列表,预计 10-15 分钟。
- 创建 bug 报告时输出可复现步骤、环境、证据,预计 5 分钟。
- 分析阶段:解析功能/需求。
- 分析阶段:识别需要的测试类型。
- 分析阶段:确定范围和优先级。
- 生成阶段:创建结构化交付物。
- 生成阶段:应用模板和最佳实践。
- 生成阶段:包含边界情况和变体。
- 验证阶段:检查完整性。
- 验证阶段:验证可追溯性。
- 验证阶段:确保步骤可执行。
- 使用交互式脚本 `./scripts/generate_test_cases.sh` 逐步提示创建测试用例。
- 使用交互式脚本 `./scripts/create_bug_report.sh` 通过引导输入收集生成 bug 报告。
- 自然语言请求「Create test plan for {feature}」生成完整测试计划文档。
- 自然语言请求「Generate {N} test cases for {feature}」生成带步骤的编号测试用例。
- 自然语言请求「Build smoke test suite」生成关键路径测试。
- 自然语言请求「Compare with Figma at {URL}」生成视觉验证清单。
- 自然语言请求「Document bug: {description}」生成结构化 bug 报告。
- 测试计划交付物包含测试范围和目标。
- 测试计划交付物包含测试方法和策略。
- 测试计划交付物包含环境需求。
- 测试计划交付物包含进入/退出标准。
- 测试计划交付物包含风险评估。
- 测试计划交付物包含时间线和里程碑。
- 手工测试用例交付物包含分步说明。
- 手工测试用例交付物包含预期与实际结果。
- 手工测试用例交付物包含前置条件和设置。
- 手工测试用例交付物包含测试数据需求。
- 手工测试用例交付物包含优先级和严重性。
- 回归套件交付物包含冒烟测试(15-30 分钟)。
- 回归套件交付物包含完整回归(2-4 小时)。
- 回归套件交付物包含定向回归(30-60 分钟)。
- 回归套件交付物包含执行顺序和依赖。
- Figma 验证交付物包含逐组件比较。
- Figma 验证交付物包含间距和排版检查。
- Figma 验证交付物包含颜色和视觉一致性。
- Figma 验证交付物包含交互状态验证。
- Bug 报告交付物包含清晰复现步骤。
- Bug 报告交付物包含环境细节。
- Bug 报告交付物包含证据(截图、日志)。
- Bug 报告交付物包含严重性和优先级。
- 避免模糊测试步骤;改为具体操作 + 预期结果。
- 避免缺少前置条件;记录所有设置要求。
- 避免没有测试数据;提供样本数据或生成方法。
- 避免通用 bug 标题;使用具体格式「[Feature] issue when [action]」。
- 避免跳过边界情况;包含边界值、null。
- 验证测试计划:范围明确定义(in/out)。
- 验证测试计划:指定进入/退出标准。
- 验证测试计划:识别风险及缓解措施。
- 验证测试计划:时间线现实。
- 验证测试用例:每个步骤都有预期结果。
- 验证测试用例:记录前置条件。
- 验证测试用例:测试数据可用。
- 验证测试用例:分配优先级。
- 验证 bug 报告:可复现步骤。
- 验证 bug 报告:记录环境。
- 验证 bug 报告:附截图/证据。
- 验证 bug 报告:设置严重性/优先级。
- 参考文件:使用 `references/test_case_templates.md` 获取所有测试类型的标准格式。
- 参考文件:使用 `references/bug_report_templates.md` 获取文档模板。
- 参考文件:使用 `references/regression_testing.md` 获取套件构建和执行指南。
- 参考文件:使用 `references/figma_validation.md` 获取设计-实现验证指南。
- 使用标准测试用例格式,包含 TC-001 标题、Priority、Type、Status。
- 标准测试用例格式包含 Objective(测试什么及为什么)。
- 标准测试用例格式包含 Preconditions(设置要求、测试数据)。
- 标准测试用例格式包含 Test Steps,每步有 Action 和 Expected。
- 标准测试用例格式包含 Test Data(输入、用户、配置)。
- 标准测试用例格式包含 Post-conditions(系统状态、清理)。
- 标准测试用例格式包含 Notes(边界情况、相关用例、已知问题)。
- 测试类型覆盖 Functional(业务逻辑,如有效凭据登录)。
- 测试类型覆盖 UI/Visual(外观、布局,如按钮匹配 Figma 设计)。
- 测试类型覆盖 Integration(组件交互,如 API 向前端返回数据)。
- 测试类型覆盖 Regression(现有功能,如之前功能仍可用)。
- 测试类型覆盖 Performance(速度、负载,如页面 3 秒内加载)。
- 测试类型覆盖 Security(漏洞,如防止 SQL 注入)。
- 测试计划模板包含 Executive Summary(被测功能/产品、测试目标、关键风险、时间线概览)。
- 测试计划模板包含 Test Scope 的 In Scope(要测试的功能、测试类型、平台和环境、用户流程和场景)。
- 测试计划模板包含 Test Scope 的 Out of Scope(不测试的功能、已知限制、第三方集成如果适用)。
- 测试计划模板的 Test Strategy 包含 Test Types:手工测试、探索性测试、回归测试、集成测试、用户验收测试。
- 测试计划模板的 Test Strategy 包含 Test Approach:黑盒测试、正向和负向测试、边界值分析、等价类划分。
- 测试计划模板包含 Test Environment(操作系统、浏览器和版本、设备、测试数据需求、后端/API 环境)。
- 测试计划模板包含 Entry Criteria:需求已文档化、设计已定稿、测试环境就绪、测试数据已准备、构建已部署。
- 测试计划模板包含 Exit Criteria:所有高优先级测试用例已执行、90%+ 用例通过率、所有严重 bug 已修复、无开放高严重性 bug、回归套件已通过。
- 测试计划模板包含 Risk Assessment 表(风险、概率、影响、缓解)。
- 测试计划模板包含 Test Deliverables:测试计划文档、测试用例、测试执行报告、bug 报告、测试总结报告。
- Bug 报告模板包含 BUG-[ID] 具体标题、Severity、Priority、Type、Status。
- Bug 报告模板包含 Environment:OS、Browser、Device、Build、URL。
- Bug 报告模板包含 Description。
- Bug 报告模板包含 Steps to Reproduce。
- Bug 报告模板包含 Expected Behavior。
- Bug 报告模板包含 Actual Behavior。
- Bug 报告模板包含 Visual Evidence:截图、视频、控制台错误。
- Bug 报告模板包含 Impact:用户影响、频率、临时解决方案。
- Bug 报告模板包含 Additional Context:相关功能/ticket、是否回归、Figma 设计链接。
- 严重性定义:Critical (P0):系统崩溃、数据丢失、安全问题;示例支付失败、登录损坏。
- 严重性定义:High (P1):主要功能损坏、无临时方案;示例搜索不工作。
- 严重性定义:Medium (P2):功能部分受损、有临时方案;示例筛选缺少一个选项。
- 严重性定义:Low (P3):外观问题、罕见边界情况;示例拼写错误、轻微对齐。
- Figma 验证前置条件:配置 Figma MCP server。
- Figma 验证前置条件:可访问 Figma 设计文件。
- Figma 验证前置条件:组件/页面的 Figma URL。
- 从 Figma 获取设计规格,例如「Get the button specifications from Figma file [URL]」。
- 设计规格响应包含尺寸、颜色、排版、间距、圆角、状态。
- 比较实现:在浏览器 dev tools 检查主按钮。
- 比较实现:对照 Figma 规格比较尺寸、圆角、背景色、字体。
- 比较实现:记录差异。
- 如果不匹配创建 bug:标题说明主按钮颜色不匹配设计。
- 不匹配 bug 包含 Severity、Expected (Figma)、Actual (Implementation)、截图、Figma 链接。
- 验证颜色:Hex 值精确,使用浏览器颜色拾取器。
- 验证间距:Padding/margin px,使用 DevTools computed styles。
- 验证排版:字体、字号、字重,使用 DevTools font panel。
- 验证布局:宽度、高度、位置,使用 DevTools box model。
- 验证状态:Hover、active、focus,手动交互。
- 验证响应式:断点行为,使用 DevTools device mode。
- 示例查询:「Get button specifications from Figma design [URL]」。
- 示例查询:「Compare navigation menu implementation against Figma design」。
- 示例查询:「Extract spacing values for dashboard layout from Figma」。
- 示例查询:「List all color tokens used in Figma design system」。
- 回归套件结构:Smoke,15-30 分钟,每日,仅关键路径。
- 回归套件结构:Targeted,30-60 分钟,每次变更,受影响区域。
- 回归套件结构:Full,2-4 小时,每周/发布,全面覆盖。
- 回归套件结构:Sanity,10-15 分钟,hotfix 后,快速验证。
- 构建回归套件 Step 1:识别关键路径——用户不能缺少什么。
- 构建回归套件 Step 1:识别关键路径——什么产生收入。
- 构建回归套件 Step 1:识别关键路径——什么处理敏感数据。
- 构建回归套件 Step 1:识别关键路径——什么使用最频繁。
- 构建回归套件 Step 2:按优先级排序测试用例——P0 业务关键、安全,始终运行。
- 构建回归套件 Step 2:P1 主要功能、常见流程,每周+运行。
- 构建回归套件 Step 2:P2 次要功能、边界情况,发布时运行。
- 构建回归套件 Step 3 执行顺序:先 smoke,失败则停止并修复构建。
- 执行顺序:然后 P0 测试,必须通过才能继续。
- 执行顺序:然后 P1 再 P2,跟踪所有失败。
- 执行顺序:最后探索性测试,发现意外问题。
- 通过标准:所有 P0 测试通过;90%+ P1 测试通过;无开放严重 bug。
- 失败(阻止发布):任何 P0 测试失败;发现严重 bug;安全漏洞;数据丢失场景。
- 有条件:P1 失败但有临时方案;已知问题已文档化;修复计划已就位。
- 测试运行报告模板:包含 Release Version、Date、Build、Tester、Environment。
- 测试运行报告摘要:Total、Executed、Passed、Failed、Blocked、Not Run、Pass Rate。
- 测试运行报告按优先级统计 Test Cases by Priority。
- 测试运行报告包含 Critical Failures。
- 测试运行报告包含 Blocked Tests。
- 测试运行报告包含 Risks。
- 测试运行报告包含 Next Steps。
- 覆盖率跟踪:使用 Coverage Matrix,包含 Feature、Requirements、Test Cases、Status、Gaps。
- QA 流程 Phase 1 Planning:评审需求和设计。
- Phase 1 Planning:创建测试计划。
- Phase 1 Planning:识别测试场景。
- Phase 1 Planning:估算工作量和时间线。
- Phase 1 Planning:搭建测试环境。
- Phase 2 Test Design:编写测试用例。
- Phase 2 Test Design:与团队评审测试用例。
- Phase 2 Test Design:准备测试数据。
- Phase 2 Test Design:构建回归套件。
- Phase 2 Test Design:获取 Figma 设计访问权限。
- Phase 3 Execution:执行测试用例。
- Phase 3 Execution:记录带清晰步骤的 bug。
- Phase 3 Execution:针对 UI 测试对照 Figma 验证。
- Phase 3 Execution:跟踪测试进度。
- Phase 3 Execution:沟通阻塞。
- Phase 4 Reporting:汇总测试结果。
- Phase 4 Reporting:分析覆盖率。
- Phase 4 Reporting:记录风险。
- Phase 4 Reporting:提供 go/no-go 建议。
- Phase 4 Reporting:归档测试工件。
- 测试用例编写 DO:具体且无歧义。
- 测试用例编写 DO:每个步骤包含预期结果。
- 测试用例编写 DO:每个测试用例只测试一件事。
- 测试用例编写 DO:使用一致命名约定。
- 测试用例编写 DO:保持测试用例可维护。
- 测试用例编写 DON'T:不要假设知识。
- 测试用例编写 DON'T:不要让测试用例过长。
- 测试用例编写 DON'T:不要跳过前置条件。
- 测试用例编写 DON'T:不要忘记边界情况。
- 测试用例编写 DON'T:不要留下模糊预期结果。
- Bug 报告 DO:提供清晰复现步骤。
- Bug 报告 DO:包含截图/视频。
- Bug 报告 DO:指定准确环境细节。
- Bug 报告 DO:描述对用户的影响。
- Bug 报告 DO:UI bug 链接到 Figma。
- Bug 报告 DON'T:不要没有复现步骤就报告。
- Bug 报告 DON'T:不要使用模糊描述。
- Bug 报告 DON'T:不要跳过环境细节。
- Bug 报告 DON'T:不要忘记分配优先级。
- Bug 报告 DON'T:不要重复已有 bug。
- 回归测试 DO:尽可能自动化重复测试。
- 回归测试 DO:定期维护回归套件。
- 回归测试 DO:优先关键路径。
- 回归测试 DO:频繁运行冒烟测试。
- 回归测试 DO:每次发布后更新套件。
- 回归测试 DON'T:不要在发布前跳过回归。
- 回归测试 DON'T:不要让套件过时。
- 回归测试 DON'T:不要每次测试所有内容。
- 回归测试 DON'T:不要忽略失败的回归测试。
- 示例登录流程测试用例:TC-LOGIN-001 Valid User Login,Priority P0,Type Functional,预计 2 分钟。
- 示例登录流程:Objective 验证有效凭据成功登录。
- 示例登录流程:Preconditions 用户账户存在、未登录、清除浏览器 cookies。
- 示例登录流程步骤:导航到 https://app.example.com/login,预期显示登录页。
- 示例登录流程步骤:输入 email test@example.com,预期接受输入。
- 示例登录流程步骤:输入 password Test123!,预期掩码显示。
- 示例登录流程步骤:点击 Login,预期加载指示、重定向 /dashboard、欢迎消息、头像显示。
- 登录后条件:创建用户会话、存储 auth token、记录分析事件。
- 登录边界情况:无效密码、不存在邮箱、SQL 注入、超长密码。
- 示例响应式设计测试用例:TC-UI-045 Mobile Navigation Menu,Priority P1,Type UI/Responsive,设备 mobile。
- 响应式测试 Objective:验证移动设备导航菜单正常。
- 响应式 Preconditions:移动设备或响应式模式,viewport 375px 到 428px。
- 响应式步骤:打开首页,预期 hamburger 菜单图标可见。
- 响应式步骤:点击 hamburger,预期菜单从右滑入、overlay、关闭按钮。
- 响应式步骤:点击菜单项,预期导航并关闭菜单。
- 响应式步骤:对照 Figma 移动设计,预期菜单宽度 280px、动画 300ms ease-out、overlay opacity 0.5 #000000、字体 16px line-height 24px。
- 响应式测试断点:375px、390px、428px、360px。
适用边界 · 注意事项
- 仅在显式调用时触发;不适合期望自动隐式触发的场景。
- 需要 Figma 验证时,必须先配置 Figma MCP server、可访问 Figma 设计文件并具备 Figma URL;否则不能执行该部分。
- 不适用于直接生成自动化测试代码、执行真实测试或替代人工 QA 判断;它主要产出测试计划、用例、报告等文档。