《Agent Skill 跨环境移植实记：四类工具操作如何一一映射》

起因

手里有一份在另一个 AI 代理环境里实测打磨过的操作手册（Skill），内容是华为云开发者成长中心的积分任务全流程：选择器、判定标准、踩坑记录都很完整。但换到我现在用的代理环境后，第一步就卡住了：手册里所有的浏览器操作命令，新环境里一个都不存在。内容是对的，工具全是错的。这篇文章记录这次移植的做法：不动实测结论，只换操作层。

先分类，再映射

把手册里的操作逐条拆开，发现无非四类：

• 浏览器命令类：原环境有一套浏览器 CLI（开会话、导航、执行 JS、点击、填表、截图、借用标签页）。新环境的对应物是实时浏览器任务：把目标 URL、选择器、原本要执行的 JS 片段原样写进任务说明，交给浏览器执行并回报。JS 片段本身是页面侧规格，与宿主工具无关，可以照抄。
• 桌面接管类：原环境能接管桌面浏览器，用无障碍接口给编辑器赋值（比如 CodeMirror 这类填表接口填不进的编辑器）。新环境没有这一层，替代方案分两级：先用浏览器任务自带的点击与输入；实在填不进的，就让用户接管实时浏览器亲手输入，交回控制后继续同一个任务。
• 登录恢复类：原做法是模拟点击加浏览器自动填充保存的密码。新环境改为保险柜保存登录自动完成；遇到图形验证码、滑块或扫码就停手，用户接管登录后再继续。原则不变：代理绝不读取、输入、导出密码。
• 视觉判断类：原环境靠截图加子代理读图。新环境里代理本身就能直接读图片文件，定位元素也有专门的视觉定位工具，批量 OCR 时才再派子代理并行处理。

映射要写在最前面

移植时最容易犯的错，是把新工具名散着改在正文各处，过几周就分不清哪条是原文、哪条是改版。这次的做法是分开：总调度文件重写成新环境的操作口径；分册细节（选择器、坑、判定）原样保留，只在每个文件头加一段「操作映射」声明，并注明它优先于正文里的旧工具名。正文里再出现旧命令，读的人也知道该按映射表执行。

保留不动的东西

移植只换操作层，下面这些一律原样保留，因为它们是花真金白银时间试出来的：每个任务的积分与到账条件、卡片状态的判定方法（以页面积分数字和「已完成」状态为准）、登录态的判断方法（读页头文本，而不是调会被页面 SDK 劫持的接口）、发文章时声明区状态丢失、标签不能手动添加这一类前端坑，以及收尾必须检查主账号云资源、不能让实验资源在主账号上跑着计费的硬性要求。

结论

一份 Skill 的价值大头在实测结论，不在工具命令。移植时先把操作分成浏览器、桌面接管、登录恢复、视觉判断四类，每类找到新环境的对应物并写成文件头的映射声明，就能让旧手册在新环境里继续跑。剩下的，就是按新口径完整实践一遍，把对不上的地方再逐条修回文件里。