乐于分享
好东西不私藏

信息科接手 AI 工具,该先写一份「交接单」

信息科接手 AI 工具,该先写一份「交接单」

信息科接手 AI 工具,该先写一份「交接单」

摘要:AI 原型在作者电脑上跑得再好,交到信息科手里往往就断。本文给出一份「交接单」模板,把输入、目录、命令、权限和验收写进一张表,让工具能换人、能复跑。文末可留言领取模板。

这篇写给正在接手别人开发的 AI 原型、低代码页面或内部脚本的信息科同事。读完约 8 分钟,你会拿走一个动作:接手那天,先让作者填完「交接单」,再谈运行。

我先说清我为什么写这个

我是承叔,一名中国三级公立医院医生。10年以上医疗实践中,我在急诊科工作过,目前转向整形医学方向,也长期实践AI Agent。

在急诊科,交接从来不是把病人推给下一个班就结束。口头说一句"这个病人你看着点",等于没交。真正能交接的,是病情、用药、风险、下一次该做什么,每一件都写下来、有人认领。

AI 工具的接手也一样。作者一句"代码在仓库里,跑一下就知道了",对信息科等于没交。我在医疗行业见过太多这样的场景:演示时很顺,换一个人、换一台电脑,就再也跑不起来。

所以我一直坚持的理念是:医疗AI不该只追求"能跑"。真正能进入部门的工作链,必须能被接手、出错能停、结果能复核、过程能留证。

我的口号是:把AI工具,变成能进部门、能被接手、出错能停、结果能复核的医疗AI工作链。

我把自己的定位叫作"医疗AI时代职业升级实践者"。这个公众号不搬运工具新闻,而是持续记录:医院场景怎么拆、工具边界怎么写、失败和复跑怎么留证。

如果你也在走这条路,可以先关注这个公众号。文末我会给出平台内留言关键词。

为什么作者能跑,你接手就断

一个 AI 工具跑不起来,很少是因为代码写错,多半是缺了"没说出来的前提"。

举个例子。作者的工具读一个 Excel,里面有个 status 列。作者脑子里清楚:这个列的值只能是"正常、待复核、停用"。但代码里没写死,靠一个字典在某个脚本里维护。你接手后,业务部门送来一份新文件,里面多了个"已办结",程序没报错,却把整批记录都归进了待复核。

这就是典型的"能跑,但不交接"。程序逻辑、依赖版本、目录权限、配置项、失败处理,作者都知道,但都只在他脑子里。

交接单要解决的,就是把作者脑子里的东西,一件件挖出来写成字。

交接单要写满七项

我建议信息科用一张交接单,至少填满七项,少一项都算没交完。

开头是输入边界。 这份工具吃什么?文件放哪个目录?格式、列名、编码有没有要求?哪些情况是允许的输入,哪些要直接拒绝?写不清这一项,后面全是黑盒。

第二项,目录和权限。 读哪个目录、写哪个目录、谁能改、默认能不能联网?Codex 之类的工具用 sandbox 和 permissions 控制边界,交接单要把这些边界写下来,不能让"目录能访问"只停在口头。

第三项,运行命令。 在干净环境下,从零到跑起来需要哪几条命令?作者用他电脑里的环境能跑,不代表新环境也能跑。命令要能在交接单上复制出来,而不是"你跑一下就知道了"。

第四项,依赖清单。 用到的库、版本、系统要求,逐条列出。缺哪条、补哪条,都要能查。我见过很坑的,是作者用了一个别人根本没装的环境变量,交接时谁都没提。

第五项,失败处理。 输入不对、网络断开、权限不足,工具会怎样表现?是明确报错,还是静默出错?一项内部工具如果失败时不说话,信息科根本没有办法排查。

第六项,测试用例。 至少留一组正常输入和一组异常输入,写明预期输出。这样接手后跑一遍,就能知道工具还正常不正常,而不是凭感觉。

