测试点编写skill

Skill 标识
lemon-checkpoints-skill

需求不全也能有条理地做评审:把文档、截图和原型整理成按风险排序的测试点,一次交付执行看板、测试清单、待确认、规则证据和覆盖地图五张 Excel 表。

扫码添加辅导员,发送 Skill 名称领取源码
本文目录
  1. Skill 概览
  2. 适合谁、用在什么场景
  3. 需要准备什么、能得到什么
  4. 核心能力与使用边界
  5. 实战教程与使用说明
  6. 一、我们为什么需要它?
  7. 测试工程师的常见痛点
  8. 这个 Skill 解决什么问题?
  9. 二、Skill 是什么?能做什么?
  10. 核心能力概览
  11. 输出长什么样?
  12. 三、适用场景与人群
  13. 适合谁用?
  14. 典型使用场景
  15. 四、设计思路与框架
  16. 设计第一性原则
  17. 四层处理框架
  18. (一)输入底稿:三类信息必须分清
  19. (二)风险路线:按用户目标走
  20. (三)执行清单:三批次 + S0–S3
  21. (四)覆盖地图:查漏不凑数
  22. 输入不完整时怎么处理?
  23. 五、功能特性详解
  24. 5.1 六种输入 Demo
  25. 5.2 专项场景按需加载
  26. 5.3 本地辅助脚本
  27. 5.4 Skill 核心源码摘录
  28. 六、怎么用?一步步来
  29. 6.1 前置条件
  30. 6.2 推荐对话流程
  31. 6.3 常用说法示例
  32. 七、能解决什么困境?提效大概多少?
  33. 解决的测试困境(对照表)
  34. 提效估算(场景)
  35. 八、实操样例与附件
  36. 样例:智汇 ERP V3.5 登录与租户注册
  37. 九、边界、误区与 FAQ
  38. 它不适合什么?

Skill 概览

适合谁、用在什么场景

需要在资料不完整时推进需求评审与测试点设计的测试工程师。

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

  • 输入材料:需求文本、本地文档、页面截图、HTML 原型、OpenAPI 或组合材料。
  • 交付产物:含执行看板、测试清单、待确认、规则证据、覆盖地图的五表 Excel。

核心能力与使用边界

  • 核心能力:区分事实与建议,按用户链路安排冒烟、重点及扩展批次,并检查覆盖缺口。
  • 使用边界:侧重测试检查点,不替代逐步操作用例或完整测试计划;未知业务规则必须待确认。

实战教程与使用说明

▲ 图注:Skill 六大能力卡片——输入底稿、风险路线、执行清单、覆盖地图、证据分级、Excel 五表交付

一、我们为什么需要它?

测试工程师的常见痛点

  • 材料永远不完整,但评审照样催用例:经常只有截图、一句话需求或半成品原型,却要马上交「可执行的测试点」。经验一上来,就容易把「我觉得应该这样」写成「产品规定如此」。

  • 事实、猜测、待确认搅在一起:Excel 里写满「预期结果」,回头却说不清哪条有需求依据、哪条是自己脑补。评审时吵的不是风险,是「依据在哪」。

  • 按技术维度拆表,漏掉用户目标链路:一上来就按字段、接口、异常码铺开,用户从「进入页面到登出」的阻断点、会话与恢复反而散落各处,冒烟路径不清晰。

  • 开放问题没有跟踪面:验证码有效期、锁定策略、会话时长……问过就算了,过两天预期又变,返工全砸在用例维护上。

  • 交付物不利于评审与分批执行:超宽表、合并单元格、步骤流水账又长又难筛;负责人想先看 S0/冒烟,却翻不到重点。

  • 覆盖靠记忆:边界、权限、并发、重试、审计……方法都懂,但材料一急就只写 happy path,上线后才补洞。

▲ 图注:左侧是测试分析常见困境,右侧是本 Skill 用结构化证据与风险批次给出的对应解法

这个 Skill 解决什么问题?

输入:产品需求文本、本地需求文档、页面截图、可交互原型(HTML)、OpenAPI、或多材料组合包。

输出(默认):一份 .xlsx 测试执行清单,固定五张工作表——执行看板、测试清单、待确认、规则证据、覆盖地图。

