SuperAPI AI 工具集

opencli-sitemap-author

智能体与模型

查看项目

更新于 10-15 22:39

技能介绍

用途:为使用 opencli browser 的智能体编写任务执行图,而非 SEO sitemap。目标是让智能体知道自己在哪、下一步走哪条路径、优先用哪个 OpenCLI 适配器,以及页面与记忆冲突时如何恢复。保持 sitemap 小而经过验证,不爬整站,只记录实际观察到的任务相关路径。

存储模型:分两层,全局种子 sitemaps/<site>/(顶层),本地覆盖 ~/.opencli/sites/<site>/sitemap/。本地覆盖按稳定 id 优先,新发现先写本地,评审后再提升到全局。推荐布局含 SITE.md、pages/<page-id>.md、pages/_<partial>.md、workflows/<task-id>.md、pitfalls.md。

编写循环:先读本地覆盖再读全局种子;用 opencli browser <session> state、find、network、analyze 验证现实,浏览器状态为准;只记录持久结构;使用稳定 id;先写本地草稿;冲突时信任浏览器状态并标记 stale。

动作模式:每个动作边需含 pre、do、post、fail、recover(可带 adapter_health_update)、evidence。无证据不得提升动作。

Partial 页面:_<name>.md 装跨页 UI 原语,所有 selector 必须 scoped 到 partial root,不能是 page-level first match。

工作流字段:Goal、State signature、Best path、Fallback path、Avoid、Stale markers。API 知识引用 endpoints.json 的 id,不重复完整 schema。

回退约定:fallback 首行声明触发条件与 adapter_health_update 指令。SITE.md 顶层路由应显式标出存在但未覆盖的 route。

红线:sitemap 只是提示,当前浏览器状态为准;不写密钥、cookie、私有 id、私信或账号特定值;不记录绕过 CAPTCHA、WAF、访问控制、限流或付费门的内容;不存脆弱快照索引;未验证路径标 draft 或 stale;草稿放 sitemap/draft-<topic>.md。详细 schema 见 references/sitemap-schema.md。