八百字项目简报与编码代理的两周入职对照

01 · 口头带教让位：两周入职里两组真实的对照

在长期跑高并发与持续重负载的团队里，新人前两周的产出几乎决定整条交付节奏。我们把一次真实入职拆成两组对照：一组沿用老人口述加随手提问，另一组从第一天起就发下一份约八百字的书面项目简报，并允许新人直接用编码代理在仓库里动手。两周后，口头组的返工集中在配置口径、命名约定和边界条件，同一段解释被重复了不下五次；简报组把这些问题压到评审环节一次性解决，老工程师只在关键分叉处做判断。

差距不在人的能力，而在上下文的可复用性。口头带教的上下文存在于聊天记录和记忆里，新人一换班就断了；书面简报是一份可版本化的资产，写一次，之后每一届新人、每一个编码代理会话都能拿到同样的起点。还有一笔容易被忽略的账：每次口头解释都要占用两位工程师的整块时间，而这些时间一旦被打断就很难续上；简报写成后，同样的问题由文档和代理吸收，评审会议只讨论真正需要人的判断题。新旧两代简报之间的差异，也顺手记录了系统演进的轨迹。

02 · 八百字简报的固定骨架：背景、边界、验收

简报不是散文，它有固定的三段结构，每一句都必须可执行：

• › 背景与目标：这个模块在整条链路里的位置、当前的负载形态、本次入职要交付的具体功能，不含历史八卦。
• › 约束与边界：依赖版本、禁止改动的模块、性能与配额红线、日志与错误处理的统一口径，这些是返工最高发的区域。
• › 验收清单：可勾选的检查项，包括测试范围、评审关注点、上线前必须确认的配置项。

写简报的人大约要花两个小时，换来的却是全组不再重复解释同一件事。八百字的上限是有意为之：超过这个体量就没人读完，短到只剩口号又无法约束代理，恰好卡在新人能一口气读完、代理能完整纳入上下文的长度。

执笔人固定为该模块的负责人，而不是最熟悉文档格式的人；格式可以复用模板，内容必须来自真实踩过的坑。措辞上尽量写清楚做什么和不做什么，少写理念，多写判断条件，比如把性能要求写成具体的红线口径，把错误处理写成统一的日志字段约定，而不是笼统地说要稳健。简报发布后进版本库，谁发现口径过时就直接提交修订，评审通过即生效。

03 · 编码代理被简报约束后的协作形态

简报发出后，它同时是新人的入职文档和编码代理的会话起点。代理读完简报先给出改动方案，人只负责判断方案是否越界；进入实现后，产出必须对照简报末尾的验收清单逐条自检。原本需要老人示范的那些细节，如今写在约束段里，代理照着执行。

• › 重构与测试补全交给更强的推理模型，例如 Claude Sonnet 5.5，它对边界条件的处理更稳。
• › 补丁草拟、注释补全、样板代码这类高频小步任务，用响应更快的 DeepSeek V4 Flash 跑批量尝试，试错成本更低。

当代理产出与简报冲突时，以简报为准；简报本身有错就当场修订并提交版本，而不是在私聊里口头更正。这条规则让简报越用越准，也让代理的输出越来越接近可直接合并的形状。

日常工作流也随之收敛成固定几步：先让代理复述简报里的约束与验收项，确认它没有遗漏；再让代理列出改动计划并标注风险点；实现完成后要求它对照验收清单逐项自检并给出遗留项。新人的职责是审读这三步的产物，把真正需要经验判断的问题带给老人。这样一轮会话下来，新人学到的是系统边界而不是快捷键，老人省下的是重复讲解而不是监督成本。

04 · 真实 token 计量如何改写新人的试错预算

重负载团队最怕的是新人练习期把预算烧穿。我们把接入统一放在 Quanta 上：一个余额覆盖多种模型，按真实 token 计量，缓存写入与缓存读取分开计价，按周发放额度并查看明细，谁在哪个会话烧了多少一目了然。

这个计价口径反过来影响了简报的写法：稳定的项目背景、约束条款放进固定的前缀，一次缓存写入之后反复复用；变化的任务描述放在会话尾部。新人改十轮代码时，大头是缓存读取而非重新生成，试错的边际成本被压得很低。对每天都在跑长会话的团队，这种拆分比笼统的调用计数更有意义。

预算管理也跟着细化到人和周：给每位新人设定每周的试错额度，超出后先把长会话拆短、把不必要的上下文清掉，再考虑追加；每周回看用量明细，找出那些反复生成却很少被采纳的会话模式，写进简报的约束段让它们消失在源头。对跨多个模型混跑的团队，一个余额、一份账单的形态也省掉了逐家对齐额度口径的杂活。

另外，团队里推荐同事开户的人，可以从对方充值金额中拿到 19% 的返佣，这笔钱通常直接回流到试错预算池里。

05 · 三道放量闸门：从单人试点到全组常驻

路线铺好后，放量要按闸门走，不能一次铺开：

• › 闸门一：首周结束前，简报必须被实际使用过并至少修订一次，未被触碰的简报视为无效文档。
• › 闸门二：代理产出必须走与人工产出完全相同的验收清单和评审，不允许为新人放宽标准。
• › 闸门三：按真实 token 用量回看默认模型与并发设置，把高频小任务留给快模型，把难任务留给推理模型。

三道闸门各自对应一个可观察的信号：简报修订记录、评审返工集中点、用量明细曲线。任何一道不达标就停在原地修整，而不是带着隐患扩员；闸门通过后再按批次加入下一批新人，老批次的简报直接成为新批次的起点。

过了三道闸门，新人第二周就能独立承接真实工单，老人的角色从陪跑转为评审。两周下来，口头组还在解释配置口径，简报组已经在修订下一版简报本身。若你的团队也正被持续重负载和入职成本夹在中间，现在就可以开通一个 Quanta 账户，用一个余额把简报驱动的这套节奏跑起来。