메뉴
浏览器自动化 CLI 工具，使用 Puppeteer 控制浏览器进行网页操作。 支持导航、截图、点击、填写表单、执行 JavaScript 等操作。 当用户需要：网页截图、打开网页、浏览器自动化、网页操作、点击元素、填写表单、测试网页、抓取网页数据时，**必须**使用此 Skill。 即使不使用"puppeteer"、"截图"等关键词，只要涉及任何网页浏览、网页交互、自动化操作，都应该触发此 Skill。 特别适用于：网页截图分析、表单自动填写、网页数据提取、网页测试、点击网页元素。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
PRD 驱动的完整开发工作流 - 从用户故事分析到自动化测试的端到端流程。 当用户需要"一条龙开发"、"全自动开发"、"从需求到代码"、"先分析PRD再开发"、 "多模型分析后自动开发"、"完整开发流程"、"从需求分析到测试"或任何涉及 PRD分析→需求整合→代码生成→自动化测试的连续工作时，**必须**使用此技能。 整合多模型聚合、Kimi深度整合、PRD生成、多模型代码审查、代码开发、自动化测试等能力。 **新增**: 智能决策大脑(th-workflow-decision-engine) - 自动判断何时使用GitNexus代码分析、 unified-search联网搜索、多模型聚合，测试失败时智能选择修复策略。
PRD驱动工作流的决策大脑 - 智能判断何时使用搜索、代码分析、多模型聚合。 作为子Skill被 th-prd-driven-dev-workflow 调用，负责工具选择和策略决策。
动态 Agent 生成器（母体模式）。当用户需要处理复杂项目时，自动分析需求并生成定制化专业 Agent 团队。接收项目描述、技术栈、版本号、约束条件，输出完整的 Agent 配置和启动命令。触发词：需要专业团队、生成 Agent、创建定制化 Agent、复杂项目团队、动态生成 Agent。
Arch Linux 系统特性（PEP 668、AUR Helpers）
浏览器交互自动化：网页测试、表单填写、截图、数据提取。触发词：打开网页、填写表单、网页截图。
系统化代码审查：安全性、性能、可维护性、正确性、测试覆盖。触发词：代码审查、review 代码、PR 审查。
| name | puppeteer-cli |
| description | 浏览器自动化 CLI 工具，使用 Puppeteer 控制浏览器进行网页操作。 支持导航、截图、点击、填写表单、执行 JavaScript 等操作。 当用户需要：网页截图、打开网页、浏览器自动化、网页操作、点击元素、填写表单、测试网页、抓取网页数据时，**必须**使用此 Skill。 即使不使用"puppeteer"、"截图"等关键词，只要涉及任何网页浏览、网页交互、自动化操作，都应该触发此 Skill。 特别适用于：网页截图分析、表单自动填写、网页数据提取、网页测试、点击网页元素。 |
浏览器自动化 CLI 工具，封装 Puppeteer 功能，支持导航、截图、点击、填写表单等操作。
npm install -g puppeteer
或者本地安装：
npm install puppeteer
| 选项 | 说明 |
|---|---|
--headed | 使用有界面模式（解决某些网站在 headless 模式下黑屏的问题） |
--headless | 使用无头模式（默认） |
# 默认无头模式
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs navigate https://example.com
# 有界面模式（推荐用于复杂网站如 GitHub）
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs navigate https://github.com/trending --headed
# 默认 1280x720（简单网站可用）
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs screenshot myshot
# 有界面模式（推荐，确保内容渲染）
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs screenshot myshot --headed
# 自定义尺寸
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs screenshot myshot 800 600 --headed
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs click "button#submit"
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs fill "input[name=email]" "test@example.com"
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs select "select#country" "CN"
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs hover "div.menu-item"
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs evaluate "document.title"
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs close
添加到 ~/.config/fish/config.fish 或 ~/.bashrc：
# Fish
alias puppeteer-cli="node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs"
alias web-shot="node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs screenshot"
alias web-nav="node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs navigate"
# Bash/Zsh
alias puppeteer-cli='node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs'
alias web-shot='node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs screenshot'
alias web-nav='node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs navigate'
| 变量 | 说明 |
|---|---|
PUPPETEER_EXECUTABLE_PATH | 指定 Chrome 可执行文件路径 |
PUPPETEER_HEADLESS | 设置默认 headless 模式 |
| 命令 | 别名 | 说明 |
|---|---|---|
navigate <url> | nav, goto | 导航到 URL |
screenshot [name] [w] [h] | shot, ss | 截图 |
click <selector> | - | 点击元素 |
fill <selector> <value> | type, input | 填写输入框 |
select <selector> <value> | - | 选择下拉菜单 |
hover <selector> | - | 悬停元素 |
evaluate <code> | eval, js | 执行 JS |
close | exit, quit | 关闭浏览器 |
# 导航并截图
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs navigate https://github.com
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs screenshot github-home 1200 800
# 导航到登录页
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs navigate https://example.com/login
# 填写表单
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs fill "input#username" "myuser"
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs fill "input#password" "mypass"
# 点击登录
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs click "button[type=submit]"
# 截图结果
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs screenshot logged-in
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs navigate https://example.com
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs evaluate "document.querySelectorAll('h1').map(h => h.textContent)"
close 或进程退出screenshots/ 文件夹.class、ID #id、属性 [name=value]）--headed 选项如果截图结果是黑色或空白图片：
# 解决方案：使用 --headed 有界面模式
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs navigate https://github.com/trending --headed
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs screenshot github-trending --headed
这通常发生在 JavaScript 密集型网站（GitHub、SPA 应用等）。有界面模式可以确保页面正确渲染。
如果启动失败，可以手动设置 Chrome 路径：
export PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium
node ~/.claude/skills/puppeteer-cli/scripts/puppeteer-cli.mjs navigate https://example.com