用途
python-project-template 用于生成标准化的 Python 项目结构，使其符合 workspace-hub 的标准。它适合在以下场景使用：启动一个新的 Python 项目、向 workspace-hub 添加新仓库、标准化一个已有项目、创建可复用模块。不适合的场景包括：项目已具备规范结构、非 Python 项目、一次性脚本（应改用 scripts/ 目录）。
主要能力
该技能会创建一个完整的 Python 项目，包含以下内容：
- pyproject.toml：现代 Python 打包配置。
- UV 环境：快速的依赖管理。
- 测试结构：带 fixtures 与覆盖率配置的 pytest。
- 源码布局：模块化的 src/ 组织方式。
- 文档：README、CLAUDE.md、.agent-os/。
- 质量工具：ruff、black、mypy 的配置。
生成的项目结构包含 pyproject.toml、README.md、CLAUDE.md、.gitignore、.python-version，以及 src/、tests/、config/、scripts/、docs/、data/、reports/ 和 .agent-os/ 等目录。
使用方式
快速开始命令：
# 创建新项目
/python-project-template my-project
# 创建指定类型
/python-project-template my-project --type library
# 创建到指定目录
/python-project-template my-project --path /path/to/projects
前置条件：Python 3.9+、已安装 UV 包管理器、父目录已初始化 Git。
若 UV 未安装，需先安装：
curl -LsSf https://astral.sh/uv/install.sh | sh
执行清单分为项目创建与创建后两步。项目创建包括：创建目录结构、生成 pyproject.toml、创建 src/ 模块结构、设置 tests/ 与 conftest.py、生成 CLAUDE.md、创建 .agent-os/ 结构、初始化 git 仓库、创建 UV 环境、安装依赖、运行初始测试。创建后包括：更新项目描述、添加项目专属依赖、配置 CI/CD（可选）、运行 repo-readiness 检查。
错误处理方面：若目录已存在，可选择更换名称、使用 --force 覆盖或使用 --update 补充缺失文件；若 UV 未安装，会提示安装命令。
适用场景
- 启动新的 Python 项目。
- 向 workspace-hub 添加新仓库。
- 标准化已有项目。
- 创建可复用模块。
示例：创建基础项目、创建库项目（--type library，附带包发布配置、Sphinx 文档、API 参考结构）、创建数据管道项目（--type pipeline，附带 data/raw/ 与 data/processed/ 目录、reports/ 输出、scripts/ 执行模板）。
限制
不适用于已有规范结构的项目、非 Python 项目以及一次性脚本。使用前必须满足 Python 3.9+、已安装 UV、父目录已初始化 Git 等前置条件。目录冲突时需要显式处理。文档中未提供关于收费、价格或平台支持范围的更多信息。
集成与相关技能
与 repo-readiness 集成：创建项目后运行 /repo-readiness，可验证 CLAUDE.md 是否存在、.agent-os/ 是否配置、测试是否通过、环境是否就绪。与 agent-os-framework 集成：运行 /agent-os-framework my-project 可添加完整的 .agent-os/ 结构、使命与路线图模板、决策日志。相关技能包括 pytest-fixture-generator、repo-readiness、agent-os-framework。
版本
1.0.0（2026-01-14）：初始发布，支持带 pyproject.toml、UV 支持、pytest 配置和 workspace-hub 合规的标准化 Python 项目生成。