用途:当 webcmd browser open 或 webcmd browser analyze 报告 sitemap.available: true,或用户要求使用站点地图时,用该技能为浏览器操作提供先验知识,减少盲目导航。站点地图只是先验知识,不是事实依据,不能覆盖实时浏览器状态。
主要能力与用法:先运行或复用 webcmd browser <session> state 获取当前页面;只读取最小相关文件,包括 SITE.md 做站点级定位、一个匹配的 pages/<page-id>.md 对应当前状态、一个匹配的 workflows/<task-id>.md 对应用户目标,仅在受阻或工作流警告时读 pitfalls.md。优先采用工作流中的 Best path;若其中指定了适配器(如 webcmd twitter post),先使用适配器,不可用或失败时改用 Fallback 浏览器工作流。每次导航或状态变更后刷新 state,并与工作流的 state_signature 比对;若现实不符,以现实为准,继续探测并写本地 stale note 或草稿补丁。若动作恢复包含 adapter_health_update: <adapter> -> suspect|broken,则更新本地 overlay 中引用该适配器的工作流,使后续智能体直接走回退路径。
查找顺序:先读本地 overlay ~/.webcmd/sites/<site>/sitemap/,再读全局种子 sitemaps/<site>/;同稳定 id 时本地覆盖全局。不要将大型站点地图整体载入上下文,目录大时先列文件名再按需读取。
信任现实规则:若站点地图声称某按钮、URL、路由或 API 存在但浏览器未显示,应重新运行 state 或用语义锚点查找,检查登录、语言、视口、A/B 测试或路由状态差异,若可见安全路径则跟随真实页面,并在本地 overlay 标记该项 stale;不要因“站点地图说应该可用”而持续点击。
过期与草稿记录:发现漂移时,在相关页面/工作流文件或本地 overlay 草稿中写小段记录,包含 observed_at、current_url、expected、actual、next_probe。除非任务明确是站点地图编写或仓库 PR,不要编辑全局种子文件。
适配器健康回写:适配器失败且站点地图动作或工作流要求更新健康状态时,在 ~/.webcmd/sites/<site>/sitemap/workflows/ 找到 Best path 引用该适配器的本地工作流;若无本地工作流,先将匹配的全局工作流复制到本地 overlay,执行浏览器任务期间绝不直接编辑全局种子。按指示设置 adapter_health: suspect 或 broken,并附简短 stale note(错误、当前 URL、时间戳),然后继续浏览器回退路径。该回写形成记忆循环,当前智能体回退一次,后续智能体不再重试已知可疑适配器。
输出纪律:报告时包含所选路径(适配器最佳路径或浏览器回退)、到达的检查点(当前 URL/状态签名)、站点地图健康状况(原样使用、标记过期或缺少工作流),保持任务聚焦,不要总结整个站点地图。
限制:资料未提供具体安装命令、收费、平台支持范围或效果数据;该技能依赖 webcmd browser 环境与站点地图文件结构,实际可用性取决于对应站点是否提供 sitemap。