返回技能目录
人工审校软件开发

技能研究档案

django-storages-s3

来源声明

Use when configuring Django to store static and media files on AWS S3 with django-storages. Invoke when working with the STORAGES setting, S3 buckets, presigned URLs, CloudFront, or boto3-backed file storage in settings.py. Configures the Django 4.2+ STORAGES dict, public/private custom backends, presigned GET/POST URLs, IAM policies, and S3 mocking for tests. Trigger terms: django-storages, S3, boto3, S3Boto3Storage, STORAGES, presigned URL, CloudFront, media files, collectstatic, AWS_STORAGE_BUCKET_NAME.

保留作者的英文原始描述。它表达设计意图,不代表已验证的实际效果。

Use when configuring Django to store static and media files on AWS S3 with django-storages. Invoke when working with the STORAGES setting, S3 buckets, presigned URLs, CloudFront, or boto3-backed file storage in settings.py. Configures the Django 4.2+ STORAGES dict, public/private custom backends, presigned GET/POST URLs, IAM policies, and S3 mocking for tests. Trigger terms: django-storages, S3, boto3, S3Boto3Storage, STORAGES, presigned URL, CloudFront, media files, collectstatic, AWS_STORAGE_BUCKET_NAME.

developmentreferences

研究摘要

人工审校

Skill Atlas editorial review · editorial-preview-1.0.0

面向 Django 的 Skill,用 django-storages 将静态与媒体文件存放到 AWS S3,涵盖 STORAGES 配置、公私有后端、预签名 URL、IAM 与测试模拟。

审阅范围

对所收集的 SKILL.md 及辅助文本/代码进行确定性静态分析。机器辅助候选和发现等待人工编辑复核;不评估动态行为或效果。

可观察能力

  • 安装 django-storages 与 boto3,并配置 Django 4.2+ 的 STORAGES,使媒体与静态文件使用不同路径。
  • 从环境变量或绑定的 IAM 角色读取凭证,并将 default_acl 设为 None。
  • 添加命名的公有与私有后端,并生成预签名下载或上传 URL。
  • 按八项清单审计现有配置,并在测试中用 InMemoryStorage 或 moto 模拟 S3。

限制与范围

  • 仅限通过 django-storages 使用 AWS S3,不涉及其他对象存储。
  • 存储桶、IAM 与 CloudFront 的创建交由其他 Skill 处理,此处不涉及。
  • 此处未验证真实的 AWS 行为与权限。

适用读者

  • 希望把媒体文件迁出本地磁盘的 Django 开发者
  • 审查现有 S3 存储配置的工程师

技能包含哪些内容

文件清单来自记录提交中的采集源码。路径与大小属于结构观察,不代表质量评价。

个文件
5
Markdown 文件
5
个脚本
0
个引用
4
大小
26.5 KB
结构复杂度
低

文件清单

路径类型字节
skills/django-storages-s3/references/configuration.md引用6.3 KB
skills/django-storages-s3/references/custom-backends.md引用5.1 KB
skills/django-storages-s3/references/presigned-urls.md引用3.8 KB
skills/django-storages-s3/references/testing-storages.md引用3.9 KB
skills/django-storages-s3/SKILL.md指令7.3 KB

SKILL.md 前置元数据

{
  "name": "django-storages-s3",
  "description": "Use when configuring Django to store static and media files on AWS S3 with django-storages. Invoke when working with the STORAGES setting, S3 buckets, presigned URLs, CloudFront, or boto3-backed file storage in settings.py. Configures the Django 4.2+ STORAGES dict, public/private custom backends, presigned GET/POST URLs, IAM policies, and S3 mocking for tests. Trigger terms: django-storages, S3, boto3, S3Boto3Storage, STORAGES, presigned URL, CloudFront, media files, collectstatic, AWS_STORAGE_BUCKET_NAME.",
  "license": "MIT",
  "metadata": {
    "author": "https://github.com/awais786",
    "version": "1.0.0",
    "domain": "backend",
    "triggers": "django-storages, S3, boto3, S3Boto3Storage, STORAGES, presigned URL, CloudFront, media files, collectstatic",
    "role": "specialist",
    "scope": "implementation",
    "output-format": "code",
    "related-skills": "django-expert"
  }
}

对运行顺序的一种解读

此工作流根据源码材料重建表面顺序。除非明确记录受控评估,否则它属于暂定解读,而非真实运行轨迹。

  1. 01
    输入

    安装并注册

    安装 django-storages[s3] 与 boto3,并将 storages 加入 INSTALLED_APPS。

  2. 02
    操作

    配置凭证与 STORAGES

    从环境变量或 IAM 角色读取凭证,并为 default 与 staticfiles 后端设置独立路径。

  3. 03
    判断

    划分公有与私有后端

    当需要区分公有与私有文件时,添加使用不同存储桶或 ACL 的命名后端。

  4. 04
    输出

    验证与测试

    运行 collectstatic,确认上传落到 S3,并在测试中用 InMemoryStorage 或 moto 模拟 S3。

