AGENTS.md、Skills、MCP 有什么区别？Codex 项目配置怎么分工
AGENTS.md 保存项目约定，Skills 提供一类任务的工作方法，MCP 连接外部工具和数据。项目里可以同时使用三者：Codex 先了解仓库怎样运行，按合适的方法完成任务，需要操作 Blender 或其他服务时再调用已连接工具。装好 skill，并不会自动装好对应软件或完成账号授权。
这个区别在已有项目里尤其有用。Agent 不知道测试命令，应该补项目说明；总在没有复现的情况下改代码，可以补调试方法；工具列表里没有 Blender，就要检查软件和连接。
AGENTS.md 写稳定、具体的项目约定
适合放进 AGENTS.md 的内容包括启动入口、相关测试、目录职责、代码风格和发布边界。命令应来自仓库实际脚本，保持短而准确。
修改前检查当前分支和未提交变更。
界面沿用现有组件，业务数据从现有接口读取。
启动与测试命令见 README 的本地开发部分。
本次修改完成后检查对应用户流程。
生产发布需要单独授权。
Codex 会按约定查找项目指引，较深目录可以提供更具体的规则。检查“为什么没按说明做”时，应先确认实际工作目录、文件名称和适用范围。OpenAI AGENTS.md 文档
详细部署手册不必全部塞进去，留下清楚入口即可。一次性文案修改也留在当前任务里，避免下次修代码仍被旧任务干扰。
Skills 保存能重复使用的处理方法
一个 skill 通常围绕某类任务组织说明，并可以附脚本或参考材料。例如复现问题、定位根因、设计验证、整理审查意见，这些方法可以跨仓库复用。OpenAI Skills 文档
Matt Pocock 的技能仓库包含需求追问、调试和 TDD 等方向。它们来自作者的工作方法，不是 OpenAI 官方配置。可以先挑当前最需要的一项，读清步骤，再在熟悉的小任务中观察是否有帮助。mattpocock/skills
例如“订单页点筛选后没变化”，先让调试流程确认操作、预期、请求和状态变化。行为确认后，再补能约束正确结果的测试。没必要每个小改动都运行整套流程；任务只有改一句文字时，直接修改并检查更合适。
MCP 提供实际可调用的工具
MCP 是连接 AI 应用与外部系统的协议。服务端可以提供工具和资源，客户端负责连接和调用。能调用哪些操作，取决于已配置的服务及其权限。MCP 官方介绍
以 Blender MCP 为例，作者项目包含 Blender 插件和 MCP 服务端。连接成功后，Agent 才能检查场景、修改对象或材质；一份讲 Blender 的 skill 不能替代这条连接。Blender MCP 项目
排查时先让 Agent 列出可用工具，再读一次场景。如果读取失败，就检查客户端配置、Blender 中的插件和服务状态。先验证最小操作，可以避免写完一长串建模要求才发现没有连上软件。
遇到问题时按这张表补齐
| 当前现象 | 先检查什么 | 合适的处理 |
|---|---|---|
| 每次都问怎样启动项目 | 项目指引是否存在且适用 | 在现有文档补入口 |
| 修 Bug 经常改错方向 | 复现和诊断步骤是否完整 | 采用调试 skill |
| 声称会操作但没有工具 | MCP 是否连接、权限是否有效 | 先做只读连接验证 |
| 安装很多技能仍无改善 | 任务是否明确、技能是否适用 | 精简本次使用范围 |
插件还可能把 skills、MCP 等能力打包在一起。判断它解决什么问题时，查看实际包含内容，比只看插件名字可靠。OpenAI MCP 配置说明
同一能力可能有多个安装来源。先查看当前目录里实际生效的文件和连接，避免一份旧规则与一份新规则同时影响任务。升级时保留版本记录，出问题就能比较变化，而不用把全部配置重新安装一遍。
用一个小任务检验配置
选一个熟悉页面，让 Codex 先说明读到了哪些项目约定，再修一个空状态问题并运行已有检查。需要三维素材时，另开一个明确步骤读取 Blender 场景。分别记录“规则读到了”“方法执行了”“工具调用成功了”，就能看出缺口在哪。
具体技能选择可看Matt Pocock Skills 工作流程，三维连接可看Blender MCP 产品场景。让每个配置解决一个已经遇到的问题，后续维护也更轻松。
已经有固定 Codex 工作任务，可在 China Models 订阅服务查看已有账号的订阅与开票套餐。