plinth
一站式Python项目脚手架与开发环境管理工具集
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:plinth。 它的用途是:一站式Python项目脚手架与开发环境管理工具集 详细介绍见:https://321skill.com/skills/plinth-pborenstein/ 请根据该页面的说明完成安装。
使用示例
‘/plinth:python-project-init’,它会引导你输入项目名称、描述等信息,然后自动生成一个包含 Click CLI、文档、测试和依赖管理的完整 Python 项目目录。之后,你可以说‘/plinth:fastapi-sweetener’,为这个项目添加一个作为 CLI 子命令运行的 FastAPI 服务器。
介绍
Plinth 是一个专为 Claude Code 设计的插件,旨在解决 Python 开发者从零开始搭建项目、集成现代开发工具以及管理服务部署时的繁琐配置问题。它提供了一套完整的技能集合,自动化处理项目初始化、API服务集成、系统服务部署和版本发布等重复性工作。
使用时,开发者只需通过简单的斜杠命令(如 /plinth:python-project-init)即可启动交互式向导。插件会引导用户输入项目信息,随后自动生成包含 Click CLI、文档结构、依赖管理和测试框架的完整项目目录。对于已有项目,可以随时添加 FastAPI 服务器或 macOS 启动服务。
该插件非常适合希望快速启动新项目、规范项目结构或需要将 Python 应用部署为系统服务的开发者。它特别适合个人开发者、小团队或需要频繁创建原型和工具的工程师,能显著减少重复劳动。
建议在开始新项目时优先使用 python-project-init 建立基础框架,待核心 CLI 功能开发完成后,再根据需要添加 fastapi-sweetener。对于在 macOS 上部署长期运行的服务,macos-launchd-service 能提供可靠的后台运行和日志管理能力。注意,部分技能(如会话跟踪)已迁移至 handoff 插件,需配合使用。
核心特点
与单一功能的脚手架工具不同,Plinth 提供了从项目创建(Click CLI)、功能增强(FastAPI)、到生产部署(macOS launchd)和发布管理(语义化版本)的完整生命周期工具链,且深度集成 uv 和现代 Python 工具生态。其 `fastapi-sweetener` 技能能智能识别并改造现有 Click 项目,无缝添加服务器子命令,而非创建独立应用。
注意事项
主要面向 Python 和 macOS 环境,Windows 或 Linux 的系统服务管理需要额外适配;对于非 Click 框架的现有项目,部分自动化改造可能受限。
常见问题
Plinth 能用来创建非 Python 项目吗?
不能,Plinth 目前专门针对 Python 项目生态,集成了 uv、Click、FastAPI 等 Python 工具链。
如何在已有的非 Plinth 创建的项目中使用 fastapi-sweetener?
该技能主要针对由 `python-project-init` 创建的项目结构进行优化,对于其他结构的项目,可能无法完全自动适配,需要手动调整。