Documentation
README
API Doc Generator
根据代码生成 API 文档,支持 REST API、GraphQL 及多种文档格式。
Generate API documentation from source code, supporting REST APIs, GraphQL, and various documentation formats.
When to Use
当用户请求以下操作时使用此 skill:
- 生成 API 文档 / Generate API documentation
- 创建接口文档 / Create interface documentation
- 编写 API 说明 / Write API descriptions
- 生成 OpenAPI/Swagger 规范 / Generate OpenAPI/Swagger specs
Instructions
分析步骤 / Analysis Steps
- 识别 API 类型 - REST、GraphQL、RPC 等
- 提取端点信息 - URL、方法、参数
- 分析数据结构 - 请求/响应格式
- 识别认证方式 - API Key、OAuth、JWT 等
- 生成文档 - 按照标准格式输出
文档内容 / Documentation Content
每个 API 端点应包含:
- 端点路径 - URL 和 HTTP 方法
- 描述 - 功能说明
- 参数 - 路径参数、查询参数、请求体
- 响应 - 成功和错误响应示例
- 认证 - 认证要求
输出格式 / Output Formats
This is the opening of the README. Read the full README on GitHub.