Django-patterns Skill 是 Everything Claude Code 针对 Django 开发的生产级架构与模式库，系统覆盖项目结构分层、Django REST Framework API 设计、ORM 最佳实践、缓存策略、信号与中间件实现等关键环节。通过激活该 Skill，AI 编程助手能自动输出高可维护、可扩展、易于协作的 Django 代码与配置，极大提升团队开发效率，避免常见的性能与结构性隐患。适合从初学者到资深工程师在实际项目中一键应用。

Everything Claude Code Django Patterns Skill：Django 架构、DRF、ORM 最佳实践与生产级 Django 应用

Django-patterns Skill 是 Everything Claude Code 针对 Django 项目开发的核心生产力组件，专为 Claude Code、Codex、Cursor 等 AI 编程助手设计。它内置了经过 10 个月生产实战沉淀的 Django 架构模式、DRF API 设计、ORM 优化、缓存、信号、Middleware 及性能调优方案。无论你是初次接触 Django，还是希望深度定制 AI 生成的 Django 代码，都可以通过本 Skill 快速获得工程级别的项目结构与最佳实践。

1. 解决什么问题？不用 django-patterns Skill 时的困境

在没有 django-patterns Skill 的情况下，AI 编程助手往往会：

• 生成“单文件”或“平铺式” Django 项目，结构混乱，难以维护和扩展；
• 忽略开发/生产/测试环境的配置分离，导致安全和部署隐患；
• ORM 层缺乏索引、约束、QuerySet 优化，易出现 N+1 查询、性能瓶颈；
• DRF API 只做最基础的 CRUD，缺少分层、权限、过滤、序列化校验等工程细节；
• 忽略缓存、信号、Middleware 等生产必备机制，后期补齐成本高；
• 缺乏 Service Layer，业务逻辑混杂在 ViewSet/Model，难以测试和复用。

而 django-patterns Skill 能自动输出分层清晰、可扩展、易测试的 Django 代码和配置，极大提升 AI 生成代码的工程价值。

2. 何时激活 django-patterns Skill？

• 新建 Django 项目或重构现有项目时
• 需要设计 Django REST Framework API（如移动端/前端接口）
• 优化 Django ORM 查询、数据结构与性能时
• 引入缓存、信号、Middleware 提升系统健壮性时
• 需要标准化项目结构、便于团队协作和持续集成时

通常在 Claude Code 的 Agent 检测到 Django 相关代码、需求或 repo 时，会自动激活本 Skill。你也可以在 快速上手指南 配置中手动指定。

3. 使用流程（Step by Step）

Step 1：初始化项目结构

激活 django-patterns Skill 后，AI 会建议采用如下分层结构：

myproject/
├── config/
│   ├── settings/
│   │   ├── base.py
│   │   ├── development.py
│   │   ├── production.py
│   │   └── test.py
│   ├── urls.py
│   ├── wsgi.py
│   └── asgi.py
├── manage.py
└── apps/
    ├── users/
    │   ├── models.py
    │   ├── views.py
    │   ├── serializers.py
    │   ├── permissions.py
    │   ├── filters.py
    │   ├── services.py
    │   └── tests/
    └── products/
        └── ...

亮点：

• 配置分离（dev/prod/test），支持多环境部署
• 每个 app 独立分层，便于复用与解耦

Step 2：配置分环境 settings

Skill 会自动生成 base、development、production 等 settings 文件，实现环境变量管理和安全加固。例如：

# config/settings/base.py
INSTALLED_APPS = [
    'django.contrib.admin',
    # ...
    'rest_framework',
    'apps.users',
    'apps.products',
]
MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    # ...
]
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        # ...
    }
}

开发环境自动启用 debug_toolbar，生产环境强制开启安全项（如 SECURE_SSL_REDIRECT、HSTS、日志分级等）。

Step 3：模型与 ORM 最佳实践

Skill 会指导你：

• 自定义 User 模型（如 email 登录、扩展字段）
• 为 Product、Category 等模型加唯一约束、索引、CheckConstraint
• 使用自定义 QuerySet/Manager，封装常用查询逻辑

