jpskill.com
🛠️ 開発・MCP コミュニティ 🔴 エンジニア向け 👤 エンジニア・AI開発者

🛠️ Atlas Best Practices

atlas-best-practices

atlas.hclやAtlas CLIコマンド、スキーマ定義ファイルなどを扱う際に、セキュリティやデータ管理、エクスポート機能を含むAtlas v1.1のベストプラクティスに沿った移行計画やレビューを支援するSkill。

⚡ ⏱ ライブラリ調査+組込 半日 → 1時間

📺 まず動画で見る(YouTube)

▶ 【衝撃】最強のAIエージェント「Claude Code」の最新機能・使い方・プログラミングをAIで効率化する超実践術を解説! ↗

※ jpskill.com 編集部が参考用に選んだ動画です。動画の内容と Skill の挙動は厳密には一致しないことがあります。

📜 元の英語説明(参考)

Use when working with atlas.hcl, Atlas CLI commands, schema HCL/SQL files, or migration planning and reviews, including Atlas v1.1 security, data, and exporter capabilities.

🇯🇵 日本人クリエイター向け解説

一言でいうと

atlas.hclやAtlas CLIコマンド、スキーマ定義ファイルなどを扱う際に、セキュリティやデータ管理、エクスポート機能を含むAtlas v1.1のベストプラクティスに沿った移行計画やレビューを支援するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o atlas-best-practices.zip https://jpskill.com/download/4021.zip && unzip -o atlas-best-practices.zip && rm atlas-best-practices.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/4021.zip -OutFile "$d\atlas-best-practices.zip"; Expand-Archive "$d\atlas-best-practices.zip" -DestinationPath $d -Force; ri "$d\atlas-best-practices.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して atlas-best-practices.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → atlas-best-practices フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-17
取得日時
2026-05-18
同梱ファイル
5

💬 こう話しかけるだけ — サンプルプロンプト

  • › Atlas Best Practices を使って、最小構成のサンプルコードを示して
  • › Atlas Best Practices の主な使い方と注意点を教えて
  • › Atlas Best Practices を既存プロジェクトに組み込む方法を教えて

これをClaude Code に貼るだけで、このSkillが自動発動します。

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

[Skill 名] atlas-best-practices

Atlas ベストプラクティス

Atlas は、宣言的でバージョン管理されたスキーマワークフローをサポートしています。このファイルは最小限に保ち、現在のタスクに必要な参照ファイルのみをロードしてください。

ワークフローの選択

  • 望ましいスキーマの状態が信頼できる情報源である場合は、宣言的ワークフローを使用してください。
  • 監査および段階的なデプロイメントにマイグレーションファイルが必要な場合は、バージョン管理されたワークフローを使用してください。
  • 既存のデータベースをオンボーディングする場合は、ベースラインワークフローを使用してください。

デフォルトの実行フロー

  1. atlas.hcl でターゲットの env を確認します。
  2. dev が設定されており、本番環境から分離されていることを確認します。
  3. まず計画し、次に lint/テスト/検証を行い、その後適用します。
  4. 本番環境への変更は、CI/CD または承認されたデプロイメントワークフローを通じて実行します。

クイックコマンド

# 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

参照マップ

  • core-workflows.md 環境設定、スキーマ・アズ・コードパターン、宣言的ワークフローとバージョン管理されたワークフロー、ベースライン、ORMプロバイダーのロードに使用します。
  • safety-and-quality.md Lintアナライザー、トランザクションモード、スキーマテスト、実行前チェック、CIパターンに使用します。
  • atlas-v1-1-features.md Atlas v1.1 のカバレッジ（2026-02-03 リリース）に使用します。これには、セキュリティ・アズ・コード、宣言的データ、新しいドライバー/プラットフォームサポート、Slack統合、スキーマエクスポーター、MySQL TLSが含まれます。
  • cli-agent-gaps.md Atlas CLI の機能と、エージェントが見落としがちなエッジケースに使用します。計画ワークフロー、マイグレーションディレクトリメンテナンスコマンド、URL/TLSの落とし穴、機能の可用性、バージョンポリシーの制約などです。

ガードレール

  • 資格情報はソースファイルに含めず、Atlas データソースと入力変数を優先してください。
  • 破壊的またはデータ依存のマイグレーションには、明示的なレビューを要求してください。
  • サポートされていないドライバー、不足している dev URL、または不明な環境名に対しては、大音量で失敗させてください。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

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

  1. Confirm the target env in atlas.hcl.
  2. Confirm dev is configured and isolated from production.
  3. Plan first, then lint/test/validate, then apply.
  4. 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.

同梱ファイル

※ ZIPに含まれるファイル一覧。`SKILL.md` 本体に加え、参考資料・サンプル・スクリプトが入っている場合があります。