8 Skills、Plugins 与 MCP：把重复流程和外部工具接进 Codex

查看大图

学到这里，你已经会让 Codex 做一次任务。接下来要解决的是：如何让它越用越顺。

官方 customization 文档把几层能力讲得很清楚：AGENTS.md 管项目规则，Skills 管可复用工作流，MCP 连接外部工具，Subagents 负责把任务分给专门角色。

我会把 Skills 当成可复用流程，把 MCP 当成外部工具入口。两者不要混在一起：流程要清楚，工具权限要克制，先从只读能力开始接。

查看大图

比如“查文档、改代码、跑测试、写总结”适合做成 Skill；GitHub、浏览器、内部知识库适合通过 MCP 接入。这样扩展能力时不会把权限边界弄乱。

Skills 适合什么

Skills 适合沉淀重复流程。比如你总是让 Codex 做这些事：

查看大图

阅读《Skills、Plugins 与 MCP：把重复流程和外部工具接进 ...》前，可以先用配图确认主线；读完后再检查哪些步骤能直接操作，哪些还需要补资料。

• 检查当前 diff。
• 写 PR 描述。
• 按固定格式发布文章。
• 扫描页面可读性。
• 处理一个固定部署流程。

就可以把它写成一个 Skill。官方文档说明，一个 Skill 通常是 SKILL.md 加上可选脚本、参考资料、资产。Codex 先读取技能元数据，需要时再加载完整内容，这样不会一开始就把上下文塞爆。

一个简单 Skill 的思路

比如做一个 commit-review：

---
name: commit-review
description: Review current changes before commit. Use when the user asks whether changes are ready to commit.
---

1. Run git status.
2. Read the diff for staged and unstaged files.
3. List risks first.
4. Mention missing tests.
5. Suggest a concise commit message.

这比每次手写一大段 prompt 稳定。

Plugins 是分发单位

Skills 更像工作流作者格式，Plugins 更像安装包。官方文档里说，如果要在团队间分发可复用能力，或者把 Skills、MCP、Hooks、assets 打包，应该用 Plugin。

新手阶段不用急着做插件。先把一个 Skill 写顺，再考虑是否需要分享给团队。

MCP 是接外部工具

查看大图

MCP 适合把外部系统接进 Codex，比如文档、issue、GitHub、Figma、浏览器、Sentry、内部知识库。

官方 MCP 文档说明，Codex 支持 STDIO server 和 Streamable HTTP server，配置通常放在 config.toml。CLI 和 IDE extension 共享这套配置。

常用命令：

codex mcp --help

在交互界面里可以用：

/mcp

查看已连接的 server 状态。

先接低风险工具

我建议新手先接这几类：

• 官方文档或技术文档。
• GitHub issue/PR 只读能力。
• 浏览器检查工具。
• 设计稿只读能力。

不要第一天就把生产数据库写权限、服务器 root、支付后台接给 Codex。MCP 是能力入口，越强越要设边界。

Skills + MCP 才是实用组合

一个 Skill 定义流程，一个 MCP server 提供外部工具。比如：

查看大图

读完《Skills、Plugins 与 MCP：把重复流程和外部工具接进 Codex》后，可以先挑一个小样例走完整流程，再判断哪些步骤已经能独立完成。

查看大图

读到这里，可以把《Skills、Plugins 与 MCP：把重复流程和外部工具接进 Codex》整理成一张复盘表：先说清主线，再拿一个小任务检查结果。

“查最新框架文档 -> 修改代码 -> 跑测试 -> 总结依据”

这个组合比单独写 prompt 可靠得多。

参考资料：

• Agent Skills
• Model Context Protocol
• Codex customization