结论先说:只参与局部工作时,真实描述的关键不是把整条采集链路说成自己的成果,而是把“我负责的环节、可验证的产出、以及我不能推出的结论”三件事分开写。这样做成立的前提是:你能拿到自己环节的原始输入与输出记录,哪怕没有服务器权限、没有全量日志、也没有最终上线数据。反例是:如果连自己环节的输入输出都拿不到,只剩口头回忆,那么任何“贡献描述”都只能算自述,不能当作可核验依据。
火车头采集的完整链路通常包括:确定目标站点与字段、写采集规则、处理列表页与详情页、配置发布接口、去重与清洗、定时任务、异常重试。多数人只参与其中一段,比如只写规则,或只做字段映射,或只维护发布环节。
描述贡献前,先写清三件事:
这三项决定你能说到哪一步。只写规则的人可以说“规则在给定样例上取到了目标字段”,但不能说“整站数据已稳定入库”。
没有全量日志和后台权限时,仍然可以做一件具体的事:用固定样例做局部验证,并留下可复现的记录。
假设你只负责详情页字段规则。你可以取三条有代表性的详情页地址,把它们作为固定样例,逐条记录:字段名、期望值、实际取到的值、是否一致。这个动作不需要数据库权限,也不需要发布接口,只需要浏览器或规则测试功能。
它的结果是:你能说“在三条指定样例上,标题与发布时间字段取值一致”,而不能推出“所有页面都能取到”“采集任务没有漏页”“发布后不会重复”。下一步动作取决于这个结果:如果三条样例里有一条不一致,先修规则再扩大样例;如果三条都一致,再把样例扩到覆盖不同模板的页面,而不是直接宣布规则完成。
常见的问题是把自己的环节放大成整体结果。以下说法在只参与局部时应当避免:
更可信的写法是把范围写进句子:“我负责详情页字段规则,在三条覆盖两种模板的样例上完成取值验证;列表页翻页与发布去重由其他环节处理,我未参与验证。”
把贡献写成四句话,顺序固定:
这套结构的好处是,即使没有完整数据,读者也能判断你的贡献真实到什么程度。它不承诺任何排名或效果,只承诺把可核验的部分和不可核验的部分分开。
有些局部工作确实没有独立交付物,比如只做规则调试、只帮忙核对字段、只参与问题排查。这时不要硬造产出,改为描述你解决的具体差异。
例如:同一批详情页里,部分页面的价格字段带单位、部分不带。你做的动作是统一取值规则,让两类页面输出同一格式。可验证的结果是:在指定的两类样例上,输出格式一致。不能推出的是:所有历史页面都已被重新处理。下一步动作是:确认是否需要回刷旧数据,这一步通常超出规则环节,需要另行确认权限和范围。
如果连这种差异记录都没有,只剩“我参与了采集项目”,那就如实写参与,不要附加结果性判断。真实描述的门槛不是贡献大小,而是你说的每一句都能对应到一个输入、一个动作或一个可复查的记录。