Scrawl 给Agent看问题 Skill 技能

Scrawl 是一款面向 Agent 编程协作的 macOS / Windows 原生录屏标注应用，让你可以"给 Agent 展示一个问题"而不是文字描述。GitHub 仓库 https://github.com/kitlangton/scrawl，官网 https://scrawl.kitlangton.com，发布 7 天内获得 470+ Star。按下 ⌥⇧S 启动录制，圈画、点击、说话，按 ⌥⇧S 结束，输出一份紧凑、可被 Agent 直接读取的"问题包"。

核心能力：

• 一键录制屏幕 + 麦克风 + 鼠标圈画，按 ⌥⇧S 开始/结束
• 自动产出 contact-sheet.png（带标注的关键帧拼版）+ frames/ 单帧 + 时间对齐转录 summary.md + manifest scrawl.json
• 摄像头 / iPhone 屏幕镜像录入，与屏幕同步保存
• GPUI 原生菜单栏与预览窗口，macOS 26+ Apple Silicon 体验最佳
• 写入 OpenCode V2 会话：选中 OpenCode session 自动推送问题包
• 导出 mp4 / 自动 zoom / 切到活动区域裁切

安装配置：

• macOS：从 https://scrawl.kitlangton.com 下载 DMG 或 brew install --cask kitlangton/tap/scrawl
• Windows：下载 zip 解压运行 scrawl.exe（x64，preview 版未签名）
• 启动后授予屏幕录制 / 麦克风 / 辅助功能权限（应用引导一步一步给）
• 装 CLI：在 Settings → Agents 面板一键 Install / Uninstall scrawl 命令
• 装 Skill：在 Agents 面板 Copy 提供的安装 prompt，贴给 Claude Code / OpenCode

使用步骤：

1. 启动 Scrawl，按 ⌥⇧S 录制屏幕 + 说话 + 圈画
2. 再按 ⌥⇧S 结束录制，应用自动产出 contact-sheet + summary.md + manifest
3. 在 Review 应用里预览关键帧、检查转录时间轴
4. 选 OpenCode 会话并 Send，Agent 直接拿到截图、音频、转录、关键路径
5. 或导出 MP4（scrawl export latest --zoom --out demo.mp4）发给别人
6. 在 settings 里改快捷键、麦克风、转录器（Apple Speech 或 Hex）

适用场景：

• Agent 看不懂你的文字描述时，用画面直接展示
• 复现 UI bug 反馈给 AI
• 给 Agent 演示一段操作流程
• 录一段带口播的产品 demo 转视频
• 远程帮别人 debug 前端或设计稿

适用人群： 前端工程师、设计师、用 Agent 做开发的独立开发者、QA 测试、做产品 demo 的创业者。

工作原理： Scrawl 用 ScreenCaptureKit 录屏，AVFoundation 录麦克风，AppKit 全局鼠标监视器（无需 Input Monitoring 权限）监听圈画手势；活跃事件 tap 通过 Accessibility 抓键盘；SpeechAnalyzer 转录无需 Speech Recognition 权限；自动按视觉差异抽帧，输出 contact-sheet + summary + manifest。

官方链接：

• 官网：https://scrawl.kitlangton.com
• GitHub: https://github.com/kitlangton/scrawl
• Releases: https://github.com/kitlangton/scrawl/releases/latest

更新动态： 7 天内新增 iPhone 镜像录制、OpenCode V2 session 路由、自动 zoom 导出、GPUI review window、macOS 27+ 兼容、Hex 转录器接入。

出品方： Kit Langton（个人开发者），用 Rust 写 GPUI 框架做原生 UI，开源协议见官网与 GitHub。