SuperAPI AI 工具集

doc-generator

编程与开发

查看项目

更新于 10-15 20:08

技能介绍

用途:根据 Python 源码生成 Markdown 文档,适合编写 API 参考、README 使用示例,或把 docstring 与类型签名整理成可读格式。当用户提出“document this code”“generate docs”,或提到 documentation、docstrings、API reference 时使用。

输入:单个 Python 文件路径、目录路径(递归处理 .py 文件),或指定文件列表。

主要能力:输出标准 Markdown,包含模块名与模块 docstring 简介、Classes(类 docstring、方法签名与简述)、Functions(函数签名、参数、返回值说明)、Usage Examples(从 docstring 示例提取或生成基础用法)。分析方式为用 AST 或 inspect 解析文件,提取模块级 docstring、类定义与 docstring、带类型提示的函数/方法签名、docstring 内容(支持 Google、NumPy、Sphinx 格式),按模块→类→方法→函数分层组织,并生成格式一致的 Markdown。

质量约定:在有意义时保留原 docstring 格式;签名中突出类型提示;相关项分组;大型模块加目录;默认跳过下划线开头的私有成员,除非明确要求;缺失 docstring 时标注“No description provided”。

工具与依赖:优先使用标准库 ast、inspect、pathlib,基础文档生成无需外部依赖。

错误处理:跳过有语法错误的文件并记录警告;优雅处理缺失类型提示;未找到 docstring 时警告但继续处理;处理前校验文件路径存在。

限制:资料未提供安装命令、收费方式、支持平台及具体效果数据。