OpenCLI 站点地图编写器
为浏览器代理创建和维护站点任务图,以进行有效的导航。
证据显示技能明确禁止写入密钥、Cookie、用户私有ID等敏感信息,并禁止绕过CAPTCHA/访问控制,强调浏览器状态为准,体现了良好的安全意识和最小权限原则。但其允许工具包括Bash(opencli:*),可能涉及对系统命令的访问,但技能主要指导操作sitemap文件,未明确描述数据流或用户确认机制。扣分点:未明确用户确认环节,数据流向不透明,依赖外部浏览器状态,无回滚机制。
技能提供了详细的schema和示例,自洽性较好。但作为静态审查,无法验证实际执行效果,且依赖外部opencli工具、浏览器状态和网络,未提供测试或错误处理细节。扣分点:happy path仅在文档中描述,异常输入下的行为不明确,依赖外部环境。
技能明确描述了使用场景(创建/维护sitemap)、目标用户(AI agent)和环境要求(opencli browser),并提供了大小启发式和建议。但未明确非适用场景,触发条件依赖'opencli browser'环境,未验证在中国大陆的可达性。扣分点:界限和触发条件不充分,环境适配证据不足。
SKILL.md提供了清晰的结构、存储模型、schema和示例,并注明了v1.1变更记录,遵循Apache-2.0许可证,维护责任可追溯至仓库。但未提供版本号、变更日志或明确的更新机制。扣分点:版本管理和更新路径不清晰。
技能目标明确,提供了详细的sitemap编写规范,能产生结构化的sitemap文件,直接可用。但其价值依赖外部opencli工具,静态审查无法验证实际输出。扣分点:结果正确性未验证,成本效益未量化。
文档中提到了多个PoC验证(twitter、hackernews)和Phase 2 audit计划,但静态审查未提供可执行的测试证据。扣分点:缺乏第三方执行证据,事实与推断未充分区分。
- 该技能依赖opencli browser和浏览器状态,静态审查无法验证其实际运行效果,请在实际环境中谨慎使用。
- 技能涉及对网站的操作,请确保遵守网站的服务条款和法律法规。
- 技能未明确用户确认机制,在实际使用时建议增加用户授权确认。
- 技能在中国大陆环境下的可达性未验证,所有功能可能依赖海外服务。
这个 Skill 能做什么,适合哪些场景?
OpenCLI sitemap-author 技能可帮助 AI 代理创建和维护站点 sitemap,这些 sitemap 不是用于 SEO,而是作为代理的导航和执行图。它记录页面状态签名、操作边、工作流和陷阱,使代理能够决定其位置、接下来要采取的路径以及如何恢复。该技能强调小规模、可验证的 sitemap,优先考虑本地覆盖,并确保代理遵循用户提供的指令。
读取本地和全局站点 sitemap,使用 opencli browser 命令(状态、查找、网络、分析)验证当前浏览器状态,基于观测到的稳定结构编写或更新 ~/.opencli/sites/<site>/sitemap/ 下的 sitemap 文件,使用必需模式记录操作边和面向自动化的恢复路径,并标记陈旧项目。
- 在探索站点后,想要记录稳定的工作流,供未来代理使用,避免重复重新发现。
- 当现有 sitemap 过时且与当前浏览器行为不一致时,需要更新 sitemap 条目。
- 当代理需要结构化指导而不仅仅是随机点击时,将本地站点知识提升到仓库 sitemap。
- 为经常访问的站点维护 sitemap,重点关注任务相关路径和稳定的锚点。
- 创建跨页面 UI 部分(如共享卡片组件)的计算规则。
这个 Skill 有哪些优点和局限?
- 强调小规模、可验证的 sitemap,避免爬取整个网站。
- 提供清晰的作者循环和验证要求。
- 支持本地覆盖和全局提升,安全地迭代。
- 包括用于跨页面 UI 元素的的部分页面。
- 显式标记未覆盖的路由,以管理代理的期望。
- 需要 OpenCLI 设置和浏览器桥接扩展,可能成为采用障碍。
- 主要面向高级用户;模式可能有陡峭的学习曲线。
- 未记录测试套件;验证取决于手动检查。
- 其有效性取决于维护者的纪律,以保持 sitemap 小而准确。
如何安装这个 Skill?
安装 OpenCLI 集合:npx skills add jackwener/opencli --skill opencli-sitemap-author。需要 OpenCLI 运行时和浏览器桥接扩展;遵循 README 中的快速入门步骤。
如何使用这个 Skill?
触发提示,例如:“为我刚发现的这个站点记录稳定的工作流”或“更新此站点的 sitemap,强调当前状态”。该技能会自动读取现有记忆,验证浏览器状态,并提示您编写或修改 sitemap 文件。