第 40 卷

第 40 / 72 卷日期：2026-07-04

SKILL.md

最简单的结构是：

.agents

└── skills

└── readme-skill

└── SKILL.md

也可以放脚本、参考资料和资源文件：

.agents

└── skills

└── readme-skill

├── SKILL.md

├── scripts

├── references

└── assets

Skill 文件结构说明

文件 / 文件夹	是否必须	作用
SKILL.md	必须	写 Skill 的名称、描述和具体指令
scripts/	可选	放可执行脚本
references/	可选	放参考文档、标准、说明
assets/	可选	放模板、图片、资源文件

---

name: readme-skill

description: 当用户需要生成 README、项目说明、安装教程、启动步骤时使用。

---

你是一个 README 文档生成助手。

任务：

根据当前项目生成一份适合新手阅读的 README。

工作流程：

阅读项目结构
查看 package.json、README、入口文件
判断项目类型
生成项目介绍
写安装步骤
写启动命令
说明文件结构
补充常见问题
不确定的地方不要编造

输出格式：

使用 Markdown。

必须包含：

项目简介
功能特点
安装步骤
启动命令
文件结构
常见问题
后续优化方向

添加 Skill 后怎么使用

添加 Skill 后，有两种常见用法：

用法示例

让 Codex 自动判断帮我写一份项目 README

如果 Skill 的 description 写得清楚，Codex 会更容易自动判断什么时候该用它。

比如：

description: 当用户需要生成 README、项目说明、安装教程、启动步骤时使用。

这个描述就很清楚。

不建议写得太模糊：

description: 帮我写东西。

这样 Codex 不知道什么时候该调用它。

Skill 放在哪里更合适

放置位置	适合场景	简单来说
项目里的 .agents/skills	只给当前项目用	项目专属 Skill
用户级 Skill 目录	自己多个项目都想用	个人通用 Skill
团队 / 管理员配置	团队成员统一使用	团队共享 Skill
插件里	想打包分发给别人安装	正式能力包

MCP

只有进阶AI编程才需要了解，普通人可以直接跳过

让 Codex 连接外部工具的接口。

Codex 本身可以读代码、改代码、运行命令。

MCP 的作用是让 Codex 连接更多外部工具、数据源或服务。

什么是 MCP

概念简单来说

MCP	连接外部工具的标准接口
MCP Server	提供工具能力的服务
Tool	Codex 可以调用的具体功能

全站分卷索引 · 72 卷