S24-A03 · 团队落地与效率度量

适用读者：要向管理层汇报"AI 到底有没有用"的人。
前置：S24-A02。
覆盖旧文：699(176) 695(191) 1956(194) 124(274) + Skills 类 = 1,284 点。
覆盖扩展：E-S24-008（效率度量三指标）、E-S24-012（迁移路径）。
上一篇：S24-A02 · 自动化与 CI/CD：codex exec 与 Agent SDK
下一篇：S24-X01 · 叙事登记与工具矩阵。

1. 一句话结论

"AI 提升 40% 效率"这类数字通常无法归因。可核验的做法是盯三个过程指标：周期时间、返工率、评审意见数——并明确写出"哪些无法归因"。

指标	定义	为什么可信
周期时间	从开工到合并的时长	系统里有记录
返工率	合并后被回退/重改的比例	可对比前后
评审意见数	每个 PR 的意见条数	反映质量负担

"为什么不报'代码行数'"：行数是产出不是价值——AI 让行数暴涨，可能反而增加评审负担。

2. 归因的诚实边界（E-S24-008）

能归因	不能归因
同一团队、同类任务的前后对比	跨团队对比（任务难度不同）
周期时间的系统记录	"感觉更快了"
返工率变化	长期维护成本

判据："这个数字换个团队还成立吗？" 不成立 → 别当结论，只当观察。

3. 落地路径（E-S24-012）

阶段	动作	验收
① 试点	1–2 人用，只读 + 建议	无事故
② 推广	全员，L2 权限 + 门禁	返工率不升
③ 深化	CI 自动化、Skills 复用	周期时间下降
④ 治理	审计、合规、成本	可追溯

判据："试点期出过几次越界改动？" 出过 → 先补权限（A01），别急着推广。

4. 从其他工具迁移（A-695）

迁移项	工作量
规则文件	重写（格式不同）
钩子/门禁	重配
Skills/插件	重新封装（A-1956）
团队习惯	最难（快捷键与会话习惯）

判据："规则文件能直接复制吗？" 不能 → 迁移要按"机制映射"重写，不是复制粘贴。

5. 五个误区

误区	真相
"行数增加=效率提升"	可能只是评审负担
"跨团队对比可得结论"	任务难度不同
"试点没问题就能全量"	规模会放大风险
"迁移只是换工具"	规则/钩子要重写
"效率提升一定能归因"	部分无法归因，要写明

6. 自检（架构师版）

三个过程指标与可信原因？
为什么不用代码行数？
归因的边界在哪？
四阶段落地与验收？
迁移的四类工作量？

7. 下一篇

S24-X01 · 叙事/面试登记与工具矩阵

最后一篇是附录，随后进入 S27/S25。

本篇属于系列《S24 · AI 编程工具》。旧文来源：A-699/695/1956/124 + Skills 类；扩展点 E-S24-008/012。