SuperAPI AI 工具集

python-project-developer

编程与开发

查看项目

更新于 10-15 20:30

技能介绍

用途:为 Python 命令行/图形界面工具的多项目开发提供统一规范,涵盖项目结构、CLI 参数约定、统一 Python API、OpenAI 函数调用集成以及 PyPI 发布流程。

主要能力:提供 /python-project 系列命令,包括 init、structure、api、cli、test、publish,用于初始化项目、生成结构、实现 ToolResult API 模式、添加 CLI 统一标志、生成测试套件和配置 PyPI 发布。规定单文件结构适用于 1500 行以内代码,代码超出时使用包结构且单模块不超过 800 行。包模块约定包含 init.py、core.py、cli.py、gui.py、api.py、tools.py、main.py。CLI 要求统一标志顺序 -V/--version、-v/--verbose、-o/--output、--json、-q/--quiet,退出码 0 表示成功、1 表示运行时错误、2 表示参数无效。Python API 采用 ToolResult 数据类,包含 success、data、error、metadata,并提供 to_dict()。tools.py 定义 OpenAI 函数调用 TOOLS 列表及 dispatch 分发函数。测试要求覆盖 ToolResult、API、TOOLS 模式、dispatch、CLI 标志和包导出六类测试。文档 README 需按章节顺序组织,并提供发布脚本 publish.sh 与 publish.bat。

使用方式:通过 /python-project init <name> 初始化,随后按需执行 structure、api、cli、test、publish 等命令。开发完成后运行 ruff format . && ruff check . && mypy . && pytest,再通过 python -m build 与 twine upload 发布。

适用场景:适合用规范方式搭建 Python CLI/GUI 工具、统一 API 与函数调用工具集,并发布到 PyPI。

限制:资料未提供收费、价格、平台支持范围与效果保证等信息;部分内容依赖技能命令运行环境。