Modern Python Skill：为 Claude Code 和 Codex 提供版本感知的 Python 现代化建议

一个可安装的 agent 插件，包含 use-modern-python 技能。它帮助编码 agent 检测项目支持的最低 Python 版本，并在不超过该版本的前提下应用现代语言和标准库特性。

该技能由 Claude Code 和 Codex 共享。其检测脚本随技能一起打包，需要 Python 3.8 或更高版本。

注意

该技能中基于版本的指导灵感来自 JetBrains 的 Modern Go guidelines。该技能将类似的方法应用于 Python。

在 Claude Code 中安装

将此仓库添加为 marketplace，然后安装插件：

/plugin marketplace add 353solutions/modern-python
/plugin install modern-python@modern-python-guides

或者从本地检出加载插件以用于单个会话：

claude --plugin-dir ./plugins/modern-python

该技能显示为 /modern-python:use-modern-python。

在 Codex 中安装

将此仓库添加为插件 marketplace：

codex plugin marketplace add 353solutions/modern-python
codex plugin add modern-python@modern-python-guides

或者使用 codex /plugins 打开插件浏览器，选择 modern-python-guides，然后安装 Modern Python。use-modern-python 技能已打包在插件中，并在插件启用时可用；使用 $use-modern-python 调用它。

若要在不安装插件的情况下按仓库范围使用，请将 plugins/modern-python/skills/use-modern-python 复制到项目的 .agents/skills/ 目录中。

推荐的项目指令

要让 agent 在处理 Python 文件时使用该技能，请向项目的规则文件添加一条指令。

对于 Claude Code，请将以下内容添加到 CLAUDE.md：

When working with Python files, always use the `/modern-python:use-modern-python` skill.

对于 Codex，请将等效指令添加到 AGENTS.md：

When working with Python files, always use the `$use-modern-python` skill.

它的功能

该技能会检查版本声明，例如 requires-python、Poetry、setup.cfg、setup.py 和 .python-version。它将最低支持版本视为兼容性目标，然后推荐该版本可用的语言和标准库特性。它包含一个位于 skills/use-modern-python/scripts/detect_python_version.py 的检测脚本。