Atlas 最佳实践指南：声明式与版本化模式工作流、迁移命令与安全防护

atlas-best-practices by 0xbigboss/claude-code

86 周安装量

41 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/0xbigboss/claude-code --skill atlas-best-practices

数据库开发运维版本控制

🇨🇳中文介绍

Atlas 最佳实践

Atlas 支持声明式和版本化模式工作流。请保持此文件简洁，仅加载当前任务所需的参考文件。

工作流选择

当期望的模式状态是唯一真实来源时，使用声明式工作流。
当需要迁移文件进行审计和分阶段部署时，使用版本化工作流。
当接入现有数据库时，使用基线工作流。

默认执行流程

确认 atlas.hcl 中的目标 env。
确认 dev 环境已配置并与生产环境隔离。
先计划，然后进行代码检查/测试/验证，最后应用。
通过 CI/CD 或已批准的部署工作流运行生产变更。

快速命令

# 声明式
atlas schema apply --env local

# 版本化
atlas migrate diff add_change --env local
atlas migrate lint --env local --latest 1
atlas migrate apply --env local

# 完整性检查
atlas migrate validate --env local
atlas migrate status --env local

参考映射

core-workflows.md 用于环境配置、模式即代码模式、声明式与版本化工作流、基线化以及 ORM 提供程序加载。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

🇺🇸English

Atlas Best Practices

Atlas supports declarative and versioned schema workflows. Keep this file minimal and load only the reference file needed for the current task.

Workflow Selection

Use declarative workflow when desired schema state is the source of truth.
Use versioned workflow when migration files are required for auditing and staged deployments.
Use baseline workflow when onboarding an existing database.

Default Execution Flow

Confirm the target env in atlas.hcl.
Confirm dev is configured and isolated from production.
Plan first, then lint/test/validate, then apply.
Run production changes through CI/CD or approved deployment workflow.

Quick Commands

# Declarative
atlas schema apply --env local

# Versioned
atlas migrate diff add_change --env local
atlas migrate lint --env local --latest 1
atlas migrate apply --env local

# Integrity
atlas migrate validate --env local
atlas migrate status --env local

Reference Map

core-workflows.md Use for environment config, schema-as-code patterns, declarative vs versioned workflows, baselining, and ORM provider loading.
safety-and-quality.md Use for lint analyzers, transaction modes, schema tests, pre-execution checks, and CI patterns.
atlas-v1-1-features.md Use for Atlas v1.1 coverage (released on 2026-02-03), including security as code, declarative data, new drivers/platform support, Slack integration, schema exporters, and MySQL TLS.
cli-agent-gaps.md Use for Atlas CLI capabilities and edge cases agents often miss: planning workflows, migration directory maintenance commands, URL/TLS pitfalls, feature availability, and version policy constraints.

Guardrails

Keep credentials out of source files; prefer Atlas data sources and input variables.
Require explicit review for destructive or data-dependent migrations.
Fail loudly on unsupported drivers, missing dev URLs, or unknown environment names.

Weekly Installs

Repository

0xbigboss/claude-code

GitHub Stars

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

codex66

gemini-cli64

opencode63

claude-code61

cursor60

github-copilot59