modern-python skill 是什麼、怎麼安裝使用：Trail of Bits 的現代 Python 工具鏈 Skill（uv、ruff、ty）

本文根據 trailofbits/skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。所在倉庫 trailofbits/skills 在 GitHub 約 7462 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

讓智能體新建一個 Python 項目，它多半還在用 requirements.txt 加 pip，格式化用 black，類型檢查用 mypy——能用，但已經不是現在的主流做法。modern-python 把工具鏈換成新一代。description：用現代工具（uv、ruff、ty）配置 Python 項目；在創建項目、編寫獨立腳本，或從 pip、Poetry、mypy、black 遷移時使用。技能說明它基於 Trail of Bits 自己的項目模板 cookiecutter-python。

適用場景列得很具體：新建項目或包、配置 pyproject.toml、配置開發工具（檢查、格式化、測試）、寫帶外部依賴的腳本、從舊工具遷移。同時有一節「什麼時候不用」，以及一棵幫你選路徑的決策樹。

主體內容：

• 工具總覽與安全工具；
• 最小項目的快速開始，和完整項目的四步搭建（目錄結構、pyproject.toml、安裝依賴、Makefile）；
• 遷移指南：從 requirements.txt + pip、從 setup.py、從 flake8 + black + isort、從 mypy / pyright 各怎麼遷；
• uv 命令速查、臨時依賴的 --with 用法、依賴分組；
• 最佳實踐清單。

怎麼安裝

modern-python 在 trailofbits/skills 裏屬於 modern-python 插件。Claude Code 先登記市場，再在選單裏選擇要裝的插件（命令來自倉庫 README）：

text
/plugin marketplace add trailofbits/skills
/plugin menu

Codex 用 codex plugin marketplace add trailofbits/skills，再執行 codex plugin add modern-python@trailofbits。

倉庫整體介紹和其他安裝方式，詳見本站《trailofbits/skills 是什麼、怎麼安裝：Trail of Bits 的代碼安全審計 Skills（靜態分析、差異評審、供應鏈檢查）》。

怎麼用

• 「新建一個命令行工具項目，用 uv 管理，配好 ruff 和測試」。
• 「把這個用 Poetry 的老項目遷到 uv，保留依賴版本」。
• 「寫一個帶依賴聲明的單文件腳本，能直接用 uv 運行」。

目錄裏有九份參考（pyproject 配置、ruff 配置、測試、PEP 723 腳本、遷移清單、安全設定等）和兩個模板文件。

適合誰 / 侷限

適合新開 Python 項目的開發者，以及想把團隊工具鏈統一到新一代工具的人。這是一套有明確取捨的方案，團隊已有成熟且運轉良好的工具鏈時不必為換而換；其中的類型檢查器 ty 比較新，成熟度要自己評估。

注意事項

• 許可：CC BY-SA 4.0，改編後須以相同方式共享。
• 會執行命令：安裝 uv、創建虛擬環境、改寫配置文件；遷移前先提交當前狀態。
• 雖然出自安全公司，這個技能本身是工程規範類，不涉及漏洞分析。