过程中会强制做到:

  • 把已经看到的事实和尚未确认的规则分开,避免用经验替产品做决定;

  • 按用户完成目标的业务链路排风险,再拆成 A 冒烟 / B 重点 / C 扩展;

  • 每条测试点写清:触发情况、样本数据、核对结果、失败影响、证据依据;

  • 用标准覆盖方向(C01–C14)做查漏,而不是凑数量;

  • 开放问题独立成表、可跟踪,最多优先追问会改变结论的 6 个问题,其余进交付物,不中断分析。

一句话定位:它不是「自动写逐步测试用例的机器人」,而是帮测试人把分析过程结构化、评审材料可交付的检查点引擎。

二、Skill 是什么?能做什么?

  • 一句话:把需求、原型、截图或用户故事,转成按风险排序的测试执行清单,并保留规则证据、待确认事项与覆盖地图。

  • 明确不做:不编写逐步测试操作说明,也不替代完整测试计划;材料没写的规则不得自行拍板。

核心能力概览

能力

说明

证据分级

已确认 / 验证建议 / 待确认三层,建议不能伪装成需求

风险路线

按用户目标顺序:进入与展示 → 信息输入 → 系统校验 → 结果反馈 → 状态保持与退出

执行批次

A 首轮冒烟、B 重点验证、C 扩展检查;同一场景不复制到多批次

严重度

S0–S3:从阻断上线到可后续处理

覆盖地图

C01–C14 标准方向查漏,状态仅:已覆盖 / 待补充 / 不适用

专项场景

计算类(金额库存精度等)、智能功能(生成/推荐/对话等)按需加载

默认交付

Excel 五表;也可按需 Markdown / 飞书或 XMind 大纲

本地脚本

scan / build / prompt 生成底稿与模板,不代替业务判断

输出长什么样?

测试清单每一行都在回答五件事:

  1. 触发什么情况

  2. 使用什么样本数据

  3. 核对什么结果(页面 / 接口 / 数据 / 日志)

  4. 失败会造成什么影响

  5. 依据来自哪里(F-XXX / V-XXX / O-XXX)

三、适用场景与人群

适合谁用?

  • 功能测试 / 业务测试:需求材料参差不齐,需要快速产出可评审、可分批执行的检查点。

  • 测试负责人:要统一团队「先证据后结论」的分析习惯,减少「经验替产品拍板」。

  • 涉及登录、交易、审批、数据处理的迭代:链路清晰、失败代价高,尤其适合本框架。

  • 含计费/库存或 AI 能力的功能:可叠加计算类 / 智能功能专项检查清单。

典型使用场景

  1. 只有原型或截图:先把可见控件列为已确认事实,把登录结果、会话、锁定等写成验证建议 + 待确认。

  2. 有较完整需求文本:直接整理规则证据,生成 A/B/C 批次与覆盖地图,开放问题单独跟踪。

  3. 多材料冲突(截图 vs 规则 vs OpenAPI):不自行选边,冲突点进入待确认清单。

  4. 评审前 30 分钟:用执行看板看 S0 数量与开放问题,决定能不能进测。

四、设计思路与框架

设计第一性原则

先把「已经看到的事实」和「尚未确认的规则」分开,才能避免用经验替产品做决定。

测试方向只负责查漏,不直接决定排版;排版服从交付规范(默认 Excel)。

刻意避开的反模式包括:

  • 把验证建议写成既定需求规则;

  • 待确认只藏在「依据」列,没有独立跟踪面;

  • 一上来按技术维度拆表,而不是用户目标链路;

  • 材料缺失就省略边界、权限、并发、恢复等高风险路径;

  • 为覆盖地图每个方向硬凑固定条数;

  • 输出逐步操作流水账,假装成完整测试计划。

四层处理框架

▲ 图注:输入底稿 → 风险路线 → 执行清单 → 覆盖地图

(一)输入底稿:三类信息必须分清

类型

含义

示例

已确认

需求原文、截图或接口文档直接证明

页面存在验证码输入框

验证建议

行业方法要求关注,但材料未给规则

检查验证码是否可重复使用

待确认

不同答案会改变预期或优先级

验证码有效期是多少

待确认清单必须独立,每条至少含:问题编号、需要确认的具体规则、影响的测试点、风险或影响、负责人、状态、确认结论。没有负责人也要留空列,不得省略字段。每个 O-XXX 至少关联一条测试点。

