Codex Record & Replay：把一次演示变成可复用 Skill

适用场景

Record & Replay 适合把你“会做但很难完整描述”的重复流程教给 Codex。比如报销、预订、创建 issue、下载固定报表、发布内容、按照团队习惯填写表单。

它不是用来录制所有电脑操作的万能工具。最适合它的流程应该稳定、短小、可验证，并且每次只替换少量输入。

使用前检查

开始录制前，先确认：

• 你使用的是支持该功能的 macOS Codex App。
• Computer Use 已启用。
• 当前地区和组织策略允许使用。
• 工作流不包含不该记录的密码、支付信息或客户数据。
• 成功标准可以清楚描述。

如果组织使用 requirements.toml 管理功能，Computer Use 被禁用时，Record & Replay 也可能不可用。

步骤 1：选择一个稳定流程

好流程示例：

• 每周下载同一个系统的报表。
• 按固定字段创建 Linear issue。
• 在内部后台发布一篇内容。
• 按固定规则整理某个表单。

不适合的流程：

• 每次页面和字段都大幅变化。
• 需要输入大量敏感信息。
• 成功标准模糊。
• 录制过程会跳到多个无关任务。

步骤 2：开始录制

官方流程大致是：

1. 在 Codex App 中打开 Plugins。
2. 打开加号菜单。
3. 选择 Record a skill。
4. 检查 Codex 建议的提示词，并补充必要背景。
5. 当 Codex 请求录制权限时，在准备好后批准。
6. 在 Mac 上演示完整流程。
7. 完成后从菜单栏、覆盖层或对话中停止录制。

录制时只做目标流程，不要顺手清理邮件、切换无关窗口或打开私人内容。

步骤 3：让 Codex 生成 Skill

停止录制后，Codex 会分析捕获到的流程，并草拟一个 Skill。一个好的 Skill 应该说明：

• 什么场景下使用。
• 需要哪些输入。
• 按什么步骤操作。
• 如何判断成功。
• 哪些异常要停止或请求用户确认。

生成后建议让 Codex 再优化一轮：

请把这个 Skill 改得更稳定：列出必需输入、可变输入、停止条件和验证步骤。不要包含我录制时临时打开的无关窗口。

步骤 4：重放流程

新开线程后，让 Codex 使用生成的 Skill，并提供本次变化的输入：

请使用刚才生成的报表下载 Skill，下载 2026-06-01 到 2026-06-15 的数据，并保存到项目的 reports 目录。

Codex 会结合当前环境可用的工具，例如 Computer Use、浏览器操作或已安装插件来完成任务。

录制质量建议

• 演示要短，但必须完整。
• 开始前说明目标和会变化的输入。
• 使用真实但不敏感的数据。
• 在 Skill 中补充隐藏偏好，例如命名规则、字段默认值、审批边界。
• 任务完成就停止录制，不要继续做无关操作。

录制得越干净，生成的 Skill 越容易复用。

什么时候升级成 Plugin

Record & Replay 生成的是快速可用的 Skill。下列情况再考虑 Plugin：

• 多个团队成员都要安装。
• 想把多个 Skill 打包在一起。
• 需要 MCP server、应用集成或 hooks。
• 需要管理版本、安装策略和分发元数据。

常见错误

不要在录制中输入真实密码或密钥。需要登录时优先使用系统已有会话或安全认证流程。

不要录制太长的流程。长流程更容易混入偶然步骤，重放时也更容易失败。

不要把生成的 Skill 当成不可修改的结果。录制只是草稿，后续修订往往决定它是否真的稳定。

小结

Record & Replay 的价值是把“我演示一次”变成“Codex 以后可以照着做”。最佳实践是选择稳定流程、录制前清理环境、录制后补充输入和验证规则，并在团队分发前再升级为 Plugin。