agent-browser-upstream

用途

agent-browser-upstream 技能用于管理 navigator 的 agent-browser 分支与上游 vercel-labs/agent-browser 仓库的同步过程。它旨在安全地同步变更、分析差异，并生成集成文档，确保在合并前充分评估影响。

主要能力

• 自动管理环境：如果 .agent-browser/repo/ 不存在，脚本会自动克隆分支；如果缺少上游远程，会自动添加。可通过设置 AGENT_BROWSER_LOCAL 环境变量使用现有的本地克隆。
• 分阶段工作流：包括检查状态、分析变更、评估变更、编写集成文档、用户审查确认、执行合并六个阶段。
• 变更分析：运行分析脚本可获取提交分类（breaking、additive、fix、docs、chore）和关键文件变更，输出 JSON 格式便于处理。
• 评估框架：必须使用 upstream-evaluation 技能，基于 DESIGN.md 中的设计框架，生成 adopt/skip/defer 表格，确保所有新功能被评估。
• 影响评估：映射上游变更到 navigator 的使用情况，检查导入和 API 使用，标记破坏性变更。
• 文档生成：创建版本目录，生成 changes.md、integration.md、status.md，并更新索引。
• 问题创建：可从集成文档创建 GitHub issue。
• 合并执行：在用户确认后，合并上游到分支，解决冲突，推送并创建分支发布标签。

使用方式

1. 检查状态：运行 bun run .claude/skills/agent-browser-upstream/scripts/analyze-upstream.ts --format summary，脚本会自动克隆、配置远程、获取最新并显示差异摘要。
2. 分析变更：运行分析脚本并指定仓库路径、基线和目标，查看提交分类和关键文件。
3. 评估变更：使用 /agent-browser:integrate-changes 命令，加载 upstream-evaluation 技能，进行结构化评估。
4. 影响评估：使用 grep 查找 navigator 中导入 agent-browser 的文件，交叉引用变更 API，标记破坏性变更。
5. 编写文档：确定版本，创建目录，生成 changes.md、integration.md、status.md，更新索引，可选创建 issue。
6. 执行合并：在用户确认后，合并上游，解决冲突，推送，创建标签（格式如 v0.6.0-nav.1），更新 navigator 的 package.json，刷新 bun 锁文件，运行测试。

适用场景

• 需要将 navigator 的 agent-browser 分支与上游保持同步的开发者。
• 团队使用 navigator 项目，并希望安全地集成上游变更。
• 需要系统化评估上游变更对 navigator 影响的场景。

限制

• 合并操作必须经过用户明确确认，不能自动执行。
• 评估阶段必须使用 upstream-evaluation 技能，不能跳过。
• 需要 Bun 运行环境来执行脚本。
• 文档中未提供具体的收费、价格或平台信息。
• 部分功能依赖 GitHub 和 git 操作，需要相应权限。