侠量身 AIailiangshen.com
AI 落地工作课 · 专题短课 · 第 15 课

代码与测试辅助的边界

分清红黄绿资料,帮完必须评审和测试

免费公开约 10 分钟零基础网页课 + PPT + 视频

这一课讲代码与测试辅助的边界。本课不教写代码,也不替代代码审查的入门学习,只讲边界:哪些资料能让它帮,哪些不能贴,帮完之后怎么验收。

这一课讲这几件事

  • 场景
  • 做法
  • 提示词与样例
  • 小测验与带走

视频版:约 5 分钟

旁白由 AI 合成。视频在哔哩哔哩播放,上面的章节按钮会跳到对应位置。不看视频也没关系,直接往下滚动看课程。

播放器不显示?在哔哩哔哩打开 ↗

01

场景

建议用时约 1 分钟

先看一个情境虚构示例,数字为示意

栖岚智能 · 后端研发邱子昂

线上跑出一个报错,他想让神龙大侠帮着看看原因。

手边正好有整段代码,和一份带客户地址的日志。

禾曜电子的整机测试工程师蒋浩然,想让它帮忙补测试场景,想把整个测试规格都贴进去。

两个人都不该这样做。代码和日志一旦进了公共应用,就收不回来。
02

做法

建议用时约 2 分钟

做法:三问,红黄绿,脱敏三步

1
贴之前先问三问这段内容公开吗?贴了别人能还原我们的业务和客户吗?公司批准这个工具了吗?有一问答不好,就不贴
2
对照红黄绿表红:源代码、密钥、客户日志、未发布产品,绝不贴;黄:脱敏后的报错现象,处理后才贴;绿:通用算法思路、测试场景的头脑风暴,仍要先看公司规定
3
脱敏三步:删、换、缩删掉客户名、账号、网络地址、主机名、序列号;换成代号;只留现象、时间和必要的几行
4
它给的建议只作线索上线前必须评审和测试;检查它有没有编出不存在的函数、库和参数
5
记入验收清单谁评审了,跑了什么测试,结果是什么;没有运行记录的「测试通过」不算
本课不教公司内部代码助手的用法;是否允许把代码交给外部工具,以公司书面规定为准。
03

提示词与样例

建议用时约 4 分钟
技巧

只给现象,不给代码

建议用时
提示词一(只给现象)
我只给你现象和脱敏后的报错,不给代码。
现象:[一句话描述]
报错原文(已把地址和账号换成代号):[粘贴]
请列出:
1. 可能的原因,按可能性排序,每条一句话,并标「待验证」;
2. 我应该查什么、怎么查,不要给出确定结论;
3. 哪些信息我没给你,因而你无法判断。
规则:不编造函数名、库名、参数名;不确定的写「不确定」;不替我断定原因。
原因全部标待验证;它提到的函数、库、参数,都要回到代码或官方文档里找到。
技巧

测试场景头脑风暴

建议用时
提示词二(测试场景)
下面是一个功能的文字描述(已换成代号,不含内部细节)。请按正常、边界、异常三类列出测试场景,每个场景写:前置条件、操作、预期结果。
最后单独列出「我可能漏想了什么场景」。
预期结果里凡是你不确定的,写「待对照规格书」,不要编。
功能描述:[粘贴]
这类头脑风暴属于绿色资料;场景清单只是起点,预期结果要人对照规格书确认。
技巧

对它的建议做验收

建议用时
提示词三(验收)
你刚才建议了 [某修复方式或某函数]。请回答:
1. 这个函数、库或参数,在我给你的信息里出现过吗?
2. 你有没有实际运行过它?
3. 如果没有,请直接写「我没有运行过」,并列出我上线前必须做的验证步骤。
只要它写了「我没有运行过」,它的建议就只是线索,不能当作结论。

样例:同一份日志,脱敏前后不一样虚构示例,素材均为虚构

红:不贴

  • 一段公司服务的源代码
  • 配置文件里的访问密钥
  • 含客户地址的报错日志整段

黄或绿:脱敏后可贴

  • 把客户地址换成「客户甲」后,只留现象和报错的三行(黄)
  • 公开的产品介绍页文字(绿,仍先看公司规定)
  • 通用的登录页测试头脑风暴(绿)
同一份报错,先删、换、缩,再决定能不能贴。

常见偏差与补救

嫌麻烦,直接贴整段代码

补救:先写下「今天不贴的三样东西」,贴在屏幕边上。

信了它编出来的函数名

补救:每个函数、库、参数,都回到代码或官方文档里找到;找不到,就不能用。

它说「这样改就好了」,或「测试通过」

补救:这只是线索,要经过评审和测试;它没有运行代码,没有运行记录的一律不算。

报错里有客户地址

补救:先删或换成代号,再贴。

以上几条都指向一件事:它给的东西,都要人来验收。
04

小测验与带走

