api-documenter - API文档与开发者体验工程工具
生成 OpenAPI 规范、构建交互式开发者门户与多语言 SDK,并实现 API 文档样例的自动化测试与校验。
标签
更新于: 2026-09-19能力
典型输入
典型输出
该技能可以做什么
- 编写 OpenAPI 3.1 规范
- 构建交互式开发者门户
- 生成多语言 SDK 代码
- 编写认证与安全文档
- 自动化测试与校验文档
- 管理 API 版本与迁移
输入
- API 规范与 Schema 定义
- 代码注释与注解
- 认证配置与凭证
输出
- OpenAPI 与 AsyncAPI 规范文件
- 交互式开发者门户网站
- 生成的 SDK 与代码片段
- 迁移指南与变更日志
要求
- 兼容 OpenAPI 3.1 的工具链
- Git 版本控制系统
- CI/CD 执行环境
