测试点编写skill
- Skill 标识
lemon-checkpoints-skill- 所属分类
- 软件测试 / 需求分析
需求不全也能有条理地做评审:把文档、截图和原型整理成按风险排序的测试点,一次交付执行看板、测试清单、待确认、规则证据和覆盖地图五张 Excel 表。
本文目录
- Skill 概览
- 适合谁、用在什么场景
- 需要准备什么、能得到什么
- 核心能力与使用边界
- 实战教程与使用说明
- 一、我们为什么需要它?
- 测试工程师的常见痛点
- 这个 Skill 解决什么问题?
- 二、Skill 是什么?能做什么?
- 核心能力概览
- 输出长什么样?
- 三、适用场景与人群
- 适合谁用?
- 典型使用场景
- 四、设计思路与框架
- 设计第一性原则
- 四层处理框架
- (一)输入底稿:三类信息必须分清
- (二)风险路线:按用户目标走
- (三)执行清单:三批次 + S0–S3
- (四)覆盖地图:查漏不凑数
- 输入不完整时怎么处理?
- 五、功能特性详解
- 5.1 六种输入 Demo
- 5.2 专项场景按需加载
- 5.3 本地辅助脚本
- 5.4 Skill 核心源码摘录
- 六、怎么用?一步步来
- 6.1 前置条件
- 6.2 推荐对话流程
- 6.3 常用说法示例
- 七、能解决什么困境?提效大概多少?
- 解决的测试困境(对照表)
- 提效估算(场景)
- 八、实操样例与附件
- 样例:智汇 ERP V3.5 登录与租户注册
- 九、边界、误区与 FAQ
- 它不适合什么?
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 生成底稿与模板,不代替业务判断 |
输出长什么样?
测试清单每一行都在回答五件事:
触发什么情况
使用什么样本数据
核对什么结果(页面 / 接口 / 数据 / 日志)
失败会造成什么影响
依据来自哪里(F-XXX / V-XXX / O-XXX)
三、适用场景与人群
适合谁用?
功能测试 / 业务测试:需求材料参差不齐,需要快速产出可评审、可分批执行的检查点。
测试负责人:要统一团队「先证据后结论」的分析习惯,减少「经验替产品拍板」。
涉及登录、交易、审批、数据处理的迭代:链路清晰、失败代价高,尤其适合本框架。
含计费/库存或 AI 能力的功能:可叠加计算类 / 智能功能专项检查清单。
典型使用场景
只有原型或截图:先把可见控件列为已确认事实,把登录结果、会话、锁定等写成验证建议 + 待确认。
有较完整需求文本:直接整理规则证据,生成 A/B/C 批次与覆盖地图,开放问题单独跟踪。
多材料冲突(截图 vs 规则 vs OpenAPI):不自行选边,冲突点进入待确认清单。
评审前 30 分钟:用执行看板看 S0 数量与开放问题,决定能不能进测。
四、设计思路与框架
设计第一性原则
先把「已经看到的事实」和「尚未确认的规则」分开,才能避免用经验替产品做决定。
测试方向只负责查漏,不直接决定排版;排版服从交付规范(默认 Excel)。
刻意避开的反模式包括:
把验证建议写成既定需求规则;
待确认只藏在「依据」列,没有独立跟踪面;
一上来按技术维度拆表,而不是用户目标链路;
材料缺失就省略边界、权限、并发、恢复等高风险路径;
为覆盖地图每个方向硬凑固定条数;
输出逐步操作流水账,假装成完整测试计划。
四层处理框架
▲ 图注:输入底稿 → 风险路线 → 执行清单 → 覆盖地图
(一)输入底稿:三类信息必须分清
类型 | 含义 | 示例 |
|---|---|---|
已确认 | 需求原文、截图或接口文档直接证明 | 页面存在验证码输入框 |
验证建议 | 行业方法要求关注,但材料未给规则 | 检查验证码是否可重复使用 |
待确认 | 不同答案会改变预期或优先级 | 验证码有效期是多少 |
待确认清单必须独立,每条至少含:问题编号、需要确认的具体规则、影响的测试点、风险或影响、负责人、状态、确认结论。没有负责人也要留空列,不得省略字段。每个 O-XXX 至少关联一条测试点。
(二)风险路线:按用户目标走
默认业务链路(可按业务裁剪):
进入与展示 → 信息输入 → 系统校验 → 结果反馈 → 状态保持与退出
每一段都检查:能否继续完成目标、错误是否可理解可恢复、敏感数据是否泄露、并发是否不一致、中断后能否安全恢复。
(三)执行清单:三批次 + 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 | 需求文本 |
|
02 | 本地需求文档 |
|
03 | 页面截图 |
|
04 | 产品原型 |
|
05 | 接口资料 |
|
06 | 多材料组合 |
|
▲ 图注:Demo 03 登录页截图——只能证明可见结构,不能证明后台会话/锁定等行为
5.2 专项场景按需加载
计算类(金额、余额、积分、折扣、库存、费率、算法等):关注精度与舍入时点、零/负/上限、多规则顺序、累计与逆向、并发扣减一致性、单位换算。规则缺失 → 待确认 + 验证建议。
智能功能(大模型、推荐、对话、识别、生成):关注输入多样性、澄清与拒答、多轮上下文、输出合法性、事实与过期知识、注入与越权、波动/超时/降级、人工复核频率。没有唯一标准答案时,用准确率、格式通过率、人工评分、拒答命中率等可检查指标。
5.3 本地辅助脚本
脚本负责识别、分组和生成底稿模板,不代替人工或模型完成业务判断。
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 入口对交付默认值的约定(节选):
## 交付方式
默认输出 **Excel**(`.xlsx`)。用户明确要求 Markdown、脑图或多种格式时,再按交付规范切换。
Excel 工作表固定为:执行看板、测试清单、待确认、规则证据、覆盖地图。
Agent 落盘约定:未指定路径时,写到工作区
`output/lemon-checkpoints/<需求简称>-测试执行清单.xlsx`
脚本默认格式读取配置(节选逻辑):
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 推荐对话流程
把材料路径发给 Agent,或说「从 lemon-input-demos 随机选一个 demo 生成测试清单」。
明确:「调用 lemon-checkpoints」「默认输出 Excel」「先不补齐待确认需求也可以」。
拿到
output/lemon-checkpoints/*.xlsx后,先看执行看板与待确认,再决定进测范围。产品确认 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 就值得进团队工具箱。
读完如果觉得有用,欢迎把你们团队的真实材料跑一轮,把「待确认」里最高频的问题沉淀成项目规范——那才是长期提效。
扫码添加辅导员,发送 Skill 名称,领取源码与配套资料。