Codex openai-sdk-debugging 技能:区分响应解析与调用故障
EnglishCodex 安装步骤
- 打开 GitHub 固定提交的 `.agents/skills/openai-sdk-debugging/SKILL.md`,核对内容与使用条件。
- 在自己的项目中创建 `.agents/skills/openai-sdk-debugging/`,把核对后的文件保存为 `.agents/skills/openai-sdk-debugging/SKILL.md`。
- 在该项目根目录启动 Codex,输入 `$openai-sdk-debugging` 并选择同名技能。
中文摘要
按配置、连接、可用性和响应结构排查 Node.js SDK 问题,区分已证实原因和待检查项。
SKILL.md 中文导读
可复现示例
调用 $openai-sdk-debugging,对照下面虚构响应解析记录,定位两种返回结构的差异。
case `two-response-shapes`
Responses fixture `{output_text: "Route ready"}`
Chat Completions fixture `{choices: [{message: {content: "Route ready"}}]}`
legacy parser reads choices only工作步骤
- 确认 SDK、接口和实际失败阶段。
- 按接口检查返回形状与解析逻辑。
- 用样本复核输出,明确真实调用验证到哪一步。
验收方法
指出旧分支仅读 choices。为 Responses 读取 `output_text`,为 Chat Completions 读取 `choices[0].message.content`,两条虚构夹具都输出 `Route ready`。
GitHub 原文 · 更新日期
适用环境
使用 Node.js OpenAI SDK 的 Codex 项目。示例只提供两份虚构响应结构,可离线检查解析分支。
常见问题
返回值存在但界面显示为空,首先核对什么?
对照使用的接口与 SDK 响应结构。记录结构摘要,先用虚构响应核对解析,再验证真实调用。