Codex CLI Skills & Profiles

给 Codex CLI 加上深度调研、图片生成、浏览器调试等能力，配好多模型切换，开箱即用。

仓库采用面向个人开发效率的默认配置；你可以整套使用，也可以按需选取 Profiles 或 Skills。使用前请确认模型提供商、权限和外部依赖，并避免提交真实密钥。

为什么用这套配置

如果你想少花时间调配置，多花时间完成真正的开发工作，这个仓库提供了一套可以直接运行、也可以自由组合的 Codex CLI 工作台。

• 灵活切换模型：预置 copilot-gateway、ChatGPT、Azure OpenAI、OpenRouter 和 LiteLLM/GitHub Copilot Profiles。
• 复用成熟工作流：通过 Skills 完成需求梳理、深度调研、图像生成、字幕提取和任务交接。
• 连接真实开发环境：通过 Chrome DevTools MCP 调试网页、检查性能并执行浏览器自动化。
• 整套或按需使用：既可以作为完整的 Codex Home，也可以只复制需要的 Profile 或 Skill。

本项目面向 Codex CLI；Claude Code 的配置、Skills 与 Agents 请查看 Claude Code Settings。

快速开始

1. 安装 Codex CLI

使用 npm 安装：

npm install -g @openai/codex

也可以参考 Codex CLI 官方文档 选择其他安装方式。

2. 推荐：使用 Codex Plugin 安装 Skills

如果你已经有自己的 Codex 配置，只想安装本仓库提供的 Skills，可以把仓库作为 Plugin Marketplace 添加：

codex plugin marketplace add feiskyer/codex-settings
codex plugin list --marketplace codex-settings --available --json
codex plugin add codex-settings@codex-settings

安装完成后启动一个新的 Codex 会话，让 Codex 重新发现 Plugin 中的 Skills。未指定 --ref 时，Marketplace 使用仓库默认分支，因此首次安装会获取当时的最新版本。仓库中的 Plugin 版本为 1.5.0；发布时使用匹配的 Git 标签 v1.5.0。

仓库发布新版并更新 Plugin 版本后，刷新 Marketplace 快照并重新安装：

codex plugin marketplace upgrade codex-settings
codex plugin add codex-settings@codex-settings

如果使用本仓库 clone，也可以运行更新脚本。它会刷新所有已配置的 Git Marketplace，同时在刷新前冻结当前已安装且启用的 Plugin 列表，随后只更新这份列表中的 Plugin；不会安装 Marketplace 中其他未安装的 Plugin：

# 更新所有已配置的 Git Marketplace 及其中已安装的 Plugin
scripts/update-codex-plugins.sh

# 只更新指定 Marketplace 中已安装的 Plugin
scripts/update-codex-plugins.sh --marketplace codex-settings

# 仅查看将要执行的命令
scripts/update-codex-plugins.sh --dry-run

为避免改变启用状态，已安装但被禁用的 Plugin 会被跳过；本地或系统管理的 Marketplace 也不会由该脚本刷新。更新完成后请启动新的 Codex 会话。

需要卸载时运行：

codex plugin remove codex-settings@codex-settings
codex plugin marketplace remove codex-settings

也可以从本地干净 clone 测试或开发 Plugin：

git clone https://github.com/feiskyer/codex-settings.git ~/codex-settings
codex plugin marketplace add ~/codex-settings
codex plugin add codex-settings@codex-settings

Plugin 直接复用根目录 skills/，不会生成第二份 Skills。安装后只会把这些 Skills 作为工作流提供给 Codex，不会应用或替换你的 config.toml，也不会启用本仓库的 Profiles、模型 Provider、LiteLLM 配置或根目录 MCP 设置。如果需要完整配置，请使用下一节的 Codex Home 安装方式。

备选：使用 npx skills 安装（版本可能滞后）

也可以使用第三方 skills CLI 从仓库安装 Skills：

npx skills add feiskyer/codex-settings

按照交互提示选择 Codex 和安装范围。当前 npx skills add 没有提供 Git tag/ref 选择参数，其索引、缓存或发布快照也可能滞后，因此不能保证与仓库默认分支的最新内容同步；需要优先获取仓库最新 Plugin 快照时，使用上面的 Codex Plugin 安装方式。

3. 完整安装：直接克隆到 ~/.codex

如果本机还没有 ~/.codex，最简单的方式是直接把仓库克隆到 Codex 的用户配置目录：

git clone https://github.com/feiskyer/codex-settings.git ~/.codex

这样根目录的 config.toml 会成为默认配置，skills/ 下的内容也会被 Codex 自动发现。

如果 ~/.codex 已经存在：保留原目录并手动合并

先把仓库克隆到其他目录。下面使用 ~/codex-settings，你也可以换成其他位置：

git clone https://github.com/feiskyer/codex-settings.git ~/codex-settings

复制配置前，先备份现有文件：

test ! -f ~/.codex/config.toml || \
  cp ~/.codex/config.toml ~/.codex/config.toml.bak

# 使用仓库默认配置
cp ~/codex-settings/config.toml ~/.codex/config.toml

如需保留其他模型提供商的 Profiles 和 LiteLLM 示例，一并复制：