示例：

class ProductQuerySet(models.QuerySet):
    def active(self):
        return self.filter(is_active=True)
    def with_category(self):
        return self.select_related('category')

class Product(models.Model):
    # ...
    objects = ProductQuerySet.as_manager()

效果：

• 避免 N+1 查询
• 查询逻辑复用、可测试

Step 4：DRF API 分层与序列化

Skill 输出的 ViewSet、Serializer 结构如下：

class ProductSerializer(serializers.ModelSerializer):
    category_name = serializers.CharField(source='category.name', read_only=True)
    discount_price = serializers.SerializerMethodField()
    # ...

    def get_discount_price(self, obj):
        if hasattr(obj, 'discount'):
            return obj.price * (1 - obj.discount.percent / 100)
        return obj.price

class ProductViewSet(viewsets.ModelViewSet):
    queryset = Product.objects.select_related('category')
    permission_classes = [IsAuthenticated, IsOwnerOrReadOnly]
    filterset_class = ProductFilter
    search_fields = ['name', 'description']

    @action(detail=False, methods=['get'])
    def featured(self, request):
        featured = self.queryset.filter(is_featured=True)[:10]
        serializer = self.get_serializer(featured, many=True)
        return Response(serializer.data)

亮点：

• 支持自定义 action、批量操作、权限控制
• 序列化校验与业务解耦

Step 5：引入 Service Layer

业务逻辑统一收敛到 services.py，ViewSet 只负责请求分发：

class OrderService:
    @staticmethod
    @transaction.atomic
    def create_order(user, cart):
        # 创建订单、清空购物车
        pass

优势：

• 业务逻辑可测试、易复用
• 代码职责单一

Step 6：缓存、信号、Middleware 与性能优化

Skill 会自动生成：

• 视图级缓存、模板片段缓存、低层缓存（cache.get/set）
• 用户注册自动创建 Profile 的信号
• 活跃用户统计、请求日志等中间件
• select_related/prefetch_related、bulk 操作、数据库索引等性能优化建议

示例：

@method_decorator(cache_page(60 * 15), name='dispatch')
class ProductListView(generic.ListView):
    # ...

Step 7：与其他 Skill/Agent 协作

• 可结合 django-security Skill 强化安全配置
• 与 django-tdd Skill 配合，自动生成 pytest/factory_boy 测试
• 通过 Verification Loop Skill 实现发布前自动验证
• 推荐与 Python Reviewer Agent、Code Reviewer Agent 联合，保障代码质量

4. 输出示例

当你要求“生成一个支持多环境、带用户注册、商品管理、订单业务的 Django 项目”，AI 会输出：

• 完整分层目录结构（config/settings、apps/users、apps/products、apps/orders）
• 各 app 下 models、serializers、views、services、tests 等文件
• 带索引、约束的 ORM 模型
• 高级 DRF ViewSet（自定义 action、过滤、权限、分页）
• Service Layer 业务实现
• 缓存、信号、Middleware 代码
• 性能优化建议与代码

5. 常见配套 Agent 与 Skill 协作关系

• 常见搭配 Agent：Python Reviewer、Code Reviewer、Security Reviewer、TDD Guide
• Skill 协作：django-security、django-tdd、verification-loop、python-patterns、backend-patterns

FAQ

Q: django-patterns Skill 会覆盖已有项目结构吗？
A: 不会强制覆盖，AI 会检测现有结构，仅在新建/重构时建议最佳实践，保留自定义部分。

Q: 如何与 django-tdd Skill 联用？
A: 激活 django-patterns 后，再启用 django-tdd Skill，AI 会自动生成 pytest/factory_boy 测试用例并补全测试覆盖率。

Q: 支持哪些数据库和部署环境？
A: 默认输出 PostgreSQL 配置，支持 MySQL、SQLite 等主流数据库，生产环境建议结合 Docker、Gunicorn、Nginx 部署。

---