peekaboolisted
Install: claude install-skill codingSamss/all-my-ai-needs
# Peekaboo 视觉分析 Skill
通过peekaboo进行macOS截图和视觉分析,帮助调试UI问题。
## 截图保存目录
默认目录变量:
```bash
PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
```
所有截图保存到: `${PEEKABOO_IMG_DIR}/`
## 自动触发条件
当遇到以下情况时,主动使用peekaboo截图分析:
- 用户描述UI/界面问题但未提供截图时
- 调试前端/客户端代码遇到视觉相关bug时
- 用户提到"看看"、"界面"、"显示"、"样式"、"报错弹窗"等词��时
- 命令执行后需要确认GUI状态时
- 用户描述的问题可能通过视觉信息更容易理解时
## 截图策略
- 默认使用 `--mode frontmost` 截取当前活动窗口
- 用户提到具体应用时,使用 `--app "应用名"` 指定
- 需要分析内容时,使用 `--analyze "分析目标"` 直接获取AI分析
- 需要定位UI元素时,使用 `--annotate` 生成带标注的截图
- **必须使用 `--path` 参数指定保存路径到 peekabooImg 目录**
## 常用命令
### 截取当前窗口
```bash
PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --mode frontmost --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json
```
### 截取指定应用
```bash
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分析
```bash
PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --mode frontmost --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --analyze "描述界面内容"
```
### 列出所有窗口
```bash
peekaboo list windows --json
```
### 截取指定标题窗口
```bash
PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --window-title "窗口标题" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json
```
## 清理规则
**重要:截图任务完成后,必须执行清理操