我目前的方案是手动维护一个 swagger 导出的 md 文档,然后让 ai 去读取 md. 因为是多人多模块开发, 直接拉后端源码去读也不是一个便捷的方式.
想找一个比较方便的维护 api 文档的方式, 和 ai 沟通时直接让 ai 自行查询相关接口的参数返回. 想看一下各位是如何管理文档的.
我目前的方案是手动维护一个 swagger 导出的 md 文档,然后让 ai 去读取 md. 因为是多人多模块开发, 直接拉后端源码去读也不是一个便捷的方式.
想找一个比较方便的维护 api 文档的方式, 和 ai 沟通时直接让 ai 自行查询相关接口的参数返回. 想看一下各位是如何管理文档的.
1
dethan 2 days ago via Android
能拉源码就拉源码呗,现在的 ai 吃得下
|
2
AreYou0k 2 days ago
直接生成一个 json 文件, 都 ai 时代了还要啥文档啊
|
3
cvooc OP |
4
dethan 2 days ago via Android
swagger 有在线 doc.html,给 AI 这个地址也行吧
|
5
ydong 1 day ago
用 apifox 管理接口文档就行了,官方自带了 mcp 和 skill 很方便,我们目前就是这么干的
|