SuperAPI AI 工具集

python-style

编程与开发

查看项目

更新于 10-15 22:40

技能介绍

用途:在编写或修改 Python 代码时应用一套质量门规则,涵盖类型注解、文档字符串、PEP 8/Black 格式与单元测试。

主要能力:一致使用类型提示(含返回类型),新模块优先 from future import annotations;为公开模块/类/函数写简洁 Google 风格 docstring(一行摘要加 Args/Returns/Raises);遵循 PEP 8 与 Black,保持函数小而内聚;提供覆盖文档行为与类型签名的单元测试。

激活时机:编辑或创建 **/*.py,或用户要求 typing、annotations、docstrings、PEP 8、Black、refactor-for-clarity、unit tests、pytest 时。

使用方式:先做最多 0–3 个澄清问题(目标 Python 版本、测试框架、严格类型期望);动态发现仓库现有工具配置(pyproject.toml、setup.cfg、tox.ini、.ruff.toml、mypy.ini、CI);大型改动前写简短计划;增量实现注解、docstring 与测试;按顺序运行格式化/检查(black/ruff)、类型检查(mypy/pyright)、单元测试(pytest/unittest)。

限制与护栏:不重排或重构无关文件;除非明确要求,保持运行时行为不变;优先遵循仓库约定而非个人偏好;无工具时默认 Black 兼容格式与 pytest 风格测试;避免 Any,必要时说明理由;性能敏感路径避免重运行时校验。资料未提供具体安装命令、收费与平台信息。