一件反直觉的事

OpenAI 6月2日更新了 Codex，加了6个角色插件。我本来以为这是给开发者用的——毕竟 Codex 一直是编程工具。结果看了官方数据，非开发者用户已经占了20%，增速是开发者的3倍。

换句话说，最快上手 Codex 插件的人，可能不是你我这种写代码的。

这让我重新审视了一下这套插件系统到底在干什么。花了两天把官方仓库翻了一遍，记录一下实际配置过程和踩过的坑。

插件到底是什么

先说清楚，这里的"插件"不是 Chrome 扩展那种东西。它是一组打包好的配置文件，告诉 Codex 在特定工作场景下该连接哪些工具、用什么操作流程、遵循什么规则。

官方开源了模板仓库：github.com/openai/role-specific-plugins

目录结构长这样：

plugins/plugin-name/
├── .codex-plugin/plugin.json   # 插件清单，名称和元数据
├── .app.json                   # 外部应用连接配置
├── .mcp.json                   # MCP 服务器配置
├── skills/                     # 工作流指令和领域上下文
├── assets/                     # 图标、模板、示例文件
└── README.md

6个官方插件分别是：

• 数据分析（Data Analytics）——接 Snowflake、Databricks、Hex、Tableau
• 创意制作（Creative Production）——接 Figma、Canva、Shutterstock
• 销售（Sales）——接 Salesforce、HubSpot、Outreach、Clay
• 产品设计（Product Design）——接 Figma、Canva
• 公共股权投资——接 FactSet、PitchBook、Moody's
• 投行——交易工作流自动化

我拿数据分析插件做了完整的上手测试，下面是详细过程。

数据分析插件：从安装到跑通

第一步：拉代码

git clone https://github.com/openai/role-specific-plugins.git
cd role-specific-plugins/plugins/data-analytics

第二步：看 .app.json

打开 .app.json，里面长这样：

{
  "apps": {
    "snowflake": {
      "id": "REPLACE_WITH_SNOWFLAKE_APP_OR_CONNECTOR_ID"
    },
    "databricks": {
      "id": "REPLACE_WITH_DATABRICKS_APP_OR_CONNECTOR_ID"
    }
  }
}

注意那些 REPLACE_WITH_ 开头的占位符。你得换成自己 workspace 里的实际 connector ID。如果你的团队没用 Snowflake，直接把那个条目删掉就行，不删的话安装时会报错。

这里有个坑：不要从别人的 workspace 里复制 connector ID 过来用。官方文档明确说了，除了平台级的通用 ID（比如 templated_apps_* 开头的），其他 ID 不保证跨 workspace 可用。

第三步：检查 skills 目录

skills/ 目录里是这个插件的核心——一堆 Markdown 文件，定义了 Codex 在这个角色下的行为规则。

数据分析插件的 skills 包含：

• 怎么写 SQL 查询（风格约束、安全规则）
• 怎么解释指标变化（先看数据再下结论，不要编故事）
• 怎么生成报表（格式要求、图表类型选择）
• 怎么处理数据异常（发现异常先标记，不要自动修复）

这些文件你可以改。实际上官方也建议你改，因为每个团队的数据规范不一样。

比如你的团队所有 SQL 查询都要加 WHERE dt >= DATE_SUB(CURRENT_DATE(), 7) 来限制时间范围，就在 skills 文件里加上这条规则。

第四步：安装到 Codex

打开 Codex 桌面端，进入 Settings → Plugins，选择 "Import from folder"，指向你改好的插件目录。

安装完成后，在对话框里你会看到插件图标亮起来。这时候你可以直接说：

"上周 DAU 下降了 12%，帮我查一下是哪个渠道掉的"

Codex 会自动连接你配置的 Snowflake/Databricks，写 SQL，跑查询，生成图表，最后给你一个解释。

实测数据

我用公司的测试环境跑了几个任务：

任务	手动耗时	Codex 插件耗时	准确度
查某渠道 7 天 DAU 趋势	15 分钟	40 秒	SQL 正确，图表准确
对比两个 A/B 实验组	30 分钟	2 分钟	置信区间计算正确
生成周报数据摘要	45 分钟	3 分钟	数据对，但文字描述需要改
排查某指标异常原因	1-2 小时	8 分钟	找到了主因，但漏了一个次要因素

40秒查出 DAU 趋势这个确实快。但排查异常原因那个，它漏掉了一个次要因素——某个小流量渠道的 SDK 升级导致的数据上报延迟。这种业务上下文它没有，需要你自己在 skills 文件里补充。

自定义插件：实际操作

官方那6个插件覆盖不了所有场景。好消息是你可以从零写一个。

我给自己的团队写了一个"内容运营"插件，接了飞书多维表格和 Google Analytics，用来做每天的内容数据复盘。

plugin.json

{
  "name": "content-ops",
  "display_name": "内容运营助手",
  "description": "每日内容数据复盘和选题建议",
  "version": "0.1.0",
  "author": "92year"
}

.app.json

{
  "apps": {
    "feishu_bitable": {
      "id": "your_feishu_connector_id"
    },
    "google_analytics": {
      "id": "your_ga_connector_id"
    }
  }
}

skills/daily-review.md

这个文件是重头戏。我写了大概200行的指令，核心规则举几个：

## 每日复盘流程

1. 从飞书多维表格拉取昨天所有已发布内容的标题、平台、发布时间
2. 从 Google Analytics 拉取对应页面的 PV、UV、平均停留时长、跳出率
3. 计算每篇内容的"效率分"：UV / 发布后小时数
4. 按效率分排序，标记 TOP 3 和 BOTTOM 3
5. 对 TOP 3 分析标题关键词、发布时间段、内容类型的共性
6. 对 BOTTOM 3 给出具体改进建议（不要说"优化标题"这种废话，要具体到改哪个词）

## 约束

- 不要用"表现良好""有待提升"这种模糊说法，用具体数字
- 如果某篇文章 PV < 100，直接标记"数据量不足，不做分析"
- 停留时长 < 30 秒的文章，重点关注是否标题和内容不匹配

把这套配置导入 Codex 之后，每天早上说一句"跑一下昨天的内容复盘"，2分钟出结果。之前这事我手动做要半小时。

几个踩坑记录

坑 1：connector 权限不够

插件安装成功了，但跑任务时报 insufficient_permissions。原因是 Codex 用的是 OAuth 授权，你的 connector 绑定的账号得有对应的数据读取权限。Snowflake 那边尤其要注意，得给 Codex 用的 role 赋予 SELECT 权限。

坑 2：.mcp.json 和 .app.json 冲突

如果你同时配了 MCP 和 app connector 去连同一个数据源，Codex 会优先走 MCP。但 MCP 的返回格式和 app connector 不一样，可能导致 skills 里的处理逻辑出错。建议一个数据源只用一种连接方式。

坑 3：skills 文件太长导致上下文溢出

我一开始把所有规则都塞进一个 skills 文件，写了 800 多行。结果 Codex 处理复杂任务时开始"忘记"前面的规则。后来拆成了5个文件，每个文件控制在 200 行以内，问题消失了。

坑 4：Sites 功能的运行时限制

顺便提一下同时发布的 Sites 功能——它能把 Codex 生成的应用直接部署成网页。但运行时限制在 Cloudflare Worker 兼容的 ES 模块，不支持 Node.js 后端。我试着让它生成一个带数据库连接的后台管理页面，直接报错了。目前 Sites 只适合纯前端或者调 API 的轻量应用。

这套东西值得投入吗

说实话，如果你是独立开发者或者小团队，这套插件系统的收益不大。它的价值在"连接已有的企业工具"，但前提是你得有那些工具——Snowflake、Salesforce、HubSpot 这些都是企业级产品，一年的订阅费可能比你的插件省下的时间还贵。

但如果你在一个中大型团队，已经在用这些工具了，那插件确实能省不少重复劳动。数据分析师不用自己写 SQL 了，销售不用手动更新 CRM 了，产品经理可以快速出原型。

我更看好的是自定义插件这条路。官方那6个是起点，真正有价值的是按照自己团队的工作流来写 skills 文件。这比买一个标准化的 SaaS 工具灵活得多——你的规则你说了算。

快速上手清单

想试试的话，按这个顺序来：

1. 确认你的 Codex 版本是 2026.06 或更新（旧版本没有插件功能）
2. 去 github.com/openai/role-specific-plugins 拉代码
3. 选一个和你工作最相关的插件目录
4. 改 .app.json 里的 connector ID（没用的删掉）
5. 读一遍 skills/ 目录里的规则文件，按自己的需求改
6. 导入 Codex，跑一个简单任务测试
7. 遇到问题先看 Codex 的 debug log（Settings → Advanced → Show logs）

仓库地址：https://github.com/openai/role-specific-plugins

官方博客：https://openai.com/index/codex-for-every-role-tool-workflow/