Technical Communication & Impact: 如何做技术传承与知识沉淀？

Core Concept: 通过文档（设计/复盘/runbook）、代码规范与评审、结对与分享、以及可复现的实验记录，把个人知识转化为团队可复用的资产。

数学机理：<strong>知识传承的渠道</strong>——(1) <strong>文档（docs）</strong>——(a) <strong>类型</strong>——设计文档（为什么这么设计）、ADR（关键决策）、复盘（事故教训）、runbook（运维操作）、模型卡/数据卡（模型与数据）、教程/onboarding（新人上手）；(b) <strong>原则</strong>——与代码同仓库、版本化、可搜索；(c) <strong>避免</strong>——文档散落、过时、无人维护。(2) <strong>代码（code）</strong>——(a) <strong>规范</strong>——风格统一、命名清晰；(b) <strong>注释</strong>——解释'为什么'而非'是什么'；(c) <strong>评审</strong>——知识通过评审流动（评审者学到新东西，被评审者得到反馈）；(d) <strong>测试即文档</strong>——测试展示预期行为。(3) <strong>结对与分享（pairing & sharing）</strong>——(a) <strong>结对编程</strong>——实时知识传递；(b) <strong>组会分享</strong>——论文/技术/项目分享（以教促学）；(c) <strong>内部讲座</strong>——深度技术讲解；(d) <strong>导师制</strong>——新人带教。(4) <strong>可复现记录（reproducible records）</strong>——(a) <strong>实验记录</strong>——配置、结果、结论（便于他人复用与避免重复）；(b) <strong>笔记本/报告</strong>——关键分析；(c) <strong>数据与模型版本</strong>——可追溯。(5) <strong>降低门槛（onboarding）</strong>——(a) <strong>新人文档</strong>——环境搭建、代码结构、常用命令；(b) <strong>示例代码</strong>——可运行的最小示例；(c) <strong>FAQ</strong>——常见问题；(d) <strong>作用</strong>——减少重复答疑、加速上手。(6) <strong>知识沉淀的挑战</strong>——(a) <strong>维护成本</strong>——文档易过时（需与代码同步更新）；(b) <strong>激励</strong>——写文档不被重视（需文化与管理支持）；(c) <strong>过度文档</strong>——写太多无人读；(d) <strong>隐性知识</strong>——难以文档化（需结对/分享）。(7) <strong>做法建议</strong>——(a) <strong>写作为工作的一部分</strong>——把文档计入工作量；(b) <strong>模板化</strong>——降低写作成本；(c) <strong>就近维护</strong>——文档与代码同仓库、同 PR 更新；(d) <strong>定期清理</strong>——删过时文档；(e) <strong>以教促学</strong>——分享是最好的学习；(f) <strong>复盘文化</strong>——把教训沉淀为文档。(8) <strong>判断标准</strong>——(a) 新人能否独立上手；(b) 关键决策能否被理解；(c) 事故教训是否被记录；(d) 实验能否被复用。<strong>与其他问题的关系</strong>——(a) 与 ADR（决策记录）；(b) 与事故复盘（教训沉淀）；(c) 与研究代码质量（可复现）；(d) 与团队协作。<strong>度量</strong>——(a) 新人上手时间；(b) 文档更新及时性；(c) 重复答疑频率；(d) 分享频率。

深度剖析与工程权衡：① <strong>'写在代码里'不够</strong>——设计理由与决策需文档化；面试中能指出这点是深度理解的标志。② <strong>文档维护成本是主要挑战</strong>——需就近维护与定期清理。③ <strong>评审是知识流动的重要渠道</strong>——不只是找 bug。④ <strong>以教促学</strong>——分享是最好的学习。⑤ <strong>可复现实验记录避免重复劳动</strong>。⑥ <strong>需文化与激励支持</strong>——写文档应计入工作量。⑦ <strong>面试要点</strong>——被问怎么做知识传承，应给出'<strong>文档（设计/ADR/复盘/runbook/模型卡）+ 代码规范与评审 + 结对与分享 + 可复现实验记录 + 降低上手门槛</strong>'；能指出文档维护成本与评审的知识流动作用是深度理解的标志。