SuperAPI AI 工具集

webcmd-sitemap-author

智能体与模型

查看项目

更新于 10-15 19:51

技能介绍

用途:为使用 webcmd 浏览器的智能体编写任务执行图,而非 SEO sitemap。目标是让智能体知道自己在哪、下一步走哪条路径、优先用哪个 Webcmd 适配器,以及页面与记忆冲突时如何恢复。

主要能力:采用两层存储,全局种子 sitemaps/<site>/,本地覆盖 ~/.webcmd/sites/<site>/sitemap/,本地覆盖按稳定 id 优先,新发现先写本地,审核后再提升为全局。推荐布局包含 SITE.md、pages/<page-id>.md、pages/_<partial>.md、workflows/<task-id>.md、pitfalls.md。每个动作边需包含 pre、do、post、fail、recover、evidence,并支持 adapter_health_update。支持 partial 页面复用跨页 UI 原语,要求选择器限定在 partial 根作用域内。工作流需写明目标、状态签名、最佳路径、回退路径、应避免路径和过期标记。

使用方式:先加载本地覆盖再加载全局种子;用 webcmd browser <session> state、find、network、analyze 验证现实,浏览器状态为准;若刚完成 webcmd-adapter-author,可从 ~/.webcmd/sites/<site>/traces/ 的浏览轨迹播种;只记录持久结构,使用稳定 id;冲突时信任当前浏览器状态并标记过期记忆。回退约定以 on_adapter_fail 开头,先写 adapter_health_update 再写恢复步骤。SITE.md 需列出已覆盖路由并显式标记未覆盖路由。

适用场景:创建或维护 Webcmd 站点 sitemap、智能体导航、页面状态与动作记录、工作流与 API 参考整理、陷阱与回退知识编写。

限制:sitemap 只是提示,当前浏览器状态才是事实;不得写入密钥、cookie、私有 id、私信或账户特定值;不得记录绕过 CAPTCHA、WAF、访问控制、速率限制或付费门禁的方法;不得把脆弱快照索引如 [17] 作为持久目标;未验证路径须标为 draft 或 stale;草稿应放在 sitemap/draft-<topic>.md,而非父级 sitemap.draft.md。文件大小建议:小于 1500 token 自然保留,1500-3000 仅在内容内聚时保留,超过 3000 拆分;800 token 为审计阈值。详细字段规范见 references/sitemap-schema.md。