用途:为人类与智能体共同维护的 Python 项目提供一套有主见的规范基线,包含两条入口——从零搭建新项目(工作流 A),或对既有项目打分并现代化改造(工作流 B),两者共用同一套约定。核心理念是每个操作都有唯一、可发现、非交互的规范命令。
主要能力:提供脚手架脚本 scripts/new-python-project.py,支持 minimal、cli、lib、api、ml、rust 六种可叠加配置档,生成 pyproject.toml、uv.lock、.python-version、Justfile、AGENTS.md、src 布局、tests、notebooks 等结构;提供只读审计脚本 scripts/audit-python-project.py,含 26 项检查、证据与修复提示,并输出有序迁移计划。两者均为 PEP 723 的 uv run 脚本,无需预先配置环境。
使用方式:预览脚手架可运行 uv run skills/local/python-project-best-practice/scripts/new-python-project.py --dry-run --profile cli ./my-tool;审计可运行 uv run skills/local/python-project-best-practice/scripts/audit-python-project.py --format table /path/to/repo。生成后执行 uv sync、just docs-sync、just check 验证。迁移按环境、布局、依赖声明、lint、类型、测试、任务运行器与 CI、控制台脚本、日志分层、智能体契约、密钥的顺序逐级进行,每级一个 PR。
适用场景:新建 Python 项目或包、CLI 工具;配置 pyproject.toml;选择 uv 与 poetry/pip-tools;让项目可安装运行;现代化改造 setup.py、requirements.txt、poetry、conda、扁平布局的仓库;为项目添加 CLI、notebook、HTTP 接口或 Rust 扩展。
限制:不适用于单文件脚本(用 PEP 723 头即可)或无收益的纯维护仓库;CLI 表面设计、marimo 细节、FastAPI 内部、文档站点、Go/Rust 二进制发布、pre-commit 与密钥修复、TDD 纪律、MCP 服务器构建等应交给对应技能。资料未提供收费、价格与平台信息。