潜在风险面

静态发现用于提示安装前需要检查的位置,不能证明一项技能安全、恶意或有效。

建议重点关注

收集的文本中有 27 项确定性词法发现需要复核。发现可能仅位于文档中,不证明已执行或可被利用;仅含二进制的文件未扫描。

网络访问已观察到
文件写入已观察到
凭据使用已观察到
高

文本引用凭据或密钥材料

4 次命中

此行疑似凭据字面值,或读取敏感环境变量。请勿暴露其内容;应核实它是占位符、所需密钥,还是误提交的敏感材料。 该规则在收集文本中命中 4 处;此处列出 3 个代表位置。命中文本可能只是文档,分析器没有执行它。

中

文本提及网络访问

11 次命中

此源文件行包含 URL 或网络客户端。应检查目标地址、发送的数据和信任边界;静态文本无法证明实际发生了网络活动。 该规则在收集文本中命中 11 处;此处列出 3 个代表位置。命中文本可能只是文档,分析器没有执行它。

提示

文本描述或实现了文件修改

12 次命中

此行包含可能的文件写入或重定向操作。应检查目标路径和覆盖行为;静态审查没有写入任何文件。 该规则在收集文本中命中 12 处;此处列出 3 个代表位置。命中文本可能只是文档,分析器没有执行它。

编辑安全提示

使用前确认没有提交 AWS 密钥,且 IAM 策略仅对目标存储桶授予 Get、Put、Delete 与 ListBucket。

上下文可能消耗在哪里

发现、激活与资源层具有不同含义。只有使用指定官方方法并记录模型的运行时,才显示精确数值。

精确 token 计数不可用

在管线使用明确模型执行官方精确计数之前,包括文件清单在内的所有 token 值均为 null。

未使用要求的官方方法记录 token 测量。本档案不会用字符数、文件大小或估计值替代。

受控评估

没有受控评估

该技能仅具备以上标明的证据。不声称任何任务成功率、token 效率、延迟或质量优势。

尚未测试

在源码可见的情况下使用

安装命令
git clone https://github.com/Jeffallan/claude-skills.git cd claude-skills # 将该 Skill 目录复制到以下任一位置: # ~/.claude/skills/django-storages-s3 # .claude/skills/django-storages-s3
  1. 打开固定版本源码:https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/django-storages-s3/SKILL.md。
  2. 审阅许可证、前置条件和所有捆绑的参考文件。
  3. 将该 Skill 目录复制到个人或项目级 Claude Code skills 目录。
  4. 重启或刷新 Claude Code,使该 Skill 可被发现。
验证安装

运行 collectstatic 并测试上传,确认文件分别落在存储桶中独立的 static 与 media 前缀下。

前置条件

  • 仅限通过 django-storages 使用 AWS S3,不涉及其他对象存储。
  • 存储桶、IAM 与 CloudFront 的创建交由其他 Skill 处理,此处不涉及。
  • 此处未验证真实的 AWS 行为与权限。

示例提示词

代表性任务

Use the django-storages-s3 skill to configure STORAGES for a Django 5 project with media under media/ and static under static/, credentials from environment variables, and a private backend that issues presigned URLs.

使用前检查

Read the django-storages-s3 skill at https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/django-storages-s3/SKILL.md. Explain its workflow, required tools, permissions and the main risks before I decide whether to install it.

附上限制条件的判断

优势

  • 提供带有凭证与 ACL grep 命令的具体审计清单。
  • 规则明确,例如禁止硬编码密钥、禁止 querystring_auth 与自定义域名同时使用。

注意事项

  • 关于 2023 年 4 月后创建的存储桶 ACL 行为等建议取决于可能变化的 AWS 默认设置。
  • 真实的 IAM 策略仍需结合自己的存储桶人工审阅。
研究结论

一份聚焦、以清单驱动的 Django S3 存储指南,最适合配置与审计场景。

从结构上保持可追溯

档案是对公开工件的限时阅读,而非背书。请通过来源链接检查确切的上游材料。

Jeffallanclaude-skillsskills/django-storages-s3
来源类型
社区
提交
67c1961b180dc92cf08983344627109e983e8f51
采集时间
2026年11月20日
最近核查
2026年11月20日
上游许可证
MIT
仓库星标
12,464
内容依据

仅对提供的文件进行确定性词法解析、YAML frontmatter 校验、文件清单、来源描述的工作流程提取和启发式暂定分类。由机器生成;无 LLM、执行、动态测试或人工编辑批准。