functions

[STG-2254] chore: 使合并的技能符合 agent-skills 标准 (#135) * chore: 使合并的技能符合 agent-skills 标准 - 为 browser-to-api、company-research、event-prospecting 添加 MIT LICENSE.txt - 将 autobrowse 的 LICENSE 年份规范化为 2026，并将 license frontmatter 规范化为 MIT - 在缺失处添加 license/compatibility/allowed-tools frontmatter （agent-experience、cookie-sync、fetch、functions、safe-browser、search） - README：删除过时的 site-debugger/bb-usage 行，添加 agent-experience、 autobrowse、browser-to-api、company-research、event-prospecting 行 - 从 autobrowse 中移除被禁止的 .env.example（更新 README 设置片段） Co-Authored-By: Claude Fable 5 * fix: 从 autobrowse 设置行中移除 BROWSERBASE_PROJECT_ID 回应 shrey150 的审查反馈 --------- Co-authored-by: Claude Fable 5

docs: 将 bb/browse-cli 引用重命名为统一的 browse CLI (#111) * docs: 将 bb/browse-cli 引用重命名为统一的 browse CLI `@browserbasehq/cli` (bb) 和 `@browserbasehq/browse-cli` 包 已合并为单个 `browse` 包（`npm install -g browse`）。 更新所有技能文档、脚本和示例以使用新的命令 接口： - `bb fetch|search|sessions|projects|contexts|extensions` → `browse cloud ...` - `bb functions ...` → `browse functions ...` - `bb templates ...` → `browse templates ...` - `bb skills install` → `browse skills install` - `bb browse ` → 顶层 `browse `（open、get、click、…） - `pnpm bb dev|publish` → `browse functions dev|publish` - `# bb call N/TOTAL` 强制注释 → `# browse call N/TOTAL` - extract_page.mjs 中的 `bbFetch`/`bbBrowseMarkdown` 辅助函数已重命名并 重写为调用新的 `browse cloud fetch` / `browse get markdown` 接口。 - bb-capture.mjs / bb-finalize.mjs 通过 shell 调用 `browse cloud sessions ...` SDK 变量名（`const bb = new Browserbase()`）和 `x-bb-api-key` HTTP 头保持不变。 Co-Authored-By: Claude Opus 4.7 (1M context) * fix: 使 browse 命令示例与 0.6 对齐 * docs: 注明已弃用的 context 上传刷新 * docs: 澄清 trace 示例中 cdp 标志的用法 * docs: 在 trace 示例中依赖 cdp 守护进程持久性 * docs(browser-trace): 在后续命令中移除冗余的 target 标志 browse 守护进程在第一条命令后缓存 target，因此 在 `browse open --cdp 9222`（或 `--remote --session "$SID"`）之后的命令 无需重复 target 标志。回应 PR #111 审查意见 中关于 EXAMPLES.md 中 `--cdp` 重复的问题。 Co-Authored-By: Claude Opus 4.7 (1M context) * docs: 澄清 cdp 守护进程行为 * fix(extract_page): 在 `browse get` 上移除冗余的 --local --headless browse 守护进程在 `browse open --local --headless` 后缓存 target， 因此后续的 `browse get markdown` 调用不应重复模式标志。 与 skills/browser/SKILL.md 的约定一致（“将 --local、--remote、 --auto-connect 或 --cdp 放在第一条浏览器命令上”）以及 Shrey 在 5468e0e 中对 browser-trace 应用的相同修复。 回应 PR #111 上的 Cursor Bugbot 发现。 Co-Authored-By: Claude Opus 4.7 (1M context) * docs: 对齐 browse 生命周期示例 * docs: 移除过时的 fill 标志引用 * docs: 收紧 browse 技能迁移措辞 * docs: 澄清 browse stop 模式切换 * docs: 验证 browse 命令注意事项 --------- Co-authored-by: Claude Opus 4.7 (1M context) Co-authored-by: Shrey Pandya

使技能符合 Agent Skills 规范 (agentskills.io) (#36) * 使用标准技能 frontmatter 进行设置，而不是 setup.json 没有 agent（Claude Code、OpenCode、OpenClaw、Cursor、Windsurf）会读取 setup.json —— 只有 SKILL.md 会被加载到上下文中。setup.json 模式对所有 agent 都不可见，因此在各处都是失效的。 替换为标准 frontmatter 字段： - requires.bins: [browser] —— 如果二进制文件未安装，agent 会跳过/抑制该技能， 而不是总是注入它并希望 agent 注意到 setupComplete: false - install.kind/pkg —— 支持自动安装的 agent 可以自动调用 npm install @browserbasehq/stagehand-cli 同时移除凭据的 ".env 文件" 引用 —— 环境变量 是从环境中读取的，而不是专门从 .env 文件读取。 Co-Authored-By: Claude Sonnet 4.6 * 修复：使用 compatibility 字段和内联设置检查，而不是虚构的 frontmatter requires.bins 和 install.kind/pkg 不属于任何 agent 技能规范。 替换为： - compatibility 字段（符合 agentskills.io 规范）以呈现需求 - 在技能正文中内联 `which browser || npm install` 检查，以便 agent 可以自我修复，而无需依赖非标准 frontmatter 字段 Co-Authored-By: Claude Sonnet 4.6 * 将 browser-automation/ 重命名为 browser/ 以匹配技能名称 agentskills.io 规范要求目录名与 SKILL.md frontmatter 中的 name 字段匹配。由于该技能名为 "browser" （以 /browser 调用），目录应为 browser/ 而不是 browser-automation/。 同时修复不一致的标题级别（### → ##）。 Co-Authored-By: Claude Sonnet 4.6 * 使技能符合 Agent Skills 规范 (agentskills.io) 使用 skills-ref 参考库验证了两个技能，并 修复了发现的所有问题： - 引用 compatibility YAML 值以修复 strictyaml 解析错误 - 使用触发关键词（schedule、webhook、 cloud、cron、Browserbase Functions）重写 functions 描述 —— 规范要求触发器 在描述中，而不是在正文中 - 将 functions SKILL.md 拆分为 SKILL.md + REFERENCE.md 以实现渐进式 披露（调用示例、常见模式、故障排除） - 从 functions 中移除 "When to Use" 正文部分（与描述冗余， 在技能发现期间不可见） - 为两个技能添加 license: Apache-2.0 和 LICENSE.txt - 为 browser REFERENCE.md 添加目录（535 行） - 将 browser EXAMPLES.md 从 8 个重复示例精简为 4 个多样化示例 Co-Authored-By: Claude Opus 4.6 * 将技能许可证从 Apache-2.0 切换为 MIT Co-Authored-By: Claude Opus 4.6 * 回应审查反馈：修复版权年份和包名 - 将两个 LICENSE.txt 文件中的版权年份从 2025 更新为 2026 - 将包名从 @browserbasehq/stagehand-cli（不存在） 修复为 @browserbasehq/browse-cli（实际的 npm 包） - 将 CLI 命令从 `browser` 更新为 `browse` 以匹配 npm 包二进制名称，涉及 SKILL.md、REFERENCE.md 和 EXAMPLES.md Co-Authored-By: Claude Opus 4.6 (1M context) * 改进技能描述以便 agent 发现 将反机器人隐身、CAPTCHA 解决、住宅代理和会话 持久性细节添加到 browser 技能描述和模式比较 表中。这些触发短语帮助 AI agent 在用户需要与受保护或 JavaScript 密集型网站交互时发现并选择此 技能。 Co-Authored-By: Claude Opus 4.6 * 添加 metadata.openclaw requires + 改进本地与远程指导 - 添加 requires.bins（browse CLI）和 install 规范，以便 OpenClaw 可以正确门控 该技能并自动安装 CLI - 添加 homepage 以用于 ClawHub 信任评分 - 不要基于环境变量进行门控 —— 本地模式无需 Browserbase 密钥即可工作 - 重写 "Environment Selection" 部分，提供关于何时 使用本地模式（简单页面）与远程模式（受保护站点、 CAPTCHA、机器人检测、Cloudflare、地理限制内容）的清晰指导 Co-Authored-By: Claude Opus 4.6 * 引导 agent 采用快照优先工作流和高级命令 会话日志显示 agent 在每个操作后都截图（昂贵、 缓慢），并忽略 browse act/observe，转而使用手动快照 → 点击 ref 循环。更新技能以： - 记录 browse snapshot 并推荐其作为默认，优于 screenshot - 添加关于何时使用 snapshot 与 screenshot 的指导 - 引导使用 browse act/observe 而非低级基于 ref 的命令 - 重写最佳实践以反映快照优先、act 优先的工作流 Co-Authored-By: Claude Opus 4.6 * 重写命令部分以匹配实际的 browse CLI SKILL.md 记录了 CLI 中不存在的命令（navigate、act、extract、observe）。 实际命令是 open、click、type、fill、 snapshot 等。这导致 agent 运行不存在的命令并 退回到猜测。 - 用 browse --help 中的实际 CLI 语法替换所有命令文档 - 记录带元素 ref 的快照优先工作流 - 添加会话管理命令（stop、status、pages、tab_switch） - 将 "No active page" 添加到故障排除 - 修复快速示例以使用真实命令 Co-Authored-By: Claude Opus 4.6 * 修复僵尸守护进程 "No active page" 错误的故障排除 browse stop 并不总是杀死守护进程。添加 pkill 回退 以应对守护进程在 SIGTERM 后卡在 wsUrl: "unknown" 的情况。 Co-Authored-By: Claude Opus 4.6 * 修复过时的 browser-automation 引用；用真实 CLI 命令重写技能文档 - 在 README.md 和 marketplace.json 中将 browser-automation 重命名为 browser - 重写 EXAMPLES.md：用真实的 browse CLI 命令（open、snapshot、 click、type、fill、get、stop）替换不存在的命令（navigate、act、 extract、observe、close）。4 个具体示例，包括远程 模式升级。 - 重写 REFERENCE.md：用 实际的基于守护进程的 CLI 文档、所有 20 个真实命令、环境变量配置替换 Stagehand/Playwright 架构。 - SKILL.md：添加 "Activating Remote Mode" 渐进式披露部分， 修复 get text 以要求 selector 参数。 Co-Authored-By: Claude Opus 4.6 * 记录 browse mode 命令以进行即时本地/远程切换 将 browse mode 添加到 SKILL.md 命令列表和 REFERENCE.md。重写 "Activating Remote Mode" 为 "Switching Between Local and Remote Mode"， 使用 browse mode 作为主要机制。 Co-Authored-By: Claude Opus 4.6 * browser(skill): 移除对不存在的 @browserbasehq/browse-cli 的自动安装；仅基于 'browse' bin 进行门控\n\n- 删除 OpenClaw 安装块以避免安装失败\n- 使 compatibility + 设置检查通用化（无 npm 包名）\n- 泛化 REFERENCE 注释（避免提及 browse-cli v0.1.4） Co-authored-by: Kyle Jeong * 还原 "browser(skill): 移除对不存在的 @browserbasehq/browse-cli 的自动安装；仅基于 'browse' bin 进行门控\n\n- 删除 OpenClaw 安装块以避免安装失败\n- 使 compatibility + 设置检查通用化（无 npm 包名）\n- 泛化 REFERENCE 注释（避免提及 browse-cli v0.1.4）" 此还原提交 5b743336a8352a3838f9cdc23b410154c1b12727。 * docs(browser): 移除损坏的命令，记录未记录的功能 移除：get html、drag、highlight、is、execute 引用。 添加文档：hover、newpage、eval、viewport、network capture、 snapshot --compact、screenshot --full-page、type --delay/--mistakes、 fill --no-press-enter、stop --force。在 SKILL.md 中将 get html 替换为 get value。 Co-Authored-By: Claude Opus 4.6 (1M context) * 在文档中将 `browse mode` 重命名为 `browse env` Co-Authored-By: Claude Opus 4.6 (1M context) * docs(browser): 恢复 drag、highlight、is 和 get html/visible/checked 命令 这些命令在 PR browserbase/stagent-cli#11 修复守护进程启动（EPIPE 崩溃）并恢复 selector 命令接口后再次可用。 Co-Authored-By: Claude Opus 4.6 (1M context) * docs(browser): 将 refs、open --wait、--json 和 --session 添加到 REFERENCE.md 这些 CLI 功能在 browse-cli v0.1.5 中已验证可用，但 在参考文档中缺失： - `refs` 命令用于缓存 ref 映射查找 - `open --wait` 标志（networkidle/domcontentloaded）用于 SPA - `--json` 全局标志用于结构化输出 - `--session` 全局标志用于并发浏览器会话 Co-Authored-By: Claude Opus 4.6 (1M context) * docs(browser): 对全局标志使用一致的标题样式 匹配 REFERENCE.md 其余部分使用的 #### 标题 + 描述 + 代码块模式。 Co-Authored-By: Claude Opus 4.6 (1M context) * docs(browser): 添加 TOC，移除重复部分，收紧环境切换 - 为 REFERENCE.md 添加目录（匹配 functions/REFERENCE.md 和顶级技能如 terraform-skill、mcp-builder） - 从 REFERENCE.md 中移除 Typical Workflow 和 Local vs Remote Mode 部分 —— 这些是 SKILL.md 内容的几乎相同副本 - 将 SKILL.md 中的 "Switching Between Local and Remote Environment" 从 38 行 精简为 16 行 —— 保留信号检测列表和凭据 设置，删除已在 Commands 部分显示的冗余环境命令 Co-Authored-By: Claude Opus 4.6 (1M context) --------- Co-authored-by: openclaw Co-authored-by: Claude Sonnet 4.6 Co-authored-by: Cursor Agent Co-authored-by: Kyle Jeong

更新技能文档 (#31) * 更新技能并重命名为 browse * package lock * 移除 env 示例 * 还原 browser-browse * 更新 marketplace 引用 * 更新 readme * readme 更新