第七项,验收标准。 什么情况算"这次交付合格"?由谁签字?工具交给信息科,不等于作者验收。业务口径、安全审查、正式上线,每一道都要有人认领。

让 Codex 帮你把交接单"跑成真的"

交接单填完,不等于工具能跑。我建议信息科下一步做一件事:让 Codex 在干净的、只读的目录里,按交接单的命令重跑一遍。

给它三个限定:只读样例数据;只允许修改指定工作目录;默认不联网。然后让它照着交接单的命令装依赖、跑测试、复现一遍异常分支。

这一步的意义不是让 Codex 替信息科验收,而是验证交接单写得够不够。如果 Codex 按交接单跑不通,说明交接单缺内容,信息科有权打回作者补。Codex 读代码、改文件、跑命令、补测试都可以做,但它不能替你判断业务口径,也不能替你签字。

工具负责跑,人负责定标准。这个顺序不能反。

接手的收尾一步:留一次复跑记录

交接单不是一次性的。真正证明"能接手",是第二次、第三次还能跑起来。

我建议每次跑,都留三样东西:运行时间、用的版本、结果截图或日志。这样工具哪天坏了,信息科能对着上次的记录定位,而不是从头猜。

这也是我反复讲"留证"的原因。一份工具如果连"上次跑是什么时候、什么结果"都查不到,它就还停在作者的个人项目阶段,没有真正进部门。

用一张交接单跑通一个真实例子

光讲模板,不如看一遍它怎么用。我拿医院里很常见的一个例子说:一套设备巡检小工具。

假设信息科要接手同事做的一套设备巡检工具,输入是各科室上报的巡检表。接手那天,你拿出交接单,让作者一项项填。

输入边界这一项,作者写:只接受 .xlsx,首行必须是列名,设备编码 列不能为空。你顺手问一句:如果科室上传的是 .csv 呢?作者答:不支持。于是你在交接单上标注"仅支持 xlsx,csv 需先转换"。这就是把没说出来的前提挖出来了。

目录权限这一项,作者写:读取 /data/incoming,写入 /data/out。你追问:程序会不会自己联网更新依赖?作者说会。你决定在交接单上写明"生产环境默认断网,依赖由信息科统一更新"。边界一旦写成字,后面就不会因为"它自己联网了"而失控。

运行命令这一项,作者写了两行命令。你照着在干净的测试目录跑,发现少装了一个依赖。你在交接单上补上安装步骤,并让作者确认没有其他遗漏。这一步,把"作者电脑里能跑"变成了"任何信息科同事照单都能跑"。

失败处理这一项很见功力。你故意传一份列名不同的文件进去,看它怎么表现。如果它静默通过、把整列当成空值,那就是一个必须写进交接单的坑,而且要作者修复或给出处理说明。工具可以不完美,但不能在出错时沉默。

收尾的测试用例和验收标准,你让作者留了一组正常输入、一组异常输入,并写明"全部用例通过 + 业务抽查一致"才算合格。到这一步,这套工具才算真正从"作者的项目"变成"信息科能接手的工具"。

一张七项的交接单,跑完这个例子,你能明显感觉到:它不是一张纸,而是一次把隐性知识逼到明处的对话。

从一张交接单开始

如果你所在的医院也在讨论要不要接别人做的 AI 工具,别先谈功能多强大,先让作者把交接单填完。

一张填满七项的交接单,比十个演示视频更能说明这个工具能不能接手。

关于承叔

我是承叔,一名中国三级公立医院医生。10年以上医疗实践中,我在急诊科工作过,目前正在转向整形医学方向,也长期实践AI Agent。

我关注的不是又多了一个工具,而是医疗从业者怎样把工具变成可执行、可交接、可复盘的工作链,完成医疗AI时代的职业升级。

评论区回复「交接单」,我把《信息科 AI 工具交接单》模板发出来。它用于内部流程改进,不替代本单位的信息安全、采购与验收制度。

本文为承叔原创。 内容基于公开工具文档与个人实践整理,不构成任何医疗或系统建议。