(二)风险路线:按用户目标走

默认业务链路(可按业务裁剪):

text
进入与展示 → 信息输入 → 系统校验 → 结果反馈 → 状态保持与退出

每一段都检查:能否继续完成目标、错误是否可理解可恢复、敏感数据是否泄露、并发是否不一致、中断后能否安全恢复。

(三)执行清单:三批次 + S0–S3

批次

选择标准

典型用途

A 首轮冒烟

最短成功路径、关键页面、必要输入、阻断性安全控制

每次构建先执行

B 重点验证

主要失败、边界、权限、状态、重复、并发和恢复

功能测试主体

C 扩展检查

兼容、性能、日志、低频组合和历史影响

上线前或专项

严重度:

  • S0:核心功能 / 安全 / 数据完整性,失败阻止上线

  • S1:主要业务能力受损,影响大量用户或日常操作

  • S2:影响有限,有绕行方案

  • S3:低频或低影响,可后续处理

(四)覆盖地图:查漏不凑数

C01 成功路径 · C02 失败反馈 · C03 临界条件 · C04 访问控制 · C05 数据约束 · C06 生命周期 · C07 同时操作 · C08 重复与重试 · C09 服务契约 · C10 持久化 · C11 追溯能力 · C12 运行环境 · C13 容量指标 · C14 变更影响。

状态只有三种:已覆盖 / 待补充 / 不适用(不适用必须写原因)。

输入不完整时怎么处理?

  • 截图、原型、一句话需求可以直接分析,但只能把可见内容列为事实;

  • 登录结果、接口返回、数据写入、权限、失败限制等不可见行为 → 验证建议 + 关联待确认;

  • 只优先追问会改变测试结论的问题,最多 6 个;其余放进交付物,避免分析被打断。

五、功能特性详解

5.1 六种输入 Demo

Skill 自带 lemon-input-demos/,方便练手与回归:

编号

输入方式

文件

01

需求文本

01-requirement-text.txt

02

本地需求文档

02-requirement-document.md

03

页面截图

03-login-page-screenshot.png

04

产品原型

04-login-prototype.html

05

接口资料

05-openapi.yaml

06

多材料组合

06-multi-source-package/

▲ 图注:Demo 03 登录页截图——只能证明可见结构,不能证明后台会话/锁定等行为

5.2 专项场景按需加载

计算类(金额、余额、积分、折扣、库存、费率、算法等):关注精度与舍入时点、零/负/上限、多规则顺序、累计与逆向、并发扣减一致性、单位换算。规则缺失 → 待确认 + 验证建议。

智能功能(大模型、推荐、对话、识别、生成):关注输入多样性、澄清与拒答、多轮上下文、输出合法性、事实与过期知识、注入与越权、波动/超时/降级、人工复核频率。没有唯一标准答案时,用准确率、格式通过率、人工评分、拒答命中率等可检查指标。

5.3 本地辅助脚本

脚本负责识别、分组和生成底稿模板,不代替人工或模型完成业务判断。

bash
python3 scripts/lemon_checkpoints.py scan  -i 需求.md -o 输入检查.md
python3 scripts/lemon_checkpoints.py build -i 需求.md -o 执行清单.xlsx
python3 scripts/lemon_checkpoints.py build -i 需求.md -o 执行清单.md --format markdown
python3 scripts/lemon_checkpoints.py build -i 需求.md -o 测试脑图.md --format mindmap
python3 scripts/lemon_checkpoints.py prompt -i 需求.md -o 可复制提示词.md

兼容别名:inspect≡scan,draft≡build,--layout≡--format。Excel 依赖 openpyxl。

5.4 Skill 核心源码摘录

Skill 入口对交付默认值的约定(节选):

markdown
## 交付方式

默认输出 **Excel**(`.xlsx`)。用户明确要求 Markdown、脑图或多种格式时,再按交付规范切换。
Excel 工作表固定为:执行看板、测试清单、待确认、规则证据、覆盖地图。

Agent 落盘约定:未指定路径时,写到工作区
`output/lemon-checkpoints/<需求简称>-测试执行清单.xlsx`

脚本默认格式读取配置(节选逻辑):

