Codex能从源码、JSDoc、HAR文件或Postman集合自动生成OpenAPI 3.0文档：支持FastAPI自动提取路径/参数/响应，要求Pydantic字段含description；JSDoc需配置路由路径与自定义标签映射；HAR解析可推断schema但需人工校验联合类型；Postman转换保留环境变量、认证及示例。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你手头有一堆后端代码却缺一份标准接口文档时，Codex能直接从源码里抽取出路径、参数、响应结构，生成可交付的OpenAPI 3.0 YAML或Markdown文件，省去手动整理和反复核对的耗时过程。
从Python FastAPI项目自动生成openapi.yaml
打开Codex CLI终端，进入你的项目根目录。确保所有路由函数都使用了标准装饰器（如@router.get），且Pydantic模型字段已填写description参数——这是Codex识别字段语义的唯一依据，漏写会导致该字段在文档中无说明。
执行命令：codex run "根据当前目录下所有Python文件,生成符合OpenAPI 3.0规范的openapi.yaml文件,包含所有HTTP方法、路径参数、请求体结构、响应状态码及示例"。
生成的openapi.yaml会自动映射Optional[str]为nullable: true，datetime字段标注format: date-time。若某接口缺失response_model声明，Codex不会猜测返回结构，而是留空responses.200.content并插入注释提醒人工补全。
从JSDoc注释生成API Markdown文档
方法一：仅扫描路由文件
在codex.config.js中配置source: 'src/routes/**/*.js'，避免把工具函数也塞进文档里造成干扰。
方法二：启用自定义标签映射
Codex默认只识别@route、@param、@returns，如果你在JSDoc里写了@auth或@rateLimit，必须在配置中显式映射，否则这些信息将彻底丢失。
方法三：输出格式切换
只需修改output字段：填docs/api.md生成Markdown，填docs/api.html则触发内置HTML渲染器，生成带交互式路径树和响应示例的静态页面。
依托用户知识库、工作记录、项目文件、会议纪要、表格、图片、文稿及评审材料生成高质量职场汇报演示文稿。适用于试用期考核、转正述职、晋升答辩、年度总结、项目进度汇报、项目评审、方案说服、资源申请、部门规划、业务优化或管理决策类 PPT 制作；Codex 需先明确汇报目标、提取佐证材料、生成规范说明书、适配汇报时长、搭建内容大纲、设计每页幻灯片内容，最后生成附带讲稿与佐证材料核对清单的 PPTX 文件。
没有代码注释？用HAR文件反向生成文档
第一步：用Chrome浏览器打开目标系统→按F12→Network面板→勾选Preserve log→完成增删改查操作→点击右上角↓导出HAR文件。
第二步：将HAR文件拖入Codex工作区，运行指令：“解析该HAR文件，提取全部成功HTTP请求，生成OpenAPI 3.0 YAML，每个接口需包含method、path、query/body参数列表、status 200响应示例及字段类型推断”。
第三步：Codex会基于实际响应体JSON结构反向推测schema，对同字段多次出现不同值类型（比如id有时是数字有时是字符串）会标为type: ["string", "number"]，【你必须人工确认这种联合类型是否合理，否则后续SDK生成会报错】。
用Postman集合一键转OpenAPI再喂给Codex Skill
Postman导出集合时选择Collection v2.1格式，保存为user-api.postman_collection.json。
在Codex CLI中执行：codex convert --from postman --to openapi user-api.postman_collection.json -o openapi.yaml。
这一步会把Postman里的环境变量（如{{base_url}}）、认证方式（Bearer Token / API Key）、示例请求体和响应体原样转成OpenAPI的servers、securitySchemes和examples字段。
生成的openapi.yaml可直接作为Codex Skill的输入源——只要把文件路径写进SKILL.md的api_docs:字段，Codex就能在执行任务时准确调用真实接口，而不是瞎猜URL或乱拼Header。
