名人说:博观而约取,厚积而薄发。——苏轼《稼说送张琥》
创作者:Code_流苏(CSDN)(一个喜欢古诗词和编程的Coder😊)目录
- 先把规则讲明白,再让它写代码
- 从一个检查页面,扩展成六个模块
- 界面要清楚,修改也要有分寸
- 最后一轮,我让它交出可以核对的结果
- 我的评价:整体满意,还想补上手引导
很高兴你打开了这篇博客,更多AI知识,请关注我、订阅专栏《AI知识图谱》,内容持续更新中…
最初,运营提给我的需求很直接:SKU 要检查的东西太多,能不能做个工具?
我目前在一家跨境电商公司做 AI 应用开发。听到这个需求,首先想到的是一个小页面:上传 Excel,检查重复 SKU、缺失字段、价格和库存,最后导出问题清单。
但往下想了一步,我又觉得可以多做一点。
运营拿到清单,还得回原表找对应的行,改完再检查。换一批资料,可能又要重新对表头。处理到一半离开页面,下次最好还能接着做。最后导出的字段和顺序,也未必每次都一样。
既然做了,就把这些操作也接上吧。
于是,这次需求从一个 SKU 检查工具,逐渐变成了一个包含导入、资料管理、检查、导出、批次历史和规则设置的SKU 工作台。我用的模型是Seed-2.1-pro,开发工具是豆包工作。
先放成品。下面是导入家居收纳演示数据后的实际页面:60 条记录,检出32 条错误、4 条警告,28 条记录没有问题。
这一版已经跑通了。它是一个可以在浏览器里打开的本地 HTML 工具,草稿保存在当前浏览器中。本文使用家居收纳品类的模拟数据,规则也是为这次演示事先约定的,不涉及公司的真实经营资料。
这篇就聊聊我怎么把需求交给豆包工作,中间补了哪些功能,以及用下来还有什么不满意。四段提示词也放在文中,有类似需求可以拿去改。
先把规则讲明白,再让它写代码
我没有一上来就让它“做一个完整的跨境电商系统”。第一轮的目标很具体:先把 SKU 检查做对。
为此,我准备了收纳盒、抽屉分隔盒、衣物收纳袋、鞋盒和桌面收纳架的数据。每条记录有 22 个字段,包括 SKU、父 SKU、颜色、规格、售价、库存、仓库、主图链接和条码。
整理规则时,有些平时看起来很小的区别,必须说清楚。
比如库存是0,和库存没填,是两回事。草稿商品零库存可以接受;已经标记为待刊登的商品,零库存就需要提醒。条码则要按文本保存,不能导出一次,开头的00就没了。
重复 SKU 也不能只找完全相同的字符串。这次约定先去首尾空格、统一大写,再判断重复;同一组里的记录都要标记,原始值仍然保留。父 SKU 相同、颜色或规格不同,则可能是正常变体。
这些约定最后整理成了16 项规则,随数据一起交给豆包工作。
我是跨境电商公司的 AI 应用开发工程师。 请使用当前选定的 Seed-2.1-pro,开发一个家居收纳 SKU 检查工具。 附件:开发演示数据、正常样本、检查规则.json。 这些都是模拟数据,规则属于本次演示约定。 先读取附件,说明字段、规则和实现步骤,然后完成可运行版本: 1. 支持 XLSX、UTF-8 CSV 导入,预览数据并识别缺失表头。 2. 严格执行 R01–R16,区分错误和警告。 3. 每条问题包含记录编号、当前原始表行号、字段、原始值、规则ID和原因。 4. 同一行多个问题全部保留,重复组所有成员都要标记。 5. 数值空白不能转成零;条码按文本保留前导零。 6. 主图链接只检查缺失和格式,不访问演示占位域名。 7. 支持按 SKU、规则和级别筛选,导出问题清单。 规则由确定性代码执行,不要把每一行都发送给模型临时判断。 不要硬编码样本 SKU、行号或问题总数。 请启动程序并验证实际导入与导出,说明哪些功能验证过、哪些仍未验证。这里我特意写了“规则由确定性代码执行”。模型负责理解需求、编写和修改程序;工作台运行时,明确的格式、数值和重复规则交给代码判断。以后换一份表,也能按同一套标准复查。
做到第一版,最初那个“上传表格、找出问题”的需求已经有了着落。接下来,我开始把检查前后的操作加进去。
从一个检查页面,扩展成六个模块
我不太想让运营在工具里发现问题,再回 Excel 改,改完重新上传。既然已经读进了这份数据,查询、修改和导出都可以围绕它完成。
第二轮,我把工作台拆成了六个模块。
| 模块 | 这次实现的内容 |
|---|---|
| 导入中心 | 预览文件、选择工作表、确认表头映射后导入 |
| SKU 资料 | 查询、筛选、编辑记录,查看父 SKU 下的变体 |
| 检查中心 | 查看错误和警告,打开问题详情,修改后重新检查 |
| 导出模板 | 选择字段和顺序,导出全部数据、筛选结果或问题清单 |
| 批次历史 | 保存和恢复草稿,查看修改记录,备份与恢复本地数据 |
| 规则设置 | 查看规则说明和版本,在固定基线上管理后续版本 |
模块一多,我就开始关心它们用的是不是同一份数据。资料页改了库存,检查中心和导出文件都得跟着变,不然运营还得自己核对哪个才是最新版。
所以第二段提示词,重点放在数据和状态如何衔接上。
在现有 SKU 检查工具上继续开发,扩展为 SKU 工作台。 保留已经完成的检查逻辑,围绕同一批次数据组织功能: 导入中心:预览文件,提供表头映射;映射需确认后再导入。 同一目标字段不能被多列重复映射,缺少必填列要明确提示。 SKU 资料:查询、筛选、编辑记录,查看父 SKU 下的变体。 检查中心:共享检查结果,支持查看问题、修改和重新检查。 导出模板:保存字段选择与列顺序。 区分“全部当前数据”“当前筛选结果”和“问题清单”,导出前显示范围与数量。 批次历史:保存草稿、恢复批次,记录字段修改前后的值。 原始导入数据保持可追溯,重新导入不能静默覆盖未保存修改。 规则设置:展示 R01–R16 的说明、级别和当前版本。 首版固定规则作为验收基线;启停或调整参数后保存为新版本。 历史结果记录当时使用的规则版本,不能自动变成新规则的结果。 首版采用浏览器本地存储保存草稿,并支持备份与恢复文件。 存储失败、备份失败或恢复失败时给出提示,不得显示保存成功。 不要把表头映射、检查和导出各写一份互相独立的数据逻辑。 每新增一个模块,回归已有的导入、检查与导出流程。现在的导入页面分成文件选择、数据预览和表头映射三部分。选完文件,还要核对列与字段的对应关系,再确认导入。对于经常接不同来源表格的场景,这一步很有必要。
进入 SKU 资料页后,可以按品类、颜色、规格、刊登状态和仓库筛选。问题会标在对应单元格上,同时显示规则编号;点击单元格可以编辑,也能查看同一父 SKU 下的变体。
界面要清楚,修改也要有分寸
第三轮,我明确要求它用简洁的蓝白配色,并继续完善修改流程。
这是一个需要看大量表格的工具。我希望主要空间留给数据,常用操作放在容易找到的地方。错误和警告除了颜色,还要写出原因,不能让人只看到一片红色,却不知道怎么处理。
请把现有工作台整理成简洁的蓝白界面,以桌面运营操作为主。 左侧放六个模块入口,主区优先展示当前批次及主要操作。 数据表支持固定表头、关键标识列和横向滚动。 点击问题可定位对应记录,并打开包含原始值、规则和修改入口的详情。 错误与警告同时使用文字标签,不只用颜色区分。 加入 SKU 去首尾空格、统一大写的批量修改: 先显示影响记录和修改前后对照,确认后执行,再重新检查。 保留变更记录并支持撤销本次批量修改。 不擅自补充缺失业务值,不自动删除重复记录。 补齐空白页、文件解析失败、缺列、无筛选结果、保存失败等状态。 如果我提供表格截图或页面截图,请先说明看到的布局问题,再修改。 截图用于界面沟通,原始文件用于核对数据;无法读取的内容直接说明。 所有统计必须来自当前数据,不能把效果图中的数字写死。 请实际检查筛选、修改、撤销、重新检查和导出是否连贯。这一轮做完,界面基本符合我的预期:深蓝侧栏、白色内容区,蓝色用于主要操作,错误和警告另外区分。六个模块的位置固定,当前处理哪个批次也能看到,操作逻辑比较清楚。
问题详情的处理方式,我也挺满意。比如开发数据中的 D-003 缺少 SKU,点开以后能看到原始表第 4 行、缺失字段、规则说明,以及直接修改的入口。无需拿着问题清单再去猜是哪条记录。
批量操作则先给出修改对照。开发样本中有两条 SKU 需要去空格或统一大写,页面会把修改前后的值列出来,确认后才执行。缺失的业务值不会被随便补上,重复记录也不会被自动删掉。
导出时也有类似的确认。当前导出的是全部数据、筛选结果,还是问题清单,右侧会显示范围、数量、格式和列数。字段顺序可以调整,常用配置可以保存成模板。
做到这里,我想加的功能基本都有了。接下来还得换数据试,尤其要看看修改、保存和导出以后,结果会不会出错。
最后一轮,我让它交出可以核对的结果
开发前准备的三组数据,在这里各有用途:正常集查误报,开发集帮助调试,独立验收集用另一批记录检查结果。
最后一轮,我把要求写成了下面这段。
现在进入验收阶段。先冻结本次检查规则为基线版本,保存当前实现。 用正常集确认误报,再导入刚提供的独立验收集并保存实际问题清单。 输出后再与预设答案逐项核对,按记录编号、规则ID、字段统计命中、漏报和误报。 不能只比较总数,也不能为了匹配答案修改规则或写死特定记录。 随后实际操作: 打乱行顺序重新导入;编辑后重查;批量规范化后撤销; 保存并刷新恢复;导出全部数据和筛选数据;回读导出文件。 检查原始列、条码前导零、修改值、导出范围和批次状态是否正确。 每项给出实际执行步骤、结果和可核对的文件或截图。 发现问题后先定位原因,再修复并回归受影响流程。 运行失败、无法打开页面或无法导出时,保留失败状态并说明原因。 没有执行过的操作标为未验证,不宣称已经完成。三组 XLSX 数据的实际检查结果如下,错误和警告的数量都与预设一致。
| 数据集 | 记录数 | 错误数 | 警告数 | 无问题记录数 |
|---|---|---|---|---|
| 正常样本 | 60 | 0 | 0 | 60 |
| 开发演示集 | 60 | 32 | 4 | 28 |
| 独立验收集 | 40 | 15 | 3 | 23 |
这里的错误数、警告数是“问题条数”。一条记录可以同时有几个问题,所以不能拿记录总数直接减去问题数,计算正常商品数量。
独立验收的 18 条问题,按“记录编号、规则 ID、字段”逐项比较,18 条全部匹配,没有漏报或误报;级别、当前行号和原始值也一致。打乱行顺序后的导出清单,同样通过了逐项比对。
我比较在意的还有导出后的数据。验收中,把 T-028 的宽度从 201 改成 199,再重新检查;保存草稿、刷新恢复后,修改值仍在,原始导入值也保留着。导出的文件里,这一项也是 199。
全部数据导出为 40 条,按 US-W1 仓库筛选后导出为 14 条,22 个原始字段的顺序保留。回读 XLSX 文件时,0001234567890这样的条码仍是文本,前导零没有丢,空白库存也没有被填成零。
批量规范化和撤销、草稿恢复等过程,项目里也留下了验收记录。整理这篇文章时,又重新导入了三组 XLSX 样本,并复核了独立验收清单和导出文件,才把这些数字放进来。
这些结果对应的是这套模拟数据和演示规则。主图链接使用占位地址,当前只检查缺失和格式;“检查通过”也不代表已经满足某个平台的全部刊登要求。这一版完成了约定范围内的验证,后续还需要结合实际业务资料继续用。
我的评价:整体满意,还想补上手引导
这次用下来,我对成品挺满意。蓝白配色简洁美观,操作逻辑清晰,导入、检查、修改和导出都有明确入口,整体符合需求。
Seed-2.1-pro 用得顺手的地方,是能围绕同一个项目继续迭代。我把业务规则和验收要求讲清楚,豆包工作负责写代码、运行和修改,逐步把检查工具做成了工作台。
最想补的是页面内的使用说明和首次上手引导。目录里虽然有 README,页面也有局部提示,但新同事第一次打开,最好就能跟着完成“导入—检查—导出”。表头映射、草稿保存、导出范围这些地方,加几句说明或一段可跳过的演示,会更容易上手。
其余部分,按这次的需求和测试范围来看,都挺好。最初只想做个检查页面,后来把查出问题之后的操作也接了起来,我觉得这次多做一点值得。下一步就交给同事实际用,再看看哪里还麻烦。
创作者:Code_流苏(CSDN)(一个喜欢古诗词和编程的Coder😊)