曾巩《越州赵公救灾记》：一篇穿越千年的技术文档，致敬匠人精神

曾巩《越州赵公救灾记》一篇穿越千年的技术文档致敬匠人精神曾巩的这篇救灾记堪称古代版’项目报告’范本。马伯庸评价其’逻辑严密、条理清晰、文风质朴活脱脱就是一份优秀的项目报告或政府公文’。“好的文档穿越千年仍有价值。”一、背景一场千年前的重大故障北宋熙宁八年1075年吴越地区遭遇罕见旱灾“民饥馑疾疠死者殆半”灾情前所未有。时任越州知州的赵抃谥号清献人称铁面御史面临的是一场复杂的系统工程资源短缺官府常规赈灾粮仅3000石远远不够人口众多需救济的孤老疾弱达21900余人次生风险饥荒引发瘟疫、流民、社会动荡跨部门协调民政、医疗、工程、财政多线作战赵抃如何破局曾巩用一篇不足千字的文档记录了整个救灾项目的全生命周期。二、文档结构古代版项目报告范本马伯庸评价此文没有任何华丽辞藻却直击每一条打工魂。从技术文档角度看其结构堪称教科书级别1. 需求调研7个问题摸清现状“为书问属县灾所被者几乡民能自食者有几当廪于官者几人沟防构筑可僦民使治之者几所库钱仓粟可发者几何富人可募出粟者几家僧道士食之羡粟书于籍者其几具存”技术人翻译项目启动前先完成尽职调查——覆盖范围、受影响用户数、资源缺口、可调用资源、外部依赖、存量数据。没有一句虚话全是关键指标。2. 方案设计系统性解决复杂问题措施现代对应细节亮点粮食发放核心服务部署“人受粟日一升幼小半之”——精确到用户分级配额错峰领取流量削峰“男女异日人受二日之食”——避免并发踩踏57个发放点分布式节点“于城市郊野为给粟之所凡五十有七”——就近访问降低延迟以工代赈资源置换“僦民完成四千一百丈为工三万八千”——用劳动换取报酬而非直接施舍病坊隔离灾备方案“为病坊处疾病之无归者”——防止瘟疫次生灾害官为责偿信用担保“告富人纵予之而待熟官为责其偿”——政府背书激活民间信贷3. 数据驱动一切用数字说话常规赈灾粮3000石实际筹集富人捐粮僧道余粮48000余石官仓平粜52000余石修城工程4100丈用工38000个发放点57处卖粮点18处技术人共鸣这不是拍脑袋决策而是基于数据的精准资源调度。4. 风险预判前置思维赵抃的文档中处处可见防御性编程思维防踩踏男女分日领取每人发两日粮减少排队次数防流民在郊区设点但去其家者勿给——防止套利防瘟疫提前设立病坊“募僧二人属以视医药饮食”防道德风险政府为民间借贷担保但待熟后责偿——闭环管理5. 复盘总结可复用的方法论曾巩在文末点明写作意图“其事虽行于一时其法足以传后……使吏之有志于民者不幸而遇岁之灾推公之所已试其科条可不待顷而具”技术人翻译这篇文档不仅是项目总结更是标准操作手册SOP。后人遇到同类故障可直接参照执行无需重复造轮子。三、技术人的共鸣为什么这篇文档能穿越千年1.清晰胜于华丽马伯庸说曾巩是唐宋八大家中的小透明但最值得普通人学习。苏轼、李白是天才曾巩是实干家——他的文章逻辑严密、条理清晰、文风质朴活脱脱就是一份优秀的项目报告或政府公文。启示技术文档不需要辞藻堆砌清晰、准确、可执行才是核心价值。2.细节决定成败从男女异日到幼小半之从57个发放点的选址到去其家者勿给的规则设计——这些细节体现了对人性与系统的深刻理解。启示优秀的技术方案不仅要解决主流程更要考虑异常分支、边界条件、用户体验。3.文档即传承赵抃的救灾措施只施行于越州一地但曾巩的文档让这套方法足以传后。千年后的今天我们仍能从中学到危机管理、资源调度、跨部门协作的智慧。启示我们写的每一篇技术文档、API说明、事故复盘都是留给未来的遗产。写好它是对匠人精神的致敬。四、结语致敬匠人精神曾巩写《越州赵公救灾记》时或许只是如实记录一位好官的政绩。但他没想到这篇项目报告会成为穿越千年的技术写作范本。作为技术人我们每天都在写文档设计文档、API文档、复盘报告、操作手册。它们或许枯燥或许无人问津但请相信——好的文档穿越千年仍有价值。当你深夜加班写技术方案时当你反复打磨API文档时当你详细记录事故复盘时——你不仅在完成当下的工作更是在书写属于这个时代的《越州赵公救灾记》。保持好奇保持严谨保持对细节的执着。这就是技术人的匠人精神。本文部分内容参考马伯庸《历史中的大与小》及曾巩《越州赵公救灾记》原文【推荐阅读】马伯庸《历史中的大与小》湖南文艺出版社2025年12月曾巩《越州赵公救灾记》全文及译文越州赵公救灾记 曾巩曾巩〔宋代〕熙宁八年夏吴越大旱。九月资政殿大学士知越州赵公前民之未饥为书问属县灾所被者几乡民能自食者有几当廪于官者几人沟防构筑可僦民使治之者几所库钱仓粟可发者几何富人可募出粟者几家僧道士食之羡粟书于籍者其几具存使各书以对而谨其备。州县史录民之孤老疾弱不能自食者二万一千九百余人以告。故事岁廪穷人当给粟三千石而止。公敛富人所输及僧道士食之羡者得粟四万八千余石佐其费。使自十月朔人受粟日一升幼小半之。忧其众相蹂也使受粟者男女异日而人受二日之食。忧其流亡也于城市郊野为给粟之所凡五十有七使各以便受之而告以去其家者勿给。计官为不足用也取吏之不在职而寓于境者给其食而任以事。不能自食者有是具也。能自食者为之告富人无得闭粜。又为之官粟得五万二千余石平其价予民。为粜粟之所凡十有八使籴者自便如受粟。又僦民完成四千一百丈为工三万八千计其佣与钱又与粟再倍之。民取息钱者告富人纵予之而待熟官为责其偿。弃男女者使人得收养之。明年春大疫。为病坊处疾病之无归者。募僧二人属以视医药饮食令无失所恃。凡死者使在处随收瘗之。法廪穷人尽三月当止是岁尽五月而止。事有非便文者公一以自任不以累其属。有上请者或便宜多辄行。公于此时蚤夜惫心力不少懈事细巨必躬亲。给病者药食多出私钱。民不幸罹旱疫得免于转死虽死得无失敛埋皆公力也。是时旱疫被吴越民饥馑疾疠死者殆半灾未有巨于此也。天子东向忧劳州县推布上恩人人尽其力。公所拊循民尤以为得其依归。所以经营绥辑先后终始之际委曲纤悉无不备者。其施虽在越其仁足以示天下其事虽行于一时其法足以传后。盖灾沴之行治世不能使之无而能为之备。民病而后图之与夫先事而为计者则有间矣不习而有为与夫素得之者则有间矣。予故采于越得公所推行乐为之识其详岂独以慰越人之思半使吏之有志于民者不幸而遇岁之灾推公之所已试其科条可不待顷而具则公之泽岂小且近乎公元丰二年以大学士加太子保致仕家于衢。其直道正行在于朝廷岂弟之实在于身者此不著。著其荒政可师者以为《越州赵公救灾记》云。