majiayu000 Infrastructure as Code
概要
Infrastructure as Codeの原則に基づく構成管理の自動化を専門とするスキル。 環境変数管理、Secret管理、Railway統合を中心に、再現可能なインフラ構成を実現します。
詳細な手順や背景は references/Level1_basics.md と references/Level2_intermediate.md を参照してください。
ワークフロー
Phase 1: 環境変数設計
目的: プロジェクトの環境変数構成を設計し、.env.exampleを整備
アクション:
- 必要な環境変数を洗い出し
- 命名規則と分類を決定
- バリデーションルールを定義
assets/env-example-template.txtをベースに.env.example作成
Task: agents/environment-design.md を参照
Phase 2: シークレット管理
目的: GitHub Secrets/Railway Secretsの安全な管理戦略を実装
アクション:
- シークレット分類（開発/ステージング/本番）
- ローテーション戦略の策定
- アクセス制御の設定
Task: agents/secret-manager.md を参照
Phase 3: Railway統合構成
目的: Railway.jsonとデプロイ構成の最適化
アクション:
assets/railway-json-template.jsonをベースに設定- 環境別ビルド/スタートコマンド定義
scripts/validate-env.mjsで検証
Task: agents/railway-configurator.md を参照
Phase 4: 検証と完了
目的: 構成の整合性確認と記録
アクション:
agents/railway-validator.mdで検証実行- 環境間の差分レポート作成
scripts/log_usage.mjsで記録
ベストプラクティス
すべきこと
- Railway構成を設計・最適化する時
- 環境変数とSecretの管理戦略を設計する時
- 複数環境間の構成差分を最小化する時
- ローカル開発環境とクラウド環境を同期する時
避けるべきこと
- シークレットをソースコードにハードコード
- 環境変数のバリデーションを省略
- 環境間の設定差分を文書化せずに運用
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 | 参照エージェント |
|---|---|---|---|---|
| 環境変数設計 | Phase 1開始時 | プロジェクト要件 | .env.example | agents/environment-design.md |
| シークレット管理 | Phase 2開始時 | 機密情報リスト | シークレット管理計画 | agents/secret-manager.md |
| Railway構成 | Phase 3開始時 | 環境変数設計書 | railway.json | agents/railway-configurator.md |
| 構成検証 | Phase 4開始時 | 全構成ファイル | 検証レポート | agents/railway-validator.md |
詳細仕様: 各Taskの詳細は agents/ ディレクトリの対応ファイルを参照
リソース参照
references/（詳細知識）
| リソース | パス | 内容 |
|---|---|---|
| 基礎知識 | references/Level1_basics.md | IaC基本概念 |
| 実務ガイド | references/Level2_intermediate.md | 環境変数管理実践 |
| 高度な技法 | references/Level3_advanced.md | マルチ環境戦略 |
| 専門知識 | references/Level4_expert.md | セキュリティ強化 |
scripts/（決定論的処理）
| スクリプト | 用途 | 使用例 |
|---|---|---|
| validate-env.mjs | 環境変数検証 | node scripts/validate-env.mjs |
| log_usage.mjs | 使用記録 | node scripts/log_usage.mjs --result success |
assets/（テンプレート）
| テンプレート | 用途 |
|---|---|
| env-example-template.txt | .env.example雛形 |
| railway-json-template.json | Railway構成テンプレート |
コマンドリファレンス
リソース読み取り
cat .claude/skills/infrastructure-as-code/references/Level1_basics.md
cat .claude/skills/infrastructure-as-code/references/Level2_intermediate.md
cat .claude/skills/infrastructure-as-code/references/Level3_advanced.md
cat .claude/skills/infrastructure-as-code/references/Level4_expert.md
cat .claude/skills/infrastructure-as-code/references/environment-variables.md
cat .claude/skills/infrastructure-as-code/references/iac-principles.md
cat .claude/skills/infrastructure-as-code/references/legacy-skill.md
cat .claude/skills/infrastructure-as-code/references/railway-integration.md
cat .claude/skills/infrastructure-as-code/references/secrets-management.md
スクリプト実行
node .claude/skills/infrastructure-as-code/scripts/log_usage.mjs --help
node .claude/skills/infrastructure-as-code/scripts/validate-env.mjs --help
node .claude/skills/infrastructure-as-code/scripts/validate-skill.mjs --help
テンプレート参照
cat .claude/skills/infrastructure-as-code/assets/env-example-template.txt
cat .claude/skills/infrastructure-as-code/assets/railway-json-template.json
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.1.0 | 2026-01-02 | ワークフローをPhase別に再構成、agents/参照追加 |
| 2.0.0 | 2026-01-02 | 18-skills.md完全準拠、Task仕様ナビ追加 |
| 1.0.0 | 2025-12-24 | 初版 |