4fe53197c4
- 5 agent frameworks: Qoder, Claude Code, Codex, OpenClaw, Hermes Agent - 9 lifecycle skills: lifecycle router, discover, create, test, audit, debug, update, publish, retire - 5 framework-specific meta-skills with specs and guides - OpenClaw meta-skill enriched with ClawHub official ecosystem data - Per-framework directories with skills/, versions/, publish/, docs/
1.4 KiB
1.4 KiB
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 文档
examples/目录中的参考实现