# Codex 技能规范摘要

> 本文件摘要整理 OpenAI Codex 技能的核心规范，供快速参考。完整规范请参阅 OpenAI 官方文档。

## 技能目录结构

```
<skill-name>/
├── skill.json      # 技能元信息（必填）
├── prompt.md       # 技能指令定义（必填）
├── tools/          # 函数定义 / 工具配置（可选）
├── tests/          # 验证用例（可选）
└── CHANGELOG.md    # 版本变更记录（推荐）
```

## skill.json 字段

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `name` | string | 是 | 技能名称 |
| `version` | string | 是 | 语义化版本号 |
| `description` | string | 是 | 技能功能描述 |
| `functions` | array | 否 | 依赖的函数定义列表 |
| `tools` | array | 否 | 依赖的工具列表 |
| `tags` | array | 否 | 标签 |

## prompt.md 格式

Codex 的技能指令定义：

- 使用 Markdown 格式编写
- 描述技能的触发条件和执行逻辑
- 可指定函数调用的时机和参数
- 建议包含使用示例

## 函数定义（Function Calling）

Codex 使用 OpenAI 的函数调用格式：

- 函数以 JSON Schema 定义
- 包含 `name`、`description`、`parameters` 字段
- 支持 `function_call` 指定调用方式
- 函数定义可放在 `tools/` 目录

## 参考链接

- [OpenAI Function Calling 文档](https://platform.openai.com/docs/guides/function-calling)
- `examples/` 目录中的参考实现