团队需要准备
既有代码与配置、广告报表及模块说明、交接文档和会议口径、最影响投放判断的规则问题，以及能够确认经营基准的业务负责人。
这项工作为什么值得做
在继续用工具支持广告决策前，怎样把“团队以为的规则”核实成大家都能复查的事实？
对业务的价值
把隐蔽的规则差异提前摆到业务和研发面前，减少接手者带着错误假设使用工具的风险；后续修改也能围绕明确问题和确认责任展开。
- 01列出工具支持的投放判断
- 02提取交接材料中的规则
- 03逐条查配置与实际执行
- 04说明差异影响哪些判断
- 05标明需业务拍板的事项
- 06交付带位置的复查材料
这轮交付留下什么
- 文档口径与实际行为对照表
- 关键规则与配置的代码定位
- 已确认事实及业务待确认清单
- 可供后续接手者复查的交接文档
试点怎样验收
- 关键决策规则有无实现依据及定位
- 查出的口径差异与待确认事项闭合情况
- 接手者独立复核规则所需时间和追问次数
用示例看清处理方式
新词该不该被判负，先查保护规则有没有生效。
一次技术交接，真正要交清楚的是：当前实现了什么，哪些配置没有参与运行，还有什么必须由业务确认。
图解 01案例图解 · 中文画板
探索期保护写在配置里，判断流程却没有读取。
按本案查证逻辑重新整理的工作画板；规则甲、乙为匿名示例。
图解重点
沿着“文档与配置 → 实际读取 → 进入判断”看两条路线：一条实际生效，另一条停在声明。查证交付事实与待确认项，不代表已经修复。
本案的工作
Steve 以文档声明为入口，追踪定义、读取、传递与使用，再将差异写入可复核的交接清单；并不因此成为原工具的开发者。
01 / THE ASSIGNMENT
业务卡在哪里，
工作就从哪里开始。
团队长期使用内部广告分析工具，交接时却发现文档、会议说法和实际行为不一致。接手者需要知道哪些词被纳入分析、哪些保护生效，以及图表和建议采用了什么基准。
投放同事需要建议，也需要知道建议怎么算出来
同一份交接材料把判定标准描述成固定分界，工具却可能随数据变化调整分界。团队若按旧理解解读图表，会在不同的前提上讨论预算。
以为新词受保护，实际规则却没有接上
探索期保护参数写在配置中，判断流程却未读取。接手者需要知道保护是否真正生效，才能理解为什么某些搜索词被纳入分析。
盈亏基准看起来确定，业务依据却没有交接
一个默认值可能只是开发时的占位。若未经确认就用于饱和度分析，图表虽能生成，经营含义仍可能偏离实际。
02 / THE CONTINUOUS WORK
每一步的产物，
都要能接到下一步。
展开每个阶段，查看输入、关键判断、具体行动、产物与后续使用。每一步都交代下一位怎样接着做。
01先列出团队用这套工具做哪些判断
业务用途与实现位置对应的模块地图。
先列出团队用这套工具做哪些判断
业务用途与实现位置对应的模块地图。
- 接到什么
- 广告报表、策略视图、交接材料和既有代码。
- 关键判断
- 查证要回答接手者的真实问题：报表怎样进入工具，哪些模块会影响搜索词与投放判断。
- 具体行动
- 梳理输入报表、清洗与分析模块，找到四象限、饱和度等关键视图对应的算法入口和配置。
- 形成产物
- 业务用途与实现位置对应的模块地图。
- 怎样承接
- 团队关心的每条规则，都有了明确的追查范围。
02把“听说已经有”写成逐条查证问题
可逐条回答的交接口径清单。
把“听说已经有”写成逐条查证问题
可逐条回答的交接口径清单。
- 接到什么
- 文档和会议里对分界方式、新词保护、最小点击量等规则的描述。
- 关键判断
- 笼统说一个功能已上线，无法解释它在什么条件下作用于哪些对象。
- 具体行动
- 把口径拆成条件、计算方式与输出行为，逐项列出文档声称的规则。
- 形成产物
- 可逐条回答的交接口径清单。
- 怎样承接
- 随后按清单检查实现，避免只介绍工具结构而遗漏最影响使用的规则。
03核实哪些规则真正参与了分析
文档口径与实际行为的对照记录。
核实哪些规则真正参与了分析
文档口径与实际行为的对照记录。
- 接到什么
- 规则清单、配置、函数和实际调用关系。
- 关键判断
- 参数有名字，不代表分析时读取了它；同一视图的默认选项，也可能与交接材料不同。
- 具体行动
- 追踪分界计算、新词保护及点击门槛的读取路径，确认动态分界、未接入保护和实际纳入条件，并记录实现位置。
- 形成产物
- 文档口径与实际行为的对照记录。
- 怎样承接
- 每个差异都能回到代码复查，也能进一步解释它改变了哪些业务判断。
04把技术差异翻译成需要拍板的业务问题
已确认事实与业务待确认的分级清单。
把技术差异翻译成需要拍板的业务问题
已确认事实与业务待确认的分级清单。
- 接到什么
- 已核实的规则差异，以及盈亏基准与实际经营口径不符的反馈。
- 关键判断
- 代码能证明当前行为；使用固定还是动态分界、采用什么经营基准，仍由业务确认。
- 具体行动
- 分开记录当前行为、未接入功能和业务待确认项。默认盈亏基准经负责人复核确认为早期占位后，列入后续重新标定的事项。
- 形成产物
- 已确认事实与业务待确认的分级清单。
- 怎样承接
- 业务负责人先确认规则意图，研发再决定怎样修改以及如何验收。
05让下一位接手者能沿着证据继续工作
已交付的查证文档与行动清单。
让下一位接手者能沿着证据继续工作
已交付的查证文档与行动清单。
- 接到什么
- 查证结论、代码位置和仍需决定的事项。
- 关键判断
- 交接必须让人知道工具怎样运行、哪里不能沿用旧理解，以及下一步需要找谁确认。
- 具体行动
- 将对照结果和待拍板项整理成语义清楚的交接文档，与团队同步关键分歧及后续动作。
- 形成产物
- 已交付的查证文档与行动清单。
- 怎样承接
- 团队可以据此更新认知并安排后续修订；本案完成的是查证交接，后续修复另行实施。
03 / THE DECISIONS
价值藏在判断里，
不只在输出里。
当初稿、资料或实际行为与预期不一致时，Agent 如何定位问题，怎样选择下一步。
搜索到定义，还不够
- 改变判断的信号
- 探索保护相关参数存在，但没有进入判断流程。
- 采取的选择
- 继续追踪读取和调用位置，确认其实际作用，而不是看到名字便认定功能上线。
- 影响后续什么
- 把“有配置”与“在运行”分开，避免交接文档延续错误理解。
代码事实，不等于正确商业选择
- 改变判断的信号
- 团队理解的是固定分界，实现使用的是随数据变化的分界方式。
- 采取的选择
- 先写清当前实现，再把应该使用哪种模式交给业务确认。
- 影响后续什么
- 不越过角色边界替团队做预算策略决定，同时让讨论基于同一事实。
默认值也需要出处
- 改变判断的信号
- 某项决策基准与实际经营口径不一致。
- 采取的选择
- 追问默认值来源，负责人复核后确认它来自早期占位，不把硬编码当作既定经营事实。
- 影响后续什么
- 下一轮修订可以明确依据和验收条件，而不是继续沿用来历不明的数字。
Steve / IN PRACTICE
把工具交出去，也要把它为什么给出这条建议交清楚。
04 / WHAT CHANGED
把变化摆在一起，
看见工作的增量。
下面把原来的工作方式、Agent 的具体动作和形成的变化放在一起。结合上方产物，查看工作具体推进到了哪里。
01功能状态：从名称存在到调用可证
BEFORE / 原来的状况
配置里出现了保护参数，文档据此认为功能已生效。
STEVE / 具体工作
追踪它是否被实际判断流程读取。
AFTER / 形成的变化
明确区分“已定义”和“已接入”，后续修复需求有了具体对象。
02阈值口径：从口述规则到真实模式
BEFORE / 原来的状况
交接材料使用固定分界描述算法。
STEVE / 具体工作
定位实际计算模式和默认选项。
AFTER / 形成的变化
文档按当前实现修订；是否改变业务规则单独确认。
03盈亏基准：从沿用默认值到确认占位来源
BEFORE / 原来的状况
界面里的基准看起来像业务已经确认的数值。
STEVE / 具体工作
逐项询问依据，核对配置和团队反馈。
AFTER / 形成的变化
负责人确认默认基准来自早期占位；真实经营基准及重新标定仍列入后续事项。
05 / FEEDBACK INTO THE WORK
反馈不是插曲，
它改变了下一轮工作。
从模块阅读转向声明驱动
以“团队认为它做什么”为线索，比只整理代码文件名更接近交接痛点。
从发现差异到确认语义
实现与文档不一致时，先区分现状描述和业务期待，避免未经确认改规则。
从长报告到行动清单
结论附定位，未决事项附确认对象，让接手者可以继续工作。
06 / THE DELIVERY
留下的东西，
能被使用，也能被接手。
本案是独立技术查证，不是原工具开发案例。原代码由项目团队完成；查证与交接材料已交付，不把计划中的修复写成已经部署。
工具使用依据
把常用分析视图与实际规则、配置及实现位置对应起来。
规则差异对照
分界方式、新词保护、纳入条件等关键差异有事实依据，可由团队复查。
业务确认清单
哪些是实现事实，哪些经营口径和后续修改需要负责人拍板。
可继续使用的交接材料
已写入团队交接文档并同步，供接手者理解工具和安排后续工作。
Agent 持续推进，专业团队共同交付。
BUSINESS CONTEXT
业务负责人
提供交接问题，确认经营口径与后续修改优先级。
AGENT CONTRIBUTION
Steve
独立阅读、追踪与查证，形成可复核结论；不是原代码作者。
TEAM COLLABORATION
原研发与接手团队
解释历史背景，决定并实施后续代码或文档变更。
继续深入工程实现、补充画板与复盘
查看方法演示和更细的交接依据。业务过程与交付已在上文说明。
+
交互画板 · 试试不同判断
先交清楚工具如何得出建议，接手者才能判断哪些前提需要重新确认。
01
参数已定义
在配置中找到声明
02
参数被读取
追踪调用与传递
03
进入判断
确认条件与输出
找到定义，不能证明功能正在生效。
继续查找读取与执行路径；本图说明查证方法，不展示客户原始代码。
进一步理解工作方法
补充画板与工作方法
一次技术交接，真正要交清楚的是：当前实现了什么，哪些配置没有参与运行，还有什么必须由业务确认。
REPORT NOTES / 广告分析报告选读
一张图表可信之前，
先把输入和口径查清楚。
相关广告分析项目的报告记录了多种命名习惯、字段来源与数据清洗问题。技术查证不能止于算法：上游把什么送进来了，会直接改变下游的分析与建议。
01 / 从报告追到输入
项目复盘 · 匿名选读同样叫“广告数据”，需要回答的检查问题并不一样。
| 报告发现 | 如果跳过检查 | 形成的处理方式 |
|---|---|---|
| 产品与策略分散在两列 | 只解析活动名称，会漏掉组合名称中的产品信息。 | 双列合并 |
| 中文、英文与缩写混用 | 按固定位置切分，可能把词义与维度对应错。 | 按语义识别 |
| 文件开头含元信息 | 把第一行直接当表头，会让字段识别与整表统计一起出错。 | 定位真实表头 |
| 拆分覆盖了原始字段 | 结果看似整齐，接手者却失去了回到源记录的路径。 | 保留原列与派生列 |
| 明细粒度与样本稀疏 | 过少的点击或过细的对象，不足以支持直接的投放取舍。 | 先核对粒度 |
关键判断“文件上传成功”与“数据适合分析”是两次验收。保留原记录、说明转换方式，再核对行数、指标与模块依赖，才能把异常定位到具体一层。
02 / 一个可复核的清洗结果
拆分得到新维度，原始记录仍然留下。
示例：一条活动名称，包含产品、投放形式与匹配方式。
BEFORE
只留下拆分结果
产品甲 / 商品推广 / 词组匹配。得到新维度，但难以回到原名称核对识别是否正确。
AFTER / THE CHANGE
原始字段 + 派生维度
完整名称保留在旁边；产品、形式与匹配方式成为独立字段。发生误识别时，可以沿原记录重新检查。
- 01
文件可读
确认编码、真实表头、业务行与空表状态。
- 02
维度可解
结合组合名称与活动名称，处理语言和命名差异。
- 03
指标可对
核对花费、订单与销售字段；不同归因窗口不混算。
- 04
模块可用
检查渠道、搜索词与份额分析各自需要的输入，缺来源时不输出完整结论。
数据接收规则
哪些报表能进入哪些模块，必填字段是什么。
转换与问题记录
保留原列、记录派生字段，并留下需要人工确认的项。
分析前置条件
样本粒度、归因窗口与资料缺口先说明，再讨论投放。
以上来自相关广告分析项目的数据研究、清洗修复与验收文档。示例名称已重写，未展示账户、预算、活动名或效果数字；它不改变 Steve 作为独立查证者、而非原工具作者的角色。
07 / THE REUSABLE WORK
把一次项目经验，
拆成下一次能用的方法。
正在交接内部广告、经营分析或其他决策工具的团队，尤其是文档口径与实际行为逐渐脱节的项目。
声明驱动查证
- 需要什么
- 交接文档与既有代码
- 怎样做
- 把口径拆成可验证的行为声明
- 交付什么
- 声明—实现对照表
- 怎样检查
- 每条结论都能定位到实际实现。
配置生效追踪
- 需要什么
- 参数与调用入口
- 怎样做
- 检查定义、读取、传递和使用
- 交付什么
- 已生效与未接入清单
- 怎样检查
- 不把搜到参数当作功能已经工作。
技术与业务边界交接
- 需要什么
- 实现事实与业务期待
- 怎样做
- 拆开现状、差异与待拍板事项
- 交付什么
- 可交接的分级说明
- 怎样检查
- 接手者知道哪些可以用、哪些先问清。
A PRACTICAL START
下一次，可以从这里开始。
先选一张团队依赖的分析视图，核实最影响判断的规则，把真实行为和需要业务确认的事项交清楚。
了解 AIelsen 的 Agent 与 FDE 交付 ↗把本案的工作方法用于你的任务
下载协作工作表 ↓可编辑 Markdown · 无客户原始资料KEEP EXPLORING
下一段工作，也值得看。
Atlas↗
从众筹项目的异常线索，
做到可逐项复核的调查报告。
让调查者拿着同一份检查方法，看到线索来自哪里、还有什么没有查清。
交付
可复用的调查步骤与规则说明 · 带来源和缺口的结构化调查报告
Oliva↗
接住产品、物流与售后问题，
把答案送到客服的工作台。
客服接到一个问题，可以从核对草稿开始，再决定怎样回复客户。
交付
附资料依据与待确认项的回复草稿 · 接入已有工作台的人工审核流程
Velia↗
从产品研究与卖点，
一路做到创作者、渠道与融资材料。
把一次产品研究，继续用到合作开发、渠道执行与投资沟通。
交付
产品底表、卖点排序与关键词结构 · 分层创作者候选池与沟通稿