AI团队知识沉淀实践指南

我们把知识分成 5 层就像家里的收纳柜再也不乱了。从个人小抽屉到全家共用储物柜再到厨房调料架、冰箱食材分区最上层是临时收纳箱。添加图片注释不超过 140 字可选最近 AI 圈的朋友见面开口闭口都是 “Harness Engineering” “我们搭了 16 阶段的 Agent 工作流” “我们的多 Agent 协同能自动跑完全流程” “我们用了最新的 SOTA 模型效率翻了 3 倍”大家都在卷工具、卷工作流、卷模型大小仿佛谁的流水线搭得更复杂谁就赢了。我们团队跟风折腾了大半年最后才踩坑发现搭再复杂的工作流都只是搭管道真正能让你拉开差距的是管道里流的水 —— 你团队自己沉淀的知识。工具会过时模型会迭代工作流会重构但你团队在业务里摸爬滚打攒下的经验、踩过的坑、总结的规则这些才是别人抢不走的护城河。流水线再高级没独家配方也白搭添加图片注释不超过 140 字可选就像开奶茶店你花大价钱搞了最先进的点单系统、最顺的出餐流水线从点单到做茶到打包5 步就能出餐看起来效率拉满。但如果你的配方就是网上随便能搜到的 “红茶 牛奶 糖”那隔壁店抄了你的流水线用一样的配方分分钟就能把你卷死。反而是那些藏在你店里的、自己试了几十次才摸出来的独家配方比如三分糖要少放 5ml 糖浆冰度要控制在 - 2 度才不会化太快高并发点单的时候要先做冰饮不然会化 —— 这些只有你自己知道的东西才是别人抄不走的。我们做 AI 团队也是一样 今天用状态机编排工作流明天可能就换成 DAG今天用这个 Agent 调度模式明天模型厂商直接把这个能力内置了。这些流水线的东西说换就换。但你攒下的 “广告预算扣减高并发会超扣得用 RedisLua 保证原子性” 这种经验不管你用什么工作流、什么模型它永远有用。这就是我们踩了半年坑才想通的工作流是可替换的知识才是能一直累积的。没有知识的工作流就是一次性的每次做项目都要从零开始上次踩的坑下次照踩不误。我们把知识分成 5 层就像家里的收纳柜再也不乱了添加图片注释不超过 140 字可选搞清楚了知识的重要性接下来的问题就是这么多知识怎么存总不能全都堆在一个文件夹里要用的时候翻半天吧我们的办法很简单就像家里收拾收纳柜一样把知识按范围分了 5 层谁用什么去哪拿一目了然最下层个人小抽屉就是你自己的小习惯比如你喜欢 4 空格缩进还是 2 空格偏好函数式还是面向对象这些不用跟别人共享自己用着舒服就行。往上全家共用储物柜这是团队的 “宪法”比如代码规范、Commit 规范、Review 的标准所有人都要遵守统一存在团队的共享目录里。再往上厨房调料架这是跨项目通用的技术知识比如 “Spring Boot 多租户拦截器怎么写”“Optional 依赖传递有什么坑”不管做什么项目这些技术经验都能用。然后冰箱食材分区这是特定业务的知识比如我们做广告业务就把广告的审核流程、业务规则、领域模型都存在这按领域分好区要用的时候直接拿。最上层临时收纳箱这是单个项目里的临时知识比如 “这个项目用的是 MySQL8.0”只有这个项目有用项目结束了如果发现这个知识别的项目也能用就自动挪到下面的层里不会浪费。就这么分完之后再也没出现过 “这个知识谁存的放哪了” 的问题每个人都知道自己要的东西该去哪找。踩过的坑都分类存好就像做旅行攻略一样清晰添加图片注释不超过 140 字可选存的地方搞定了那存什么呢我们发现知识其实跟你做旅行攻略是一样的就那么几类你做攻略的时候会整理景点介绍这个地方是什么样的有什么特点 —— 对应我们的 model 知识就是业务里的实体、数据结构比如 “广告计划包含预算、出价、投放时段三个核心字段”。酒店选择理由我为什么选这家酒店因为它离景点近虽然贵一点但是方便 —— 对应我们的 decision 知识就是技术选型、架构决策的理由比如 “我们选事件驱动而不是 RPC因为要解耦状态变更”。推荐 / 避坑玩法这个景点一定要早去不然人太多那个网红店别去踩雷了 —— 对应我们的 guideline 知识就是什么能做什么不能做比如 “公共模块改完之后一定要做兼容性检查”。踩过的雷上次去这里我在车站被宰了你们别上当 —— 对应我们的 pitfall 知识就是已知的风险、踩过的坑比如 “广告预算扣减高并发会超扣要注意”。行程安排第一天去哪第二天去哪流程是什么 —— 对应我们的 process 知识就是业务流程、操作步骤比如 “广告审核是提交→机审→人审→上线”。你看就跟做攻略一模一样我们把所有的知识都按照这五类分每一条知识只属于一个类这样不管是谁要找什么一眼就能找到再也不会乱。知识也会过期我们给它加了保质期添加图片注释不超过 140 字可选你肯定有过这种经历收拾冰箱的时候翻出来半年前的牛奶早就过期了扔了可惜留着又不能喝。知识也是一样的三年前的 “最佳实践”现在框架都更了好几个版本了早就过时了要是还留着反而会坑了新人。所以我们给所有的知识都加了 “保质期”就像冰箱里的食物一样最靠谱的、经过好几个项目验证过的成熟知识保质期 12 个月12 个月没人用就降级成待验证的。待验证的知识保质期 6 个月6 个月没人用就再降级成草稿。草稿要是一直没人用就直接归档移出活跃的索引别占地方。这样就不会出现那种 “三年前的老黄历还在给新人当指南” 的情况过时的知识会自己慢慢 “消失”不会误导人。建了个共享笔记库新人再也不用追着老人问了添加图片注释不超过 140 字可选之前我们团队最头疼的就是新人入职 新人来了啥都不懂追着老员工问“这个业务的规则是什么”“这个坑之前是怎么解决的” 老员工自己的活都干不完还要天天给新人答疑烦都烦死了。后来我们搞了个团队的 “共享笔记库”—— 一个独立的 Git 仓库不跟任何业务项目绑在一起所有的知识都存在里不管项目怎么归档、怎么重构知识永远都在。所有人都能往里面加内容你踩了个坑就写进去你总结了个经验也加进去。新人来了不用追着人问直接翻这个笔记库所有的规则、经验、坑全都有自己看就能懂3 天就能上手老项目。而且这个笔记库是跨项目的A 项目踩的坑B 项目直接就能看到不用再踩一遍A 项目总结的经验B 项目直接就能用相当于所有人的经验都攒在一起大家一起站在前人的肩膀上。每次做完项目都在自动攒 “经验积分”添加图片注释不超过 140 字可选你肯定办过奶茶店的积分卡每次买一杯奶茶就盖一个章攒够了就能换免费奶茶越攒越多越喝越划算。我们的工作流也是一样的它不是做完项目就完了每次做完都会自动给你攒 “经验积分”项目启动的时候自动把团队的知识拉过来新的工作流直接就能用之前攒的所有经验。做项目的过程中Agent 会按需查知识库遇到问题直接看之前的人是怎么解决的不用自己瞎试。项目结束的时候自动把这次项目里的新经验、新踩的坑提取出来存到知识库⾥相当于给你的积分卡又盖了个章。就这么一次次攒你的知识库会越来越厚你的团队会越来越聪明 新人来了直接用你攒了几年的经验不用从零开始 新项目启动直接用之前所有项目踩过的坑、总结的规则不用再踩一遍。这就是知识的复利就像攒积分一样越攒越多到最后你的团队的效率会把那些只会跟风搭工作流的团队远远甩在后面。最后想说的话现在 AI 圈太卷了大家都在抢最新的模型搭最复杂的工作流好像谁的工具更先进谁就赢了。但我们折腾了这么久才发现真正的护城河从来都不是工具。 工具谁都能买谁都能抄但是你团队自己攒下来的、独一份的知识别人拿不走。这些你踩过的坑、总结的经验、摸透的业务规则才是真正能让你越做越轻松越做越厉害的东西。毕竟工具会过时但是知识永远是你的底气。 聊聊你的经验你们团队是怎么沉淀知识的是靠老人带新人还是有专门的知识库有没有过 “知识过期坑了新人” 的经历评论区聊聊