前言¶
新建 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
