前言¶
新建 Python 项目时，目录结构、依赖文件、测试目录和 README 往往要反复拷贝旧仓库再改名字。手写脚手架容易漏项，和团队约定也不一致。下面介绍 SkillHub 上的 python-script-generator：在 Agent 对话里按项目类型生成带配置、依赖、测试和文档的完整结构，减少从零搭架子的时间。
这是什么¶
python-script-generator 是社区来源（community）的 Agent Skill，坐标为 @user_9f9aa44e/python-script-generator-pro，当前版本 1.0.0，由发布者 user_9f9aa44e 维护，分类为 dev-programming。
官方简介概括为：快速生成专业的 Python 脚本和应用代码；一键创建完整项目结构；支持 CLI、API、爬虫、Bot、Django 等多种项目类型；并包含项目结构、配置文件、依赖管理、测试、README 和文档。页面标签标明 requires_api_key=false，使用时不依赖额外 API Key。
SkillHub 页面：https://www.skillhub.cn/skills/user_9f9aa44e/python-script-generator-pro
API 入口：https://api.skillhub.cn/user_9f9aa44e/python-script-generator-pro
核心功能¶
以下能力均来自官方简介与 SkillHub 元数据，未在页面单独展开的细则不作延伸说明。
- 多项目类型：可按 CLI、HTTP API、爬虫、Bot、Django 等类型组织生成目标，而不是只输出单个
.py文件。 - 完整工程骨架：除源码外，强调配置文件、依赖管理（如 requirements / 项目元数据）、测试目录、README 与文档等一并纳入结构。
- 脚本与应用并重：既适合一次性脚本，也适合需要长期维护的小应用形态。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。在 SkillHub 上安装时，需让 Agent 按官方安装说明操作，或在本机用 skillhub CLI 安装到当前 Agent 的 skills 目录（装错目录 Agent 不会加载）。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
更完整的说明见：https://skillhub.cn/install/skillhub.md
2、安装本 Skill¶
SkillHub 页面给出的安装提示为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_9f9aa44e/python-script-generator-pro。
命令行方式示例（--dir 必须指向当前 Agent 的 skills 目录）：
skillhub install user_9f9aa44e/python-script-generator-pro --dir <skills 目录>
常见 Agent 的 skills 路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装到对应目录后，按你所用客户端的要求重启或刷新 Agent，使 Skill 被识别。
典型用法¶
公开页面未附带逐步复制的对话样例；结合 Skill 定位，可复现的流程如下。
- 完成上一节的安装，并确认 Agent 已加载该 Skill。
- 在对话中说明目标：项目类型（如 CLI / API / 爬虫 / Bot / Django）、主要功能、Python 版本或框架约束（若有）。
- 让 Agent 按 Skill 指引生成目录与文件；生成后在本地检查依赖文件与测试布局，再执行安装依赖与运行测试。
生成内容仍须人工审阅：业务逻辑、安全与合规（尤其爬虫、Bot、对外 API）不能默认交给脚手架一次到位。
适用场景与注意¶
适合谁
- 需要快速拉起标准 Python 仓库结构、又不想每次从空目录开始的开发者。
- 在 Cursor、Claude Code、Codex 等支持 Skill 的环境里，希望用同一套 Skill 统一「新项目长什么样」的团队或个人。
限制与注意
- 来源为社区 Skill，质量与更新节奏取决于发布者；重大生产项目建议在生成结果上再做代码评审与 CI 约束。
- SkillHub 元数据显示评分为 100000、下载 2422（统计以页面抓取为准，会随时间变化）；安装 计数在抓取时为 0，仅作参考，不代表不可用。
- 未要求 API Key，但生成代码若调用第三方服务，仍需自行配置密钥与环境变量。
- 不同项目类型（Django 与轻量 CLI 等）的默认结构差异大，类型选错会导致后续大改，开头把类型和需求说清楚更省事。
结尾¶
python-script-generator 把「Python 新项目该有哪些文件夹和配套文件」固化成 Skill，在 Agent 里按类型一键展开骨架，适合作为脚手架起点，而不是替代设计与审查。
官方 SkillHub 页面：https://www.skillhub.cn/skills/user_9f9aa44e/python-script-generator-pro
