python-packaging
一键创建Python包并发布到PyPI
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：python-packaging。 它的用途是：一键创建Python包并发布到PyPI 完整的 Skill 内容见：https://321skill.com/skills/python-packaging-x-6/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我创建一个名为`data-validator`的Python命令行工具，使用pyproject.toml配置，定义entry points让用户可以通过`data-validate`命令直接调用，并发布到PyPI'，它会自动生成项目目录结构、pyproject.toml（含console_scripts）、入口函数代码、测试用例，然后指导你运行`python-packaging build`和`python-packaging publish`完成发布。
介绍
解决什么问题
创建Python包并发布到PyPI是许多开发者的刚需，但手动配置pyproject.toml、entry points、setup.cfg等文件容易出错，且流程繁琐。本Skill提供了一套标准化的模板和自动化脚本，让你只需定义包名、版本和入口函数，即可快速生成符合现代Python打包规范的完整项目结构，并一键构建、上传至PyPI。
怎么用
安装后，在终端中运行python-packaging init my-package，它会交互式询问包名、作者、依赖等信息，自动生成pyproject.toml、README.md、LICENSE、src目录和测试框架。配置好entry points后，运行python-packaging build生成wheel和sdist，再运行python-packaging publish即可发布到PyPI。整个过程无需手动编辑任何配置，所有文件都遵循PEP 621和PyPA推荐的最佳实践。
适合谁
- 后端开发者：需要快速将内部工具或库打包成可分发Python包，供团队或社区使用。
- 全栈开发者：在构建CLI工具或Web服务时，希望将Python代码模块化并发布到PyPI，方便多项目复用。
- 智能体开发者：经常编写Python脚本和工具，需要标准化的打包流程来管理版本和依赖。
使用建议或注意事项
建议先通过python-packaging init创建示例项目并测试本地安装（pip install -e .），确认功能正常后再发布。发布前请确保已在PyPI注册账号并配置API token。如果项目包含C扩展或需要特殊构建工具，请手动扩展pyproject.toml的build-system部分。
核心特点
相比手动配置setuptools或cookiecutter模板，本Skill内置了entry points的典型使用场景（如console_scripts）和pyproject.toml的完整注释，并提供了构建-发布的一键式命令，减少重复劳动和配置错误。
注意事项
不适用于需要自定义构建系统（如Meson/Ninja）或包含原生C/C++扩展的复杂项目。
常见问题
如何配置命令行入口点（entry points）？
在`pyproject.tool.python-packaging.entry_points`中定义，例如`console_scripts = { my-cli = 'my_package.main:run' }`，初始化时也会引导你填写。
发布到PyPI后如何更新版本？
修改包版本号（在pyproject.toml中），然后重新运行`python-packaging build && python-packaging publish`即可。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/python-packaging-x-6/raw/index.md 读取 python-packaging 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/python-packaging-x-6/raw/index.md（查看排版版本）