建议用时约 3 分钟

三道小题,检验一下

第 1 题:它给的修复方式,能直接上线吗?

答案 B。它给的只是线索,上线前必须评审和测试;它没有运行代码,「测试通过」没有运行记录不算。

第 2 题:报错里有客户网络地址,怎么办?

答案 B。地址要先删或换成代号,只留现象和必要的几行,再贴。

这一课,带走四句话

  1. 贴之前三问:公开吗,能还原业务吗,公司批准吗
  2. 红色资料不贴:源代码、密钥、客户日志
  3. 它给的只是线索,上线前必须评审和测试
  4. 没有运行记录的测试通过,不算数
展开完整文字稿(视频旁白)
代码与测试辅助的边界

这一课讲代码与测试辅助的边界。本课不教写代码,也不替代代码审查的入门学习,只讲边界:哪些资料能让它帮,哪些不能贴,帮完之后怎么验收。先看一个情境。

先看一个情境

先看一个情境,是虚构的,数字只是示意。栖岚智能的后端研发邱子昂,线上跑出一个报错,想让神龙大侠帮着看看原因,手边正好有整段代码,和一份带客户地址的日志。禾曜电子的整机测试工程师蒋浩然,想让它帮忙补测试场景,想把整个测试规格都贴进去。两个人都不该这样做。代码和日志一旦进了公共应用,就收不回来。

做法:三问,红黄绿,脱敏三步

做法分五步。第一,三问:这段内容公开吗,贴了能还原我们的业务和客户吗,公司批准这个工具了吗?有一问答不好,就不贴。第二,对照红黄绿表。红色资料绝不贴;黄色资料,脱敏后才能贴;绿色资料,比如通用算法思路,仍要先看公司规定。第三,脱敏三步:删、换、缩。第四,它给的建议只作线索,要评审和测试,并检查有没有编出不存在的函数、库和参数。第五,记入验收清单:谁评审,跑了什么测试,结果是什么。

提示词一:只给现象,不给代码

第一条提示词,只给现象,不给代码。把一句话的现象,和脱敏后的报错原文贴进去。请它列出可能的原因,按可能性排序,每条都标待验证;再告诉我该查什么、怎么查;最后说出它没有看到的信息。规则是:不编造函数名、库名和参数名,不替我断定原因。

提示词二:测试场景头脑风暴

第二条提示词,是测试场景的头脑风暴。功能描述要先换成代号。请它按正常、边界、异常三类列出场景,每个场景写清前置条件、操作和预期结果。预期结果不确定的,写待对照规格书,不要编。

提示词三:对它的建议做验收

第三条提示词,是对它的建议做验收。问它:这个函数在我给的信息里出现过吗?它实际运行过吗?如果没有,它要直接写我没有运行过,并列出上线前必须做的验证步骤。

样例:同一份日志,脱敏前后不一样

看一个样例,素材全部虚构。一段公司服务的源代码、配置文件里的访问密钥、含客户地址的报错日志整段,都是红色,不贴。把客户地址换成客户甲后,只留现象和报错的三行,是黄色,脱敏后可以贴。公开的产品介绍页文字,和通用的登录页测试头脑风暴,属于绿色,但仍要先看公司规定。同一份报错,先删、换、缩,再决定能不能贴。

常见偏差与补救

常见偏差有四种。一,嫌麻烦,直接贴整段代码,补救是先写下今天不贴的三样东西。二,信了它编出来的函数名,补救是每个函数、库、参数都回到代码或官方文档里找到。三,它说这样改就好了,或者说测试通过,补救是这只是线索,它没有运行代码,没有运行记录的一律不算。四,报错里有客户地址,补救是先删或换成代号,再贴。

小测验 第 1 题

来做小测验。第一题:它给的修复方式,能直接上线吗?A,能,它的回答很专业。B,不能,要经过评审和测试。C,能,只要它说测试通过。答案是 B。它给的只是线索,上线前必须评审和测试;它没有运行代码,测试通过没有运行记录不算。

小测验 第 2 题

第二题:报错里有客户网络地址,怎么办?A,原样贴进去,方便它定位。B,先删或换成代号,再贴;只留现象和必要的几行。C,直接让它忽略地址,照常分析。答案是 B。地址要先删或换成代号,只留现象和必要的几行,再贴。

这一课,带走四句话

我们来回顾,这一课带走四句话。第一,贴之前三问:公开吗,能还原业务吗,公司批准吗。第二,红色资料不贴:源代码、密钥和客户日志。第三,它给的只是线索,上线前必须评审和测试。第四,没有运行记录的测试通过,不算数。

下一步:写下你的三样东西

下一步,写下你岗位今天不贴的三样东西,贴在工位边上。再挑一条报错,做一次删、换、缩,然后问它可能的原因,记得它的回答都要标上待验证。本视频的旁白由 AI 合成。谢谢收看。