Atlas Best Practices 是一份围绕 Atlas 工具链的最佳实践参考，适用于处理 atlas.hcl、Atlas CLI 命令、schema HCL/SQL 文件，以及迁移规划与审查的场景。其核心目标是让使用者在正确的时机选择正确的工作流，并以安全、可审计的方式执行数据库 schema 变更。
用途与工作流选择 Atlas 同时支持声明式（declarative）与版本化（versioned）schema 工作流。该技能给出选择依据：当期望的 schema 状态本身即事实来源时，使用声明式工作流；当需要迁移文件用于审计和分阶段部署时，使用版本化工作流；当需要接入已有数据库时，使用 baseline 工作流。
默认执行流程 技能规定了一套默认执行顺序：先在 atlas.hcl 中确认目标环境；确认 dev 环境已配置且与生产隔离；先执行 plan，再进行 lint/test/validate，最后 apply；生产环境变更必须通过 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 用于环境配置、schema-as-code 模式、声明式与版本化工作流对比、baselining 以及 ORM provider 加载；safety-and-quality.md 用于 lint 分析器、事务模式、schema 测试、执行前检查与 CI 模式；atlas-v1-1-features.md 用于 Atlas v1.1（2026-02-03 发布）相关内容，包括 security as code、声明式数据、新驱动与平台支持、Slack 集成、schema 导出器与 MySQL TLS；cli-agent-gaps.md 用于 Atlas CLI 能力与代理常忽略的边界情况，包括规划工作流、迁移目录维护命令、URL/TLS 陷阱、功能可用性与版本策略约束。
护栏与限制 技能要求：凭据不得写入源码文件，应优先使用 Atlas 数据源与输入变量；破坏性或依赖数据的迁移必须经过显式审查；对不支持的驱动、缺失的 dev URL 或未知环境名必须显式失败（fail loudly）。关于具体收费、价格、平台支持范围与效果等事实，资料中未提供，暂未提供。