python
default_format = settings.get("default_format", "excel")
# build / draft 默认 --format excel
# 未传 -o 时自动生成:<输入名>-测试执行清单.xlsx

六、怎么用?一步步来

6.1 前置条件

  • 已使用 Cursor,并能加载本 Skill 目录;

  • 准备任意一种输入材料(文本 / 文档 / 截图 / 原型 / OpenAPI / 组合包);

  • 若要用脚本出 Excel:Python 3 + pip install -r requirements.txt。

6.2 推荐对话流程

  1. 把材料路径发给 Agent,或说「从 lemon-input-demos 随机选一个 demo 生成测试清单」。

  2. 明确:「调用 lemon-checkpoints」「默认输出 Excel」「先不补齐待确认需求也可以」。

  3. 拿到 output/lemon-checkpoints/*.xlsx 后,先看执行看板与待确认,再决定进测范围。

  4. 产品确认 O-XXX 后,回填「确认结论」,再收紧 S0/S1 的预期结果。

6.3 常用说法示例

  • 「用 lemon-checkpoints 分析这份登录原型,输出 Excel」

  • 「材料不完整也先出清单,待确认保持开放,不要替产品拍板」

  • 「这次只要 Markdown / 脑图」——才会切换非默认格式

  • 「这是计费功能,按计算类专项补检查」

七、能解决什么困境?提效大概多少?

说明:下列提效数字是基于「中等复杂度登录/注册类功能」的场景估算(对照人工从零拆表),不是实验室精确测量。请按团队现状校准。

解决的测试困境(对照表)

困境

Skill 如何拆解

需求糊、材料残缺仍要交用例

可见事实进 F;不可见行为进 V+O;分析不中断

评审扯皮「预期谁定的」

规则证据表可追溯;建议不得伪装成需求

冒烟与深度测搅在一起

A/B/C 分批 + S0 着色,构建与专项分流

漏测权限/并发/重试

覆盖地图强制回看 C04/C07/C08 等

开放问题口头说过就丢

待确认独立表:负责人/状态/结论

交付物难筛选难汇报

默认 Excel 五表 + 执行看板公式统计

提效估算(场景)

环节

传统做法

使用本 Skill

粗算提效

首轮分析成稿(登录级)

2–4 小时

20–40 分钟

约 70%–85%

材料→可评审结构

边写边改结构

框架一次成型

约 50%–70%

因规则不清导致的返工

预期写死后推翻

O-XXX 前置暴露

返工轮次约减 30%–50%

覆盖查漏

靠个人经验清单

C01–C14 对照

漏项发现更早、更稳

逐步用例编写

—

不替代

仍需人工/其他工具

对团队整体测试周期的直觉结论:

  • 分析与评审准备阶段收益最大(常可砍到原来的 1/3~1/5 时间);

  • 执行与自动化脚本编写仍取决于原有能力,本 Skill 提供的是「测什么、先测什么、依据是什么」;

  • 材料越残缺,相对提效越明显——因为它把「不确定」变成可管理资产,而不是隐性风险。

八、实操样例与附件

样例:智汇 ERP V3.5 登录与租户注册

基于 Demo 01-requirement-text.txt 生成的完整 Excel(含 23 条检查点、6 个待确认、规则证据与覆盖地图):

该样例重点覆盖:验证码消费与错误码、通用测试验证码分支、明文记住密码、msgTip 判成、多设备会话等 S0/S1 风险。

九、边界、误区与 FAQ

它不适合什么?

  • 要立刻得到「逐步点击说明书」式用例——请配合其他用例编写 Skill / 人工补步骤;

  • 要替代测试计划、资源排期、环境策略——本 Skill 只覆盖检查点分析交付;

  • 指望脚本关键词扫描等于真实覆盖率——关键词「只负责提醒,不代表实际覆盖率」。

建议你下一步:拿 lemon-input-demos 里任意一份材料跑通一遍,打开生成的 Excel,先只看「执行看板 + 待确认 + S0 行」——如果这三处已经能支撑一次评审,这个 Skill 就值得进团队工具箱。

读完如果觉得有用,欢迎把你们团队的真实材料跑一轮,把「待确认」里最高频的问题沉淀成项目规范——那才是长期提效。

开始使用 lemon-checkpoints-skill

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

同类 Skills