方法论与洞察

WorkBuddy 教程录屏公告与《屏幕录制标准》v1.2 · 协作复盘

日期:2026-09-08 · 项目:钉钉文档《WorkBuddy全案实战汇总》录屏阶段启动 + 腾讯文档《屏幕录制标准》v1.1→v1.2 协作方:跳蛛先生(决策/修订口径/发群)、桓(检索/公告起草/标准文档程序化更新) 状态:公告终稿已交付、用户自行发群;标准文档 version 10→26 全部落库并回读校验通过


事实记录(不可修改区)


弧线速览

  1. 检索翻车:用户说”录屏规范是我们上次写过的链接”,我用「录屏规范」「录屏.*规范」grep 本地工作区 + 知识库全部 miss,又翻遍近两月 memory 与教程正文快照仍无,只好如实汇报”找不到”并附占位草稿。真实标题《屏幕录制标准》四个字一个都对不上,且文档在腾讯文档云端——本地检索这条路从一开始就不存在。
  2. 一稿三修:读取全文后起草公告,主体一稿通过;用户分三轮修订口径(命名+打包格式 → 静音录制不配音 → 脚本非必须+字幕不需要)。
  3. 每轮修订双写:每次口径变化都同轮做两件事——改公告 + 程序化回写标准文档并登记变更记录,不留”公告一套、规范一套”的窗口。
  4. 残字事故:改「禁止即兴发挥」一格时 end 少算 1 字符,留下「发挥挥」;改后 find 复验当场抓出修复。校验动作不是摆设。

提炼的规律

1. 指称词 ≠ 标题词:找”上次写过的文档”先做同义词扩张 ⚠️首次

用户的「录屏规范」是功能指称,文档标题《屏幕录制标准》与之零字符重合。这与 AI查询召回失准_容器词自指与命中率区分度_v1 同构:检索词与目标词的表面差异直接导致零命中,而检索方对此毫无自觉——grep 返回空时,无法区分”文档不存在”和”词不对”。

操作规则:

  1. 检索词先扩同义词族(录屏 / 屏幕录制 / 录制标准 / 规范 / SOP / 标准),再动手
  2. 本地两轮 miss 立即转向在线文档源(腾讯文档 / 钉钉 / 飞书)——协作规范的成品往往只活在云端,本地连镜像都没有
  3. 报”找不到”时不空手:本次把公告正文先写好、链接留占位,用户补一个链接即定稿。如实汇报 + 可用草稿,比硬撑和甩锅都快

2. 程序化文档编辑:自底向上改 + 每刀复验 ⭐⭐二次验证

同一文档多处编辑,按坐标降序执行(先改文末、再改文首):每刀只作废变点之后的坐标,降序排列保证所有待改坐标在落刀时仍然有效。与 dws块级插入_index语义陷阱与倒序插入法_v1 同族——那边是 block index 倒序插入,这边是 GCP 字符坐标降序替换,本次在腾讯文档坐标系二次验证成立。

配套硬规则:replace_text 后必须 find 目标文本复验。本次单元格 end 少算 1 字符留下残字「发挥挥」,正是复验抓的;没有这一步,错字就随公告一起发给学员了。

3. 表格行号以参数 schema 为准,工具散文描述会写错 ⚠️首次

delete_table_row 的工具描述写「1-based」、参数说明写「0-based」,实测 0-basedinsert_rows 同样)。破坏性表格操作的标准姿势:先执行最小一步(删一行)→ 回读 get_table_info 确认行号语义 → 再批量。文档工具的描述文本是散文,schema 才是契约。

4. 公告口径与标准文档同轮回填 ⭐⭐再验证

用户对公告的每次修订,同轮回写标准文档本体 + 变更记录。对外公告引用一份标准时,改口径不改标准 = 主动制造两个真相源,学员对照文档时必然犯迷糊。与 钉钉知识库交付_格式白名单与终版回填闭环_v1 同律再验证:交付物的口径收口,以”所有引用方看到的都是同一份”为终点。


下次改进


关联文档

类型/协作工具链