Skip to content

它交上来的东西,
怎么才算「能直接用」 ​

一句话结论:AI 干完活的最后一步不是「写完了」,是交上来的东西能打开、能改、能归档。前两步做不到,等于没交付。

产物判定链路:落盘、后缀白名单、类型判定、进面板

一、一次「已生成报告」 ​

任务跑完,界面提示:报告已生成。

我去产物里找,找不到。翻任务详情,只有一个中间文件被列了出来——一个打不开的格式,需要另一个工具才能解析。

从它的角度看,文件确实写出来了,字节数不小,路径也对。从我的角度看,这活没交。

这就是产物面板存在的理由:把「写完了」和「能用了」分开判定。

二、白名单,不是黑名单 ​

面板的规则是一条白名单:只有命中清单的后缀才算最终产物,其余一律不进。

清单现在是二十一种,分四类:

  • 文档:.md .txt .docx .pdf
  • 表格与数据:.xlsx .csv .json .sql
  • 图片:.png .jpg .jpeg
  • 页面与代码:.html .py .go .js .ts .tsx .vue .sh .yaml .yml

为什么是白名单?三条理由:

  1. 黑名单永远漏。你永远想不到下一个不常见的格式是什么;而白名单的默认答案是「不收」,边界清晰;
  2. 能不能预览决定要不要收。收进面板却打不开的产物,只是把包袱又扔回给用户;
  3. 清单本身是产品判断。哪些东西算「交付物」,是产品定义的,不是运行时推导的。

三、代码文件也算产物,这条是被用户逼出来的 ​

最早的清单只有文档和图片。跑一段时间后有人反馈:让我写的脚本,跑完在产物里找不到。

技术上说它没错——脚本是中间态,最终结果是一份数据。但从使用者的角度看,脚本本身就是他要的东西,他明天还要接着改。

于是清单加了一组代码文件:.py .go .js .ts .tsx .vue .sh .yaml .yml。

这里有个取舍值得记:一旦开始收代码,清单就会长。所以配套加了一条治理规则——白名单的增删必须走正式变更流程,每条新增都要注明理由,并且有防回退的检查,不许随手加一个后缀。

理由很简单:这个清单每加一项,就意味着面板里会多出一类「看起来是产物、其实可能是一次性中间文件」的东西。松一次,后面就收不住。

四、清单一松,面板就变成垃圾场 ​

跑一段时间能看到一个规律:任务的中间文件远多于最终产物。一次整理任务可能写十几个临时文件,只有最后那个总表是产物。

如果面板按「写出来的都算」收录,用户打开看到的是一堆看不懂的文件名,需要自己判断哪个是结果。这跟直接把工作目录摊开给用户没区别。

所以除了后缀,还有第二层判断:这次落盘是不是任务的最终交付动作。同一后缀,如果写在中间步骤,不进面板;写在收尾阶段,才进。

五、验收标准其实只有一句 ​

判断一个「产物」合不合格,我只问一句:这个东西能不能直接拿去用。

  • 能打开:双击就能看,不需要额外工具;
  • 能改:格式可编辑,不是截图不是 PDF 打印件(除非本来就要 PDF);
  • 能归档:文件名有意义,路径可预测,过一周还找得到。

三条都满足,才算交付完成。这条标准对人也成立——我交给别人的东西,也是按这三条自查的。

产物格式与文件操作说明见文件操作。

结论 ​

  • 「写完了」和「能用了」是两件事,面板负责把后者判定出来;
  • 白名单优于黑名单:默认不收,边界清晰,还能顺带定义产品边界;
  • 代码也算产物,但清单每加一项都要有理由和防回退;
  • 最终验收只有一句:能不能直接拿去用。