record

核心用法

record 是一个面向 macOS 终端的音视频录制工具封装 Skill，支持三大核心功能：麦克风音频录制、屏幕视频/截图捕获、摄像头视频/拍照。设计上兼顾人类用户与 AI Agent 的自动化需求，所有子命令均支持 --json 结构化输出和 --duration 定时终止，便于脚本集成。

典型调用模式包括：获取输出文件路径（stdout 输出）、列举可用设备（--list-devices 等）、指定输出位置（--output）、屏幕录制叠加系统音频或麦克风音轨，以及针对特定窗口或显示器的精准捕获。

显著优点

1. 管道友好设计：stdout 输出文件路径、stderr 输出状态信息，完美适配 Unix 管道和自动化脚本。
2. AI Agent 原生支持：--json 结构化输出与 --duration 非交互模式，解决了 AI 在终端环境中无法处理交互式按键终止的痛点。
3. 功能覆盖全面：单工具整合音频、屏幕、摄像头三大录制场景，减少多工具切换成本。
4. 权限透明：文档明确列出 macOS 系统权限要求（麦克风、屏幕录制、摄像头），引导用户前置配置。

潜在缺点与局限性

1. 平台锁定：仅支持 macOS，无法跨平台使用。
2. 外部依赖：需通过 Homebrew 安装底层 record CLI 工具，Skill 本身仅为文档封装，无自包含能力。
3. 权限门槛高：首次使用需用户手动在系统设置中授权，AI Agent 无法自动完成。
4. 无实时预览：缺乏录制过程中的可视化反馈，依赖事后文件验证。

适合的目标群体

• macOS 环境下的自动化测试工程师、DevOps 人员
• 需要录制演示视频、Bug 复现素材的产品经理与客服团队
• 构建 AI 工作流、需程序化捕获屏幕/音频的开发者
• 终端重度用户与效率工具爱好者

使用风险

1. 隐私泄露风险：麦克风、屏幕、摄像头均为高敏感度数据源，误操作可能导致敏感信息被录制。
2. 权限阻塞：若终端应用未获系统授权，命令将静默失败或触发系统弹窗中断自动化流程。
3. 存储管理：默认写入临时目录，长期高频使用需配合 --output 主动管理磁盘空间。
4. 版本漂移：底层 CLI 工具更新可能引入行为变更，Skill 文档存在滞后风险。

综合评估

核心用法

record 是一个面向 macOS 终端的音视频录制 CLI 工具文档型 Skill，支持三类核心功能：麦克风录音（record audio）、屏幕录制/截图（record screen）、摄像头录像/拍照（record camera）。AI 代理或用户可通过 --duration 参数设定录制时长实现非交互式操作，通过 --json 获取结构化输出，通过 --output 指定保存路径。此外支持设备列表查询（--list-devices、--list-displays 等）、特定窗口/显示器捕获（--window、--display）、以及屏幕录制时叠加系统音频或麦克风音频（--audio system/mic/both）。

显著优点

1. 零代码执行风险：纯 Markdown 文档型 Skill（T-MD 分类），无实际可执行代码，静态分析完全通过。
2. 隐私合规意识强：文档明确强调必须获得用户显式同意方可执行录制操作，并在敏感功能（录音、录屏、摄像头）前设置醒目标识，符合 GDPR/CCPA 等隐私法规要求。
3. 输出管道友好：标准输出仅返回文件路径，状态信息定向至 stderr，便于脚本和 AI 代理捕获处理。
4. 结构化输出支持：全子命令支持 --json 标志，方便程序解析。
5. 来源可追溯：维护者为 GitHub 组织账号 atacan/openclaw，CLI 工具源码公开可查，用户可自行审计。

潜在缺点与局限性

1. 依赖外部二进制：Skill 本身仅提供文档指引，实际功能依赖用户本地通过 Homebrew 安装的 record CLI 工具，版本兼容性、工具安全性需用户自行把控。
2. macOS 独占：仅支持 macOS 系统，且需用户预先在系统设置中授予终端应用（Terminal/iTerm2 等）麦克风、录屏、摄像头权限。
3. 无交互式终止保障：若未指定 --duration，工具将等待按键终止，AI 代理在无 TTY 环境下可能阻塞，必须强制使用 --duration。
4. 许可未明确：安全报告显示 license 字段为 "Not Specified"，开源协议不明确。

适合人群

• AI 自动化代理：需要在 macOS 环境中自动完成屏幕截图、简短录音、摄像头拍照等任务的 headless 场景。
• 开发者与 DevOps：偏好命令行工作流、需将音视频捕获集成到脚本或 CI/CD 流程的技术用户。
• 隐私敏感型用户：重视数据主权、希望完全本地化处理录屏录音而不依赖云端服务的 macOS 用户。

常规风险

• 权限配置门槛：终端需预先获取系统隐私权限，首次使用可能因权限弹窗导致脚本中断。
• 敏感数据泄露：若 AI 代理在未充分确认用户意图的情况下自动执行录制，可能捕获敏感屏幕内容或对话；尽管 Skill 文档已内置同意提醒，实际执行仍取决于上层代理的实现。
• 供应链风险：Homebrew tap 中的 CLI 工具更新与 Skill 文档版本可能不同步，极端情况下存在上游工具被篡改的潜在风险（建议用户安装前验证源码）。