用途:为 Django 项目提供一套有明确约定的开发规范与脚手架,覆盖项目初始化、模型组织、表单、配置和 Docker 部署结构,目标是让代码保持一致且可直接用于生产。
主要能力:约定一个文件只放一个模型或表单;统一命名前缀(Base* 抽象基类、Virtual* 仅内存、Proxy* 代理模型);所有模型使用 UUID 主键、继承 created_at/updated_at 时间戳、默认软删除(deleted_at);使用 Dynaconf 管理配置而非普通 settings.py;使用 uv 与 pyproject.toml 管理依赖并按 dev、test 分组;规定类成员顺序(Meta 最前,其次字段、管理器、属性、私有/魔术方法、公开方法);Docker 相关文件统一放在 /docker 目录。
使用方式:用 uv init 初始化项目,按组添加依赖,例如 uv add django dynaconf django-unfold django-ninja,uv add --group dev ruff mypy django-stubs,uv add --group test pytest pytest-django factory-boy pytest-cov。模型放在 apps/<app>/models/ 包内,每个模型单独文件,并在 models/init.py 中重新导出;管理器放在 managers/ 包;表单放在 forms/ 包。配置使用 Dynaconf,通过 settings_files 加载 settings.toml 与 .secrets.toml,并用 DJANGO_ENV 切换环境。Docker 使用 /docker 下的 Dockerfile 与 docker-compose.yml,镜像基于 python:3.12-slim,通过 uv sync --frozen 安装依赖,用 gunicorn 启动。
适用场景:需要统一团队 Django 代码风格、希望默认采用 UUID、软删除、Dynaconf 与 uv 的新项目或重构项目。
限制:资料未提供该技能的具体安装命令、收费方式、平台支持范围与效果数据;部分细节(如完整 Dynaconf 配置、表单验证、测试写法)需参考其 references 文件,本文未展开。