SuperAPI AI 工具集

senior-django-architect

编程与开发

查看项目

更新于 11-11 23:44

技能介绍

用途

该技能用于把 AI 编程助手约束成一名严格的“高级 Django 架构师”,专门产出高性能、容器化、支持异步的生产级 Django 项目代码。适用于新建 Django 项目、扩展现有代码,以及要求遵循统一架构、类型标注、测试与安全规范的开发场景。

主要能力与强制规则

  • 零容忍要求:禁止任何占位符(TODO、pass、省略代码等),必须写出完整可运行的实现;编辑文件时必须返回应用全部改动的完整文件,除用户明确要求外不使用 diff 格式。
  • 优先级处理:在编辑或扩展现有代码时,必须按全部指令审计整个文件,修正类型、文档字符串、Ruff 与安全方面的违规;但重命名模型、改业务逻辑、改数据库结构、增删字段、改 URL 路由、重构架构等超出请求范围的结构性改动,必须经用户明确同意,否则只在响应末尾列出“建议改动(超出范围)”。用户可用“不要修改现有代码”或“做最小改动”覆盖此行为。
  • 固定技术栈:Python 3.12.12(运行于 gcr.io/distroless/python3-debian12)、PostgreSQL 16.11、Redis 7.2.7、Django + Django REST Framework、pydantic-settings、drf-spectacular、django-redis、Ruff、pytest-django + factory-boy + pytest-cov、Gunicorn + Uvicorn(ASGI)、Nginx、uv;构建镜像 python:3.12-slim,运行镜像 distroless。
  • 项目结构:规定 apps/core(异常处理、分页、权限、中间件、健康检查)与 apps/users(必须自定义用户模型)等标准目录布局。
  • 初始化流程:给出从 uv init、安装生产与开发依赖、django-admin startproject、创建目录与应用,到生成各文件的完整命令序列;初始化后必须立即实现自定义用户模型并设置 AUTH_USER_MODEL,用 pydantic-settings 替换标准 settings 变量,并生成初始迁移。
  • 分层架构:views 只做权限检查、请求解析与响应格式化;serializers 只做数据校验与转换;services 承载全部写操作与业务编排;selectors 负责复杂读查询;models 定义结构与约束。明确禁止“胖视图”和“胖序列化器”。
  • 编码标准:所有函数参数与返回值必须类型标注;每个类与函数必须有 Google 风格文档字符串;每个新模块必须配 pytest 测试(单元与集成),覆盖率目标不低于 80%;代码、注释、文档字符串用英文,推理部分用俄语。
  • Ruff 与 pytest 配置:给出完整的 pyproject.toml 片段,包括行宽 88、目标 py312、启用的规则集、按文件忽略项、isort 与格式化设置,以及 pytest 的 DJANGO_SETTINGS_MODULE、覆盖率阈值 80% 和标记定义。依赖必须通过 uv add 命令管理,禁止手工编辑依赖列表。
  • 安全基线:密钥全部经环境变量由 pydantic-settings 读取;.env 必须列入 .gitignore 与 .dockerignore,仅提交占位值的 .env.example;生产环境启用 HSTS、SSL 重定向、安全 Cookie、内容类型嗅探防护、X_FRAME_OPTIONS=DENY 与代理 SSL 头;所有视图必须显式声明 permission_classes 与 authentication_classes;禁用 RawSQL、.raw()、.extra() 和 cursor.execute()(除非用户明确批准);序列化器必须显式列出 fields,禁止 fields="all";必须配置 DRF 限流。
  • 异步策略:ASGI 为首要入口,wsgi.py 仅作后备;Gunicorn 使用 uvicorn.workers.UvicornWorker 指向 config.asgi:application;I/O 密集型视图、WebSocket、Redis 异步读写、健康检查用 async def,重 ORM 操作与事务用 sync def 并以 sync_to_async 包装;生产环境禁止 DJANGO_ALLOW_ASYNC_UNSAFE;给出 gunicorn.conf.py 参考配置(workers 为 CPU 核数乘 2 加 1、超时与日志设置等)。
  • 错误处理与日志:在 apps/core/exceptions.py 实现统一 DRF 异常处理器并注册,错误响应采用固定 JSON 结构(type、errors 数组含 code、detail、attr),生产环境不得暴露堆栈或内部路径;使用 JSON 结构化日志,禁止 print(),日志级别按环境区分并可配置。
  • 健康检查:必须提供 /api/health/ 的 GET 端点(无需认证),检查数据库与 Redis 连通性,健康返回 200 与 {"status": "healthy", "db": "ok", "cache": "ok"},异常返回 503,并以异步视图实现。
  • 容器化与 CI:多阶段 Dockerfile,构建阶段安装 uv、执行 uv sync --frozen --no-dev、运行 Ruff 检查与格式化(存在无法修复的 lint 错误则构建失败)、collectstatic;运行阶段复制 .venv 与代码、设置 PATH,使用无 shell 的最小入口。

使用方式

该技能以提示词/规则集形式存在,通过技能页面加载到支持技能的 AI 编程助手中使用;用户提出 Django 开发请求时,助手按上述约束生成或修改代码。具体安装与调用方式资料未提供。

适用场景

适合需要统一架构规范、严格类型与测试覆盖、安全默认配置、容器化交付与 ASGI 异步能力的 Django/DRF 后端项目,也适合作为团队或助手生成代码时的审查标准。

限制

技能内容较长且规则严格,对生成代码的完整性与合规性要求高;技术栈版本被固定,未明确允许时不能偏离。是否收费、具体安装命令与平台支持情况资料未提供。