OpenSkillIndex← back to search
claude-code

All-my-ai-needs peekaboo

macOS截图与视觉分析。自动截图、UI分析、窗口捕获。关键词: 截图, screenshot, 界面, UI, 看看, 显示, 样式, 报错弹窗, 视觉分析

install
source · Clone the upstream repo
git clone https://github.com/codingSamss/all-my-ai-needs
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/codingSamss/all-my-ai-needs "$T" && mkdir -p ~/.claude/skills && cp -r "$T/platforms/claude/skills/peekaboo" ~/.claude/skills/codingsamss-all-my-ai-needs-peekaboo && rm -rf "$T"
manifest: platforms/claude/skills/peekaboo/SKILL.md
source content

Peekaboo 视觉分析 Skill

通过peekaboo进行macOS截图和视觉分析，帮助调试UI问题。

截图保存目录

默认目录变量：

PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"

所有截图保存到: 

${PEEKABOO_IMG_DIR}/

自动触发条件

当遇到以下情况时，主动使用peekaboo截图分析：

  • 用户描述UI/界面问题但未提供截图时
  • 调试前端/客户端代码遇到视觉相关bug时
  • 用户提到"看看"、"界面"、"显示"、"样式"、"报错弹窗"等词汇时
  • 命令执行后需要确认GUI状态时
  • 用户描述的问题可能通过视觉信息更容易理解时

截图策略

  • 默认使用 
    --mode frontmost
    截取当前活动窗口
  • 用户提到具体应用时，使用 
    --app "应用名"
    指定
  • 需要分析内容时，使用 
    --analyze "分析目标"
    直接获取AI分析
  • 需要定位UI元素时，使用 
    --annotate
    生成带标注的截图
  • 必须使用 
    --path
    参数指定保存路径到 peekabooImg 目录

常用命令

截取当前窗口

PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --mode frontmost --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json

截取指定应用

PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --app "IntelliJ IDEA" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json
peekaboo see --app "Safari" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json
peekaboo see --app "Terminal" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json

截图并AI分析

PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --mode frontmost --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --analyze "描述界面内容"

列出所有窗口

peekaboo list windows --json

截取指定标题窗口

PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --window-title "窗口标题" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json

清理规则

重要：截图任务完成后，必须执行清理操作：

# 清理截图文件
PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
rm -f "${PEEKABOO_IMG_DIR}"/*.png

# 清理peekaboo快照缓存
peekaboo clean --all-snapshots 2>/dev/null || true

清理时机：

  • 截图分析完成并向用户反馈结果后
  • 用户明确表示不再需要截图时
  • 任务结束时

使用原则

  • 截图前简要说明原因
  • 优先截取相关窗口而非全屏
  • 分析结果要结合代码上下文给出建议
  • 任务完成后务必清理截图文件和缓存

前置条件

  1. peekaboo已安装: 
    brew install steipete/tap/peekaboo
  2. 已授予屏幕录制权限: 系统设置 > 隐私与安全性 > 屏幕与系统音频录制