菜单
浏览器工作流总路由：为外部网站浏览、登录态流程、浏览器自动化、证据采集选择合适后端。 Use when: 需要操作外部网站、登录页、JS 重页面、没有 webfetch/VL 但需要浏览器、或需要在多种浏览器工具之间路由。 Not for: localhost 页面预览（用 browser-preview）、本地 WebApp 确定性测试（用 webapp-testing）、简单网页抓取/搜索。 Output: 选定浏览器后端 + 执行路径 + 证据/结果。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
约定图发现方法论：进一个 repo 先识别 repo-specific conventions，再定义 domain/extractor 接 Convention Graph 引擎。Use when: 进入陌生 repo、要画约定图、要找“改 X 影响谁”的约定层关联、 F242/Convention Graph Layer 工作。Not for: 普通符号跳转/LSP、文档索引检索、记忆图谱、直接使用 codegraph/GitNexus。Output: domain 定义 + extractor 计划 + gap/freshness/provenance 报告。 GOTCHA: 沉淀的是“怎么画图”的方法，不是把 cat-cafe 的 extractor 硬搬到所有 repo。
跨 thread 协同：发现平行 session → 通知（3+2 件套）→ 争用协调 → 确认。 Use when: 平行 session 之间需要协同、收到跨线程消息、通知改动影响、共享文件争用。 Not for: 跨猫工作交接（用 cross-cat-handoff）、需要新建 thread 时（用 propose_thread / thread-orchestration）。 GOTCHA: 收到跨线程 ACTION 不等于接活；先做 thread/feat ownership gate，不属于当前 thread 就 cross-post 退回。 Boundary with F128: 发现跨 scope 问题 → 先 list_threads 查有没有已有 thread → 有 = 本 skill（cross_post）→ 没有 = propose_thread。 Output: cross-post 通知 + 争用协调完成。
Feature 立项、讨论、完成的全生命周期管理。 Use when: 开个新功能、new feature、F0xx、立项、feature 完成、验收通过、讨论新功能需求。 Not for: 代码实现、review、merge（那些有专门的 skill）。 Output: Feature 聚合文件 + BACKLOG 索引 + 真相源同步。
明星开源项目拆解：从宣传/PPT/README 进入源码，验证真实架构、明星特性、算法含量、营销水分、可学习点和不 follow 的 tradeoff。 Use when: operator要求拆解热门 GitHub 项目、竞品 agent/runtime、外部 skill/tool 框架，或问“它到底有什么真本事/我们能学什么”。 Not for: 普通资料搜索（用 deep-research）、社区 issue/PR 运营（用 opensource-ops）、只需要架构头脑风暴（用 collaborative-thinking）。 Output: feature-discussions/YYYY-MM-DD-{project}-deep-dive/ 下的代码证据报告 + 对比结论 + 候选 lesson/skill。 GOTCHA: 不许只看 README 下判断；每个明星特性必须追到代码路径、状态突变点、反馈闭环和算法输入输出。
开发完成后的自检门禁：愿景对照 + spec 合规 + 验证。 Use when: 开发完了准备提 review、声称完成了、准备交付。 Not for: 收到 review 反馈（用 receive-review）、merge（用 merge-gate）。 Output: Spec 合规报告（含愿景覆盖度）。
接球前真相核验三问：claim → resolver → verdict (sourceTier T0/T1/T2 + actionFamily)， 防止把传球者当无审视真相源（F167 Phase O 第一性原理）。 Use when: 即将调 hold_ball / register_pr_tracking / register_issue_tracking / merge / takeover / 改 owner / 任何 irreversible action / 基于 "operator signoff" 或 "你是 owner" 类 claim 行动之前。 Not for: 纯阅读 cross_post（无 actionFamily 后续）；本 thread 日常 @mention 无副作用； implementation continuation（自检通过的下一步）。 Output: claim grounding verdict (verified/mismatch/insufficient) + 接球决策 (proceed / block / push back to source thread)。
| name | browser-automation |
| description | 浏览器工作流总路由：为外部网站浏览、登录态流程、浏览器自动化、证据采集选择合适后端。 Use when: 需要操作外部网站、登录页、JS 重页面、没有 webfetch/VL 但需要浏览器、或需要在多种浏览器工具之间路由。 Not for: localhost 页面预览（用 browser-preview）、本地 WebApp 确定性测试（用 webapp-testing）、简单网页抓取/搜索。 Output: 选定浏览器后端 + 执行路径 + 证据/结果。 |
| triggers | ["浏览器自动化","browser mcp","用浏览器","登录网站","登录态","agent-browser","pinchtab","playwriter","playwright mcp","没有 webfetch","无 webfetch","没有 vl"] |
这是家里的上层浏览器路由 skill。
它只做三件事：
在真正打开浏览器前，先回答这四个问题：
localhost → browser-preview；外部网站才留在本 skill。webfetch、是否能跑 shell、是否有 VL。webfetch，或者 webfetch 不足以完成交互agent-browser / Playwright MCP / Playwriter / PinchTab 之间做路由localhost 页面预览、HMR、给operator看效果
→ 用 browser-previewwebapp-testingbrowser-previewwebapp-testingrefs/playwright-mcp.md（MCP ID: playwright）claude-in-chrome MCP（工具前缀 mcp__claude-in-chrome__*），参考 refs/playwriter.mdrefs/agent-browser.md（MCP ID: agent-browser，社区 wrapper，使用前先做本机验活）refs/pinchtab.md（MCP ID: pinchtab，优先 native binary pinchtab mcp，不要默认相信 npm wrapper）| 场景 | 默认 | MCP ID | 状态 |
|---|---|---|---|
| 本地前端页面预览 | browser-preview | — | 独立 skill |
| 本地 WebApp 测试 / 回归 | webapp-testing + Playwright | playwright | 已接入 |
| MCP 原生客户端的常规网页自动化 | Playwright MCP | playwright | ✅ 已接入 — npx @playwright/mcp@latest |
| 已登录 Chrome、iframe-heavy、手工接管 | claude-in-chrome | claude-in-chrome | ✅ 已接入 — Chrome 扩展管理，无需手动启动 |
| CLI 型猫、没 webfetch / 没 VL | agent-browser | — (CLI 工具) | ✅ 可用 — npm i -g agent-browser，通过 Bash tool 调 CLI |
| 服务化浏览器、持久化 session、重复批任务 | PinchTab | pinchtab | ✅ 已接入 — native binary pinchtab mcp（外网 URL 用 eval 导航，见 ref） |
| 目标 | 组合 | 说明 |
|---|---|---|
| 外部网站调研 + 本地页面实现 | browser-automation + browser-preview | 前者看参考站，后者看我们自己的 localhost |
| 本地 WebApp 开发验收 | browser-preview + webapp-testing | 一个看效果，一个做确定性验证 |
| 接手人类已登录会话 | browser-automation + refs/playwriter.md | 明确是谁的 session，再做操作 |
| 重复批量抓取 / 长驻任务 | browser-automation + refs/pinchtab.md | 不是临时调试，而是服务化执行 |
| Ref | MCP ID | 场景 |
|---|---|---|
refs/playwright-mcp.md | playwright | 常规 MCP 原生网页自动化（默认） |
refs/playwriter.md | claude-in-chrome | 已登录 Chrome / iframe-heavy / 多 tab（实际用 mcp__claude-in-chrome__* 工具） |
refs/agent-browser.md | — (CLI 工具) | CLI 型猫 / 无 webfetch / 无 VL |
refs/pinchtab.md | pinchtab | 服务化、持久 session、HTTP-first |
每次真正使用浏览器后端，至少说清楚这四件事：
如果任务涉及人类账号：
| 错误 | 后果 | 修复 |
|---|---|---|
把 browser-preview 并进本 skill | localhost 和外部网站边界糊掉 | 保持独立 skill，只在这里路由 |
| 默认所有猫都装同一套浏览器后端 | CLI/MCP/登录态需求互相打架 | 先按场景选，再按客户端能力落工具 |
| 在主 skill 里复制厂商文档 | 一改后端就大面积漂移 | 厂商细节压到 refs/ |
| 简单抓取先上浏览器 | 成本高、速度慢、失败面更大 | 先判断是否能用更轻量工具 |
| 把本地测试和外部网站操作混成一个动作 | 路由混乱，证据链不清楚 | localhost 和外部网站分开处理 |
| 登录态责任不清楚就开干 | 容易误用人类 session | 先说清 session 属于谁，再动手 |
| 做完只说”好了”不留证据 | 后续无法验收或复现 | 至少交付 URL/截图/文本/日志中的一种 |
PinchTab 外网用 pinchtab_navigate | Clash TUN 下 403（Go 层 DNS 预检拦截 198.18.x.x） | 用 pinchtab_eval + window.location.href 导航，详见 refs/pinchtab.md |
| Skill | 关注点 |
|---|---|
browser-automation | 外部网站浏览器工具的总路由和选型 |
browser-preview | Hub 内预览 localhost 页面 |
webapp-testing | 用 Playwright 做本地 WebApp 验证 |
| 领域专用浏览器 skill | 某个网站 / 某类提取任务的专用流程 |
localhost 页面 → browser-previewwebapp-testingrefs/*.md 后执行