30款热门AI模型一站整合DeepSeek/GLM/Qwen 随心用限时 5 折。 点击领海量免费额度刚接触 Codex 时很多开发者会把它当作一个“加强版聊天机器人”只用来生成代码片段或回答技术问题。但很快就会发现这种“裸奔”式的使用方式极大地浪费了 Codex 作为智能编码助手的真正潜力。它就像一个拥有强大算力但只安装了操作系统的电脑没有安装任何专业软件无法处理复杂的、流程化的开发任务。真正让 Codex 从“玩具”变为“生产力核武器”的是Skills。本文将为你彻底解析 Codex Skills 是什么、为什么必须安装并手把手教你安装和配置 10 个能立刻提升开发效率的必备 Skills让你的 Codex 真正武装起来。1. Codex Skills 核心概念从“聊天”到“执行”1.1 什么是 Codex SkillsCodex Skills 可以理解为 Codex 的“技能插件”或“指令集”。它们不是简单的文本模板而是模块化的、可执行的指令包用于告诉 Codex 如何按照你的特定需求去完成一项复杂的任务。一个 Skill 的核心是一个名为SKILL.md的 Markdown 文件它包含两部分元数据YAML Frontmatter定义了技能的名称和描述。Codex 通过读取这些描述来决定何时触发该技能。执行指南Body详细的、分步骤的指导告诉 Codex 执行任务的具体流程、需要调用的工具、处理的逻辑等。这种设计实现了“按需加载”Codex 在对话开始时只加载所有 Skills 的元数据非常轻量只有当你的请求匹配到某个 Skill 的描述时才会加载并执行该 Skill 的详细指南从而保持上下文的高效和精准。1.2 为什么“裸奔”的 Codex 效率低下没有安装 Skills 的 Codex其能力边界是模糊和通用的。当你提出一个复杂需求时例如“分析一下这个 Git 仓库的热点文件”Codex 只能基于其通用知识生成一段分析思路或脚本建议。你需要手动复制这个建议。在终端中寻找或创建合适的脚本。调整参数以适应你的项目。处理可能出现的错误。解读输出结果。整个过程充满了上下文切换和手动操作。而一个对应的 Skill如codebase-recon则封装了完整的分析流程自动获取 Git 历史、运行分析脚本、按特定规则如修改频率、Bug 引入次数计算风险、并以结构化的格式如表格呈现结果。你只需要说一句“用 codebase-recon 技能分析当前仓库”Codex 就能自动完成上述所有步骤。Skills 的本质是将最佳实践和重复性工作流程固化、自动化让 Codex 从一个“建议者”转变为“执行者”。2. 环境准备与 Skills 安装基础在安装具体 Skills 之前我们需要确保基础环境就绪。2.1 确认 Codex 安装与运行首先你需要已经安装并可以正常运行 Codex CLI。可以通过以下命令验证codex --version如果未安装请参考官方文档进行安装。通常的安装方式是通过包管理器如 Homebrew或直接下载二进制文件。2.2 了解 Skills 目录结构Codex Skills 默认安装在$CODEX_HOME/skills目录下。在大多数系统上$CODEX_HOME默认为~/.codex。你可以通过以下命令查看echo $CODEX_HOME # 如果未设置则默认是 ~/.codex ls -la ~/.codex/skills/ # 查看已安装的技能如果skills目录不存在Codex 会在首次加载技能时自动创建但为了清晰我们可以手动创建mkdir -p ~/.codex/skills2.3 两种安装 Skills 的方法方法一使用 Skill Installer推荐社区维护了一个awesome-codex-skills仓库其中包含了一个便捷的安装脚本。这是安装和管理 Skills 最规范的方式。克隆仓库git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills使用安装脚本安装单个 Skill 假设我们要安装meeting-notes-and-actions这个技能。# 进入技能安装器目录 cd skill-installer # 运行安装脚本 python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path meeting-notes-and-actions这个脚本会自动从指定的仓库路径下载技能文件夹并将其复制到~/.codex/skills/目录下。方法二手动安装如果你从其他来源如个人仓库获取了一个 Skill或者想快速测试可以手动安装。获取 Skill 文件夹确保你有一个包含SKILL.md文件的技能文件夹例如spreadsheet-formula-helper。复制到 Skills 目录# 假设技能文件夹在当前目录 cp -r ./spreadsheet-formula-helper ~/.codex/skills/验证安装ls ~/.codex/skills/ # 应该能看到 spreadsheet-formula-helper 文件夹 cat ~/.codex/skills/spreadsheet-formula-helper/SKILL.md | head -20 # 查看技能的前几行确认元数据存在2.4 加载与激活 Skills安装 Skills 后必须重启 Codex 会话新的技能元数据才会被加载。只需关闭当前的 Codex CLI 窗口重新打开一个新的即可。在新的会话中你可以通过自然语言描述任务来触发技能。例如安装spreadsheet-formula-helper后你可以说“帮我写一个 Excel 公式用来计算 A 列中大于 100 的数值的平均值。” Codex 识别到这与“电子表格公式”相关就会自动加载并应用该技能。3. 必装十大 Skills 详解与实战以下精选的 10 个 Skills 覆盖了开发、协作、写作、数据分析等核心场景能极大提升你的日常工作效率。我们将按照开发与代码工具 - 生产力与协作 - 通信与写作 - 数据与工具的顺序进行介绍。3.1 开发与代码工具类 Skills这类 Skills 直接作用于你的代码库处理代码审查、迁移、部署等硬核任务。3.1.1pr-review-ci-fix自动化 PR 审查与 CI 修复核心价值将 GitHub/GitLab 的 PR 审查与 CI 流水线修复流程自动化。它不仅能生成审查意见还能分析 CI 失败日志并尝试提供修复方案形成一个“审查-反馈-修复”的闭环。安装命令使用安装器cd awesome-codex-skills/skill-installer python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path pr-review-ci-fix使用场景当你推送代码后CI 流水线失败但日志冗长难以定位。你需要对同事的 PR 进行快速、规范的代码审查。实战示例 在 Codex 会话中你可以直接说请使用 pr-review-ci-fix 技能检查当前分支关联的 GitHub PR 并审查代码。如果 CI 失败请分析原因并给出修复建议。Codex 会调用ghCLI 工具获取 PR 信息分析代码变更并检查最近的 CI 运行状态。输出会包括代码审查摘要架构、逻辑、风格问题。CI 状态通过/失败。失败分析如果失败会提取关键错误信息并解释。修复建议具体的代码修改建议或配置调整步骤。3.1.2codebase-migrate大型代码库迁移与重构核心价值安全、可控地进行大规模代码库迁移或重构例如升级框架版本、替换 API、统一代码风格。它将变更拆分成可审查的小批次并支持 CI 验证避免“一次改完无法回退”的灾难。安装命令python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path codebase-migrate使用场景将项目从 Vue 2 升级到 Vue 3。将var声明的函数全部改为const箭头函数。替换一个被废弃的第三方库。实战示例 假设你要将项目中的moment.js替换为day.js。我需要将当前项目中的所有 moment.js 引用替换为 day.js。请使用 codebase-migrate 技能制定一个分步迁移计划并先对 src/utils/dateHelper.js 文件进行第一批次的重构。Codex 会分析项目结构识别所有引用moment的文件。制定一个分批次例如每次处理 5-10 个文件的迁移计划。对指定的第一批文件进行实际代码替换并生成一个变更列表供你审查。建议你提交第一批更改并运行测试确认无误后再进行下一批。3.1.3sentry-triage本地化诊断 Sentry 问题核心价值直接将 Sentry 报警中的堆栈跟踪映射到本地源代码无需在 Sentry 界面和 IDE 之间来回切换、复制粘贴。极大缩短了线上问题定位时间。安装命令python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path sentry-triage使用场景收到 Sentry 错误报警邮件或 Slack 通知时。实战示例 将 Sentry 错误页面的堆栈跟踪信息复制到 Codex。这是从 Sentry 获取的错误堆栈信息[粘贴堆栈信息]。请使用 sentry-triage 技能帮我定位到本地代码的对应文件和行号并分析可能的原因。Codex 会解析堆栈信息将其中的文件路径和行号与本地项目匹配并尝试打开或高亮显示相关代码。它还会结合错误信息和代码上下文给出可能的原因分析例如“第 45 行可能对userInput未做空值判断”。3.2 生产力与协作类 Skills这类 Skills 帮助你管理任务、会议、文档连接外部工具提升团队协作效率。3.2.1meeting-notes-and-actions会议纪要与行动项生成核心价值将杂乱的会议录音转录文本或聊天记录自动转化为结构清晰的会议纪要并提取出带有负责人和截止日期的行动项。安装命令python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path meeting-notes-and-actions使用场景每次开完会面对大段的转录文本头疼时。实战示例 将 Otter.ai 或腾讯会议导出的转录文本保存为meeting.txt然后在 Codex 中请使用 meeting-notes-and-actions 技能处理 ./meeting.txt 文件中的内容。生成一份包含会议主题、关键讨论点、做出的决策以及行动项标注负责人和预期完成时间的摘要。输出将是一个格式良好的 Markdown 文档类似于## 会议摘要Q2 产品规划会 **时间**2023-10-27 **参会人**Alice, Bob, Charlie ### 关键讨论 - 确定了新功能 X 的核心用户场景。 - 讨论了技术方案 A 与 B 的利弊。 ### 决策 - 采用技术方案 A因其长期维护成本更低。 ### 行动项 - [ ] **Alice**: 撰写功能 X 的详细产品需求文档 (PRD)。截止日期2023-11-03 - [ ] **Bob**: 评估方案 A 对现有系统架构的影响。截止日期2023-11-01 - [ ] **Charlie**: 准备技术方案评审会议。截止日期2023-10-303.2.2linear/issue-triage项目管理与问题分类核心价值直接在终端内管理 Linear 或 Jira 等项目管理工具中的任务。可以创建、更新、筛选问题并对问题 backlog 进行智能分类和优先级排序。安装命令# 安装 Linear 技能 python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path linear # 或安装通用问题分类技能 python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path issue-triage前置条件需要先通过 Composio CLI 配置 Linear/Jira 的访问凭证。# 安装 Composio CLI pip install composio # 添加 Linear 集成 composio add linear # 按照提示完成 OAuth 授权实战示例使用 linear 技能为我创建一个新的 issue。 - 标题修复用户登录页面的 CSS 错位问题 - 描述在 Safari 浏览器上登录按钮与输入框重叠。 - 项目Web Frontend - 状态Todo - 优先级HighCodex 会调用 Composio 工具在指定的 Linear 项目中创建好这个 issue并返回 issue 的链接和 ID。3.2.3connect/connect-apps连接千款应用核心价值这是 Codex 的“超级连接器”。通过 Composio 平台让 Codex 获得操作 1000 种应用如 Slack、GitHub、Notion、Google Sheets、Salesforce 等的能力从“思考”变为“行动”。安装命令python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path connect # 或 python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path connect-apps实战示例使用 connect 技能查询我在 GitHub 上最近 3 个未关闭的 PR并将它们的标题和链接总结后发送到 Slack 的 #team-updates 频道。Codex 会通过 Composio 调用 GitHub API 获取你的 PR 列表。格式化信息。再通过 Composio 调用 Slack API 发送消息。3.3 通信与写作类 Skills这类 Skills 优化你的书面沟通生成专业文档。3.3.1email-draft-polish邮件起草与润色核心价值根据简单的要点快速生成结构完整、语气得体的商务邮件。或者将你写好的草稿润色得更专业、简洁。安装命令python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path email-draft-polish实战示例我需要给客户王总写一封邮件使用 email-draft-polish 技能。要点如下 - 问候并感谢上次会议。 - 附上修改后的项目方案 v2.0。 - 询问对预算部分的反馈。 - 希望下周能安排一个简短的电话会议。 - 语气要专业且友好。Codex 会生成一封格式规范、用词准确的邮件草稿你几乎可以直接复制发送。3.3.2changelog-generator自动生成变更日志核心价值根据 Git 提交历史或功能摘要自动生成符合约定式提交Conventional Commits规范的、易于阅读的变更日志CHANGELOG节省手动整理的时间。安装命令python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path changelog-generator实战示例请使用 changelog-generator 技能基于当前 Git 仓库中上次打标签v1.2.0到当前 HEAD 之间的所有提交生成一份 CHANGELOG.md 的更新内容。按 feat, fix, chore 等类型分类。Codex 会运行git log命令解析提交信息并生成类似如下的 Markdown## [Unreleased] ### Features - 新增用户头像上传功能 (#123) - 支持深色模式主题切换 (#145) ### Fixes - 修复了登录页面在移动端的布局错位问题 (#156) - 解决了 API 超时设置不生效的 bug (#167)3.4 数据、分析与工具类 Skills这类 Skills 处理数据、生成内容并提供实用工具。3.4.1spreadsheet-formula-helper电子表格公式专家核心价值无论是复杂的VLOOKUP嵌套、数组公式还是Google Sheets特有的QUERY函数这个技能都能帮你写出正确的公式并解释现有公式的逻辑。安装命令python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path spreadsheet-formula-helper实战示例我在 Google Sheets 里有一个表格A列是产品名B列是销售额。我想在 C 列实现如果 B 列销售额大于 10000则显示“优秀”在 5000 到 10000 之间显示“良好”否则显示“待提升”。请使用 spreadsheet-formula-helper 技能写出公式。Codex 会给出精确的公式IF(B210000, “优秀”, IF(B25000, “良好”, “待提升”))并解释每个参数的作用。3.4.2file-organizer智能文件整理核心价值按照预设或自定义的规则如按扩展名、按日期、按项目自动整理混乱的下载文件夹或项目目录保持工作区整洁。安装命令python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path file-organizer实战示例我的 ~/Downloads 文件夹很乱。请使用 file-organizer 技能帮我把所有 .pdf 文件移动到 ~/Documents/PDFs所有 .jpg 和 .png 移动到 ~/Pictures/Downloads并删除所有超过 30 天的 .tmp 文件。请先展示计划执行的操作我确认后再执行。Codex 会先列出它“将要”执行的所有移动和删除操作等你确认后再实际运行这些命令安全又高效。3.4.3paperjsx本地化 Office 文档生成核心价值无需连接外部 API直接在本地将结构化数据JSON生成 PPTX、DOCX、XLSX 或 PDF 文件。完美用于生成报告、发票、图表等。安装命令python scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path paperjsx前置条件需要在本地运行paperjsx/mcp-server。npm install -g paperjsx/mcp-server paperjsx-mcp-server # 保持此服务器运行实战示例我有一个 JSON 数据表示本季度的销售数据。请使用 paperjsx 技能将其生成一个包含柱状图的 PPTX 演示文稿。你需要提供 JSON 数据Codex 会指导你如何配置并与本地的 MCP 服务器交互最终生成一个.pptx文件。4. Skills 的管理、创建与高级用法4.1 管理已安装的 Skills查看已安装技能ls -la ~/.codex/skills/禁用某个技能暂时不需要可以将其移出skills目录或重命名其SKILL.md文件。mv ~/.codex/skills/some-skill ~/.codex/skills/_disabled_some-skill更新技能对于通过git clone安装的技能可以进入该技能的本地仓库目录执行git pull然后重新运行安装脚本或手动复制。社区技能更新频繁建议定期关注。4.2 如何创建你自己的 Skill当你发现某个重复性工作流程值得自动化时就可以创建自己的 Skill。创建技能文件夹结构mkdir -p ~/.codex/skills/my-custom-skill cd ~/.codex/skills/my-custom-skill mkdir -p scripts references assets # 可选目录创建核心SKILL.md文件--- name: generate-api-client description: 根据 Swagger/OpenAPI 规范文件自动生成 TypeScript API 客户端代码。当用户提到“生成API客户端”、“从swagger生成代码”时触发。 --- # 生成 API 客户端 本技能用于根据提供的 OpenAPI 3.0 规范文件生成强类型的 TypeScript Axios 客户端代码。 ## 步骤 1. 请用户提供 OpenAPI 规范文件的路径通常是 swagger.json 或 openapi.yaml。 2. 使用 openapi-generator-cli 工具生成代码。如果未安装提示用户运行 npm install openapitools/openapi-generator-cli -g。 3. 建议生成命令例如 bash openapi-generator generate -i ./openapi.yaml -g typescript-axios -o ./src/api-client 4. 提示用户检查生成的 src/api-client 目录并可能需要根据项目结构调整 basePath 和 import 语句。 5. 提供一个简单的使用示例。关键点description字段要尽可能详细地描述触发场景这是 Codex 匹配技能的关键。可选创建辅助脚本对于更确定性的操作可以放在scripts/目录下。# ~/.codex/skills/my-custom-skill/scripts/generate.sh #!/bin/bash SPEC_FILE$1 OUTPUT_DIR$2 openapi-generator generate -i $SPEC_FILE -g typescript-axios -o $OUTPUT_DIR echo 客户端已生成至 $OUTPUT_DIR然后在SKILL.md中引用它“可以运行scripts/generate.sh ./openapi.yaml ./src/api-client”。重启 Codex 并测试重启 Codex 后尝试说“帮我从这个openapi.yaml文件生成一个 TypeScript API 客户端”看看技能是否被正确触发。4.3 技能使用的最佳实践精确描述需求虽然 Codex 能理解自然语言但更精确的描述能获得更准确的结果。例如“用pr-review-ci-fix看下 PR #45” 比“检查一下那个PR”更好。分步确认对于文件操作如file-organizer或重要变更如codebase-migrate让技能先提供“执行计划”你确认后再执行。组合使用技能Codex 可以在一个会话中连续使用多个技能。例如先用meeting-notes-and-actions生成会议纪要然后用notion-knowledge-capture将其同步到 Notion 页面。关注技能更新活跃的 Skills 仓库会不断修复 Bug 和添加新功能。定期更新你的技能库。5. 常见问题与排查指南5.1 技能安装后不生效问题现象可能原因排查步骤在 Codex 中描述任务但没有触发对应技能。1. 未重启 Codex。2. 技能未正确安装到~/.codex/skills/。3.SKILL.md的description与你的描述匹配度低。4. 技能路径或权限问题。1.重启 Codex终端会话。2. 运行ls -la ~/.codex/skills/skill-name/SKILL.md确认文件存在。3. 查看description字段head -n 10 ~/.codex/skills/skill-name/SKILL.md。4. 尝试在请求中直接提及技能名称如“请使用xxx技能做...”。5.2 技能执行出错或卡住问题现象可能原因排查步骤Codex 开始执行技能但中途报错或没有输出结果。1. 技能依赖的外部工具未安装如gh,git,jq。2. 技能需要的 API 密钥或配置未设置如 Composio 连接。3. 技能脚本本身有 Bug 或与当前环境不兼容。1. 仔细阅读 Codex 的错误输出它通常会指出缺失的命令。2. 检查技能文档如果有或SKILL.md内部看是否有前置依赖说明。3. 对于需要认证的技能如linear确保已通过composio add tool完成配置。4. 到该技能的 GitHub 仓库页面查看 Issues或尝试简化你的请求。5.3 技能冲突或行为不符合预期问题现象可能原因解决思路安装了多个功能相似的技能Codex 可能调用了错误的那个。多个技能的description字段有重叠Codex 的匹配机制选择了非最优项。1. 在请求时明确指定技能名称。2. 编辑技能的description字段使其更独特、具体减少重叠。3. 暂时禁用不常用的那个技能移出目录。5.4 性能与上下文长度问题问题现象可能原因解决思路安装了非常多技能后Codex 启动变慢或会话中响应变迟钝。Codex 在启动时需要加载所有技能的元数据。技能过多会增加初始负载。1.精简技能只安装你真正高频使用的技能。2.分类管理可以创建不同的技能配置目录按项目或场景切换。3. 关注技能的更新社区可能会优化元数据的大小。6. 总结让 Codex 成为你的专属智能工作流引擎Codex 本身是一个强大的基础模型但 Skills 才是将其能力与你的具体工作流深度绑定的关键。通过安装和熟练使用上述十大 Skills你可以将 Codex 从一个被动的问答机器转变为一个主动的、能够执行复杂任务的工作流引擎。入门建议不要试图一次性安装所有技能。先从最痛点开始开发者优先安装pr-review-ci-fix,sentry-triage,codebase-migrate。团队协作者优先安装meeting-notes-and-actions,linear,connect。内容/数据工作者优先安装email-draft-polish,spreadsheet-formula-helper,paperjsx。在使用的过程中你会逐渐形成自己的“技能组合”。当你发现某个重复性任务没有现成技能时就是尝试创建自定义 Skill 的最佳时机。这正是 Codex 生态的魅力所在——它不仅提供工具更鼓励你构建适合自己的工具。 30款热门AI模型一站整合DeepSeek/GLM/Qwen 随心用限时 5 折。 点击领海量免费额度