SuperAPI AI 工具集

codex-docs

编程与开发

查看项目

更新于 10-16 00:23

技能介绍

用途:这是一个面向 OpenAI Codex 产品与配置问题的本地文档镜像技能,适合查询 CLI 行为、codex.toml、斜杠命令、Codex hooks、skills、MCP、子代理、AGENTS.md、提示词、沙箱、云环境、模型、定价、安全、迁移及用例配方。若问题涉及 Claude Code hooks、Cursor、通用 OpenAI API、ChatGPT、GPT 模型或其他非 Codex 产品,则不适用。

主要能力:清理后的 Markdown 存放在 references/,自动生成的主题列表在 references/INDEX.md,带上游 URL 的逐文件清单在 references/docs_manifest.json。镜像由上游 CI 每 3 小时刷新,失败时不会提交冻结内容。

使用方式:若用户给出主题,先规范化为 slug:转小写、去掉开头的 /docs/ 或 /codex/、去掉首尾斜杠,嵌套段用 __ 连接(如 cli features 变为 cli__features)。若 references/<slug>.md 存在,直接读取该文件,不要先 grep 整个 references/ 树。若无精确匹配,读取 references/INDEX.md 选最接近主题;仍不明确则列出候选并询问。若未给主题,读取 INDEX.md 并展示可用主题。回答时先给出基于所读文件的直接答案,逐字引用命令或配置键等短片段,最后以 Source: <上游 URL> 结尾,URL 取自文件 frontmatter 的 original_url 或 docs_manifest.json。

限制与回退:若本地内容过时、与用户说法矛盾或为空,可建议运行 npx skills update codex-docs;检查 docs_manifest.json 中该文件条目,status 为 stale 表示上次运行无法访问上游;通过 original_url 交叉核对规范 URL 并作为后续来源;若某页 MDX 清理失败,未修改的源保存在 references/_raw/<slug>.md,可作回退读取。