Codex：创建 Skill 与文档 MCP

项目级原创Skill、官方只读Docs MCP及配置作用范围和移除方法。

这篇给 Codex 添加一个检查 README 的 Skill，再接入官方文档 MCP。准备 Windows PowerShell，并先完成Codex 接入。

1. 创建 Skill

在项目的 .agents/skills 中创建文件夹，并添加 SKILL.md。文件开头要写名称和描述：

$practice = Join-Path $env:USERPROFILE ("codex-extensions-" + (Get-Date -Format "yyyyMMdd-HHmmss"))
New-Item -ItemType Directory -Path $practice | Out-Null
Set-Location -LiteralPath $practice
New-Item -ItemType Directory -Path ".agents\skills\readme-check" | Out-Null
notepad ".agents\skills\readme-check\SKILL.md"

保存下面的内容，再给练习目录添加一份 README：

---
name: readme-check
description: 用户要检查练习README计划时使用，只读检查，不运行或修改代码。
---

读取当前项目README.md，不读取其他目录。
列出三项已有计划，再问一条需要澄清的问题。
文件不存在就报告缺失，不创建文件、不联网。

macOS / Linux 用编辑器创建同样的 .agents/skills/readme-check/SKILL.md。Codex 会按启动目录和仓库根查找 Skill，因此后面要从练习目录启动。

2. 调用 Skill

从练习目录启动codex，用/skills看列表，再显式调用：

$readme-check 请检查本目录README。

回答中应有三项计划和一个问题，README 应保持原样。Skill 没出现时，检查路径、扩展名和 YAML，然后重启会话。Skill 的只读说明不会改变沙箱权限，保留原来的审批设置即可。

3. 添加 MCP

OpenAI Docs MCP通过网络提供只读文档搜索和读取，无需挂载本地文件夹。服务连接需要网络，Codex 所用模型处理请求时仍可能计费。

这条 CLI 命令写入用户级配置，会影响其他项目。先备份配置，检查列表中没有同名服务后再添加；练习结束可禁用或移除。

$config = Join-Path $env:USERPROFILE ".codex\config.toml"
if (Test-Path -LiteralPath $config) {
  Copy-Item -LiteralPath $config -Destination ($config + ".before-docs-" + (Get-Date -Format "yyyyMMdd-HHmmss"))
}
codex mcp list
# 确认没有同名条目后才添加：
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
codex mcp list

新开练习会话问：“用openaiDeveloperDocs搜索Codex Skill格式，给官方来源，不访问我电脑上的其他项目。”

回答中应有官方文档链接。展开工具调用，查看服务返回的页面。如果列表已有条目但调用失败，检查网络、服务状态及当前模型的工具协议兼容性，保留具体错误信息。

4. 卸载

临时停用时，退出会话，在用户配置中找到已有的同名表，将 enabled 设为 false：

[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"
enabled = false

重启确认工具不再可用。永久移除时仅删本课新增的完整同名表，不删其他MCP配置，再运行codex mcp list核对。备份可能含凭据，不上传。

Skill临时停用可把本次文件夹移出.agents/skills并重启。官方另支持[[skills.config]]按路径禁用；初学者先采用移出练习目录的方法。永久卸载只删除本次练习Skill目录，不清空个人.agents或.codex。

常见问题

没有工具结果：检查服务连接和当前模型是否支持工具调用。
Skill 没出现：检查启动目录、文件名和 YAML。
配置解析失败：检查是否重复创建了同名 TOML 表。

继续第一项任务，比较直接提问与Skill输出是否更一致。

参考资料

资料核对：2026-09-13；命令尚未实机测试。