别让 AI 只写代码不动手:awesome-codex-skills 让 Codex 真正替你干活

Codex Skills · 工具调用 · 工作流自动化 · 1000+ 集成 —— ComposioHQ/awesome-codex-skills 是一个面向 Codex CLI 的实用技能合集，让 AI 编码代理从”只是建议 怎么做”跨越到”直接替你执行”。

当 AI 只会”建议”而不会”执行”

用过 AI 编程助手的人都有这样的体验：跟它说”帮我发这封 邮件”，它回一段文字说”你可以这样写邮件”，然后就没下 文了。你说”在 GitHub 上创建一个 issue”，它生成一个 curl 命令让你自己跑。你说”把代码加到 Notion 知识库”， 它告诉你步骤一二三。这种”说得好听、从不动手”的状态， 是目前 AI 编码代理最大的尴尬。

问题不在模型能力——GPT-4 和 Claude 完全知道如何构造 Gmail API 请求。问题在于缺乏标准化的动作能力接口。 Codex CLI 虽有强大的代码生成能力，但默认没有任何外部服 务的上下文——它不知道你的 Gmail 已登录、不清楚你用的 Slack workspace、不了解 Notion 数据库结构。开发者只能 手动 copy-paste，或者临时写脚本。

更深的挑战来自工具调用的”最后一公里”： OAuth 认证怎么处理？ Token 过期谁去刷新？ 多种工具的依赖顺序谁来编排？ 每一步出错后的重试和降级谁来管？ 传统方案要么依赖硬编码的 MCP 工具定义，要么靠开发者手 写脚本。两套做法都导致 AI 代理面临一个尴尬区间：能力足 够理解任务，但缺少可复用的”执行模块”。

awesome-codex-skills 要解决的正是这个断层。它由 Composio 团队维护，提供模块化的技能体系——每个技能是 一个包含 SKILL.md 和可选脚本的文件夹，告诉 Codex 如何具体地执行某个任务。项目目前收录约 50 个精心 编写的手工技能，外加 832 个由 Composio 自动化框架 驱动的应用技能，覆盖开发工具、生产力协作、数据分析、 内容写作等领域。

为谁而做？如果你在用 Codex CLI 写代码，却经常发现它只 会”建议”不会”操作”；如果你每周花大量时间在 GitHub、 Slack、Notion、Gmail 之间手工搬数据；如果你希望一句话 就能发 PR、建 ticket、写 wiki——这个项目就是为你准备的。

5 分钟上手：从安装到真实动作

安装一个技能

首选方式是用技能安装器：

git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py \   --repo ComposioHQ/awesome-codex-skills \   --path meeting-notes-and-actions 

安装器将技能复制到 ~/.codex/skills/。手动安装更简单： 直接把技能文件夹复制进去就行。重启 Codex 后，新的技能 便注册完成。Codex 会在下次会话中根据你的描述自动匹配触发。

让 Codex 替你发邮件

安装 connect/ 技能后，先做一次 OAuth 连接：

curl -fsSL https://composio.dev/install | bash composio login composio link gmail 

命令走一次浏览器授权，之后连接就持久化了。接下来对 Codex 说一句：”给张三发邮件，告诉他 CI 通过了。”

Codex 会执行 composio search "send an email" 查找到 GMAIL_SEND_EMAIL 工具，然后用 composio execute 发出去。你再也不用 copy-paste 邮件的 JSON 体， Codex 直接替你完成了。

批量代码迁移

codebase-migrate/ 技能展示了复合工作流的威力。 把 200 个文件的 Jest 测试迁移到 Vitest，一句话触发：

整个过程——编码、PR、CI 验证、分批次——由 Codex 全程 代理。常见误区是试图一次迁移所有文件——技能文档明确建 议分批次、每批附带 CI 验证，这正是该技能内置的工作流。

会议纪要自动写入 Notion

安装 notion-knowledge-capture/ 后配好 Notion MCP。 会议结束后问 Codex：”把这次讨论提炼为 wiki 页面。”

技能的工作流：

该技能有一套完整的 references/ 目录，包含各类 Notion 数据库的 schema 文档。Codex 只有在需要时才读取， 不会提前膨胀上下文。

修复 GitHub Action 失败

gh-fix-ci/ 技能让你直接在终端排查 CI 失败：

gh run view --log --job=failed 

检查日志、分析失败原因、提出修复建议。如果修复需要走 PR，pr-review-ci-fix/ 可以走完整的 review 和 CI 重试循环。

技能架构与渐进式披露设计

技能是什么

每个技能是一个文件夹，核心是 SKILL.md，包含 YAML 前置元数据（name + description 字段）和正文指令。 可选资源包括：

Codex 启动时仅扫描所有技能的 name 和 description （约 100 词），据此决定触发时机。触发后才加载完整正文， 避免上下文被大量无关规则占据。

创新性：渐进式披露

最亮眼的创新在于三级加载机制：

对比传统插件系统（硬编码 API 绑定）和将大量规则塞入工具 描述的粗暴做法，这套机制兼顾了触发精度和上下文效率。技能 创造文档里有一个核心原则：“上下文窗口是公共资源”， 写每段话前都要自问它对得起 token 成本吗。为此他们建议 将变体信息（多框架、多数据库）拆分到独立参考文件， SKILL.md 只保留通用流程与文件索引。

另一个值得注意的技巧是自由度分层：

不同任务选择不同的约束等级，而不是一刀切。

Composio Connect：1000+ 应用的统一入口

connect/ 技能是整座大厦的基石。Composio CLI 提供了统一接口层：

composio search "create a github issue" composio execute GITHUB_CREATE_ISSUE \   -d '{"owner":"my-org","repo":"app","title":"Bug"}' 

composio run 甚至支持 TypeScript 脚本串联多个动作。 这套 CLI 是抽象层——Codex 不需要了解 OAuth 流程、API 版本差异、分页机制，这些都交由 Composio 代理。连接管理、 重试逻辑、token 刷新全部自动处理。

更值得关注的是 composio proxy 功能：当没有现成工具时， 直接传入已认证的 API 原始请求。这种设计承认了”枚举所有 API 不现实”的现实，给予了充分的扩展余地。

从个人效率到团队工作流的跃迁

立即落地的场景

个人开发者日常：早晨对 Codex 说”查昨天的 Sentry 错误、总结一下、在 Linear 创建 bug fix issue、在 Slack 发工程预告”，一整套动作一句话完成。告别在四个工具间手动 切换。

团队知识管理：每周五复盘后说”把这次决策和 action items 写入 Notion 项目日志”，形成可持续沉淀的知识库。 新人入职时可以直接查询历史决策日志获得上下文。

代码质量流水线：CI 失败时，gh-fix-ci/ 自动分析 日志、定位问题、提出修复。结合 sentry-triage/ （将 Sentry 栈帧映射到本地源码），从错误发现到修复提案 完全闭环。

更广阔的想象空间

SKILL.md 本质是结构化的 Markdown 指令，语言无关、 平台无关。MCP（Model Context Protocol) 与 Composio 的结合为 AI 代理提供了可扩展的工具接入范式。随着社区 贡献 mcp-builder/（构建 MCP 服务器）、paperjsx/ （本地无网络生成 Office 文档）、helium-mcp/ （实时新闻与市场数据）等专业领域技能，Codex 的边界将 从”编程助手”扩展到”全栈数字执行官”。

项目目前已获 2730 star，社区贡献活跃。技能创建指南 成熟——包含命名规范、渐进式披露模式、测试与打包流程。 你不仅是使用者，也可以创造自己的技能， 并通过 skill-share/ 与团队共享。