RudderStack 技能用 rudderlabs/rudder-agent-skills,不要抄 /plugin
仓库表把 Codex 写成 --agent codex。官方没钉。主路径是 npx skills add rudderlabs/rudder-agent-skills。示例技能是 rudder-cli-workflow。不要发明 plugin add。
RudderStack Agent Skills 安装页前提写 Claude Code、Cursor、Cline、OpenCode 或其它受支持代理。仓库 docs/installation.md 的 agent 表把 Codex 写成 --agent 旗标 codex,项目目录 .agents/skills/,全局 ~/.codex/skills/。这是教代理怎么开 Rudder CLI、MCP、Terraform、Profiles 的技能,不是 Codex /plugins,也不会替你写 mcp_servers.rudderstack。官方安装命令:
npx skills add rudderlabs/rudder-agent-skills
先看目录:
npx skills add rudderlabs/rudder-agent-skills --list
官方单项示例钉的是 Claude:-a claude-code --skill rudder-cli-workflow。只要 Codex 时,skills CLI 允许自己改成 --agent codex,这不是 RudderStack 专节,也不是 /plugins:
npx skills add rudderlabs/rudder-agent-skills --agent codex --skill rudder-cli-workflow
仓库名是 rudderlabs/rudder-agent-skills。官方没有钉 --agent codex。-g --all 会把全部技能装进所有检测到的客户端。不要手拷到 ~/.codex/skills。不要发明 codex plugin add rudder@…。
不要抄 Claude Code 的 /plugin marketplace add rudderlabs/rudder-agent-skills 或 /plugin install rudder-core@rudder-agent-skills。那是 Claude 插件市场,Codex 看不见。Cursor 专节是 -a cursor,也不要当成 Codex 命令。
官方安装页的斜杠是 Claude 风格:/rudder-cli-setup、/rudder-mcp-setup、/rudder-environment-check。Codex 用 /skills 或 $rudder-cli-setup、$rudder-mcp-setup。rudder-mcp-setup 教怎么连 mcp.rudderstack.com,不会替你写 [mcp_servers.rudderstack]。远程 MCP 仍走 codex mcp add rudderstack --url https://mcp.rudderstack.com/mcp,再 codex mcp login rudderstack。
CLI 技能要先有 rudder-cli。官方让你跑 setup 技能装二进制并登录;仓库安装指南也可以 brew tap rudderlabs/rudder-iac 再 brew install rudder-cli,然后 rudder-cli auth login。Access token 放启动 CLI / Codex 的进程,不要写进 args、env 表或提示词。
装完新开会话。先问「用 rudder-cli 校验当前 Tracking Plan」,看它是否调起 rudder-cli-workflow。数据目录技能名是 rudder-data-catalog。
不要做这些:
- 不要把默认
npx skills add rudderlabs/rudder-agent-skills当成 Codex/plugins。 - 不要发明
codex plugin add rudder@openai-curated。 - 不要抄 Claude 的
/plugin marketplace add。 - 不要以为技能会写出
mcp_servers.rudderstack。
网页 Cloud 不读本机技能目录。改完新开一轮,/skills 应能看见 rudder-cli-workflow。