プロジェクトルート/
├── src/
├── package.json
└── .claude/
    ├── settings.json
    └── skills/
        ├── deploy-staging.md
        ├── weekly-release.md
        └── db-migration-check.md

---
name: deploy-staging
description: |
  ステージング環境にデプロイする。
  「ステージングにデプロイして」「stgにあげて」「動作確認用にデプロイ」
  などの指示で呼び出す。
---

# ステージングデプロイ手順

（Claudeへの指示をここに書く）

---
name: deploy-staging
description: ステージングにデプロイする
---

---
name: deploy-staging
description: |
  ステージング環境（stg、動作確認環境、テスト環境とも呼ばれる）にアプリケーションをデプロイする。
  
  呼び出しトリガーとなる言い回し（例）：
  - 「ステージングにデプロイして」「stgにあげて」
  - 「動作確認用に反映して」「テスト環境にデプロイ」
  - 「PRをstgで確認したい」「動確取って」
  - 「ステージングビルドして」「stgのコードを更新して」
  
  本番環境（production、prod、本番）へのデプロイには使わないこと。
  ロールバックには deploy-rollback Skill を使うこと。
---

# ステージングデプロイ手順

1. まずテストを全部実行して確認してください
2. git tag でバージョンタグを作成してください  
3. デプロイスクリプトを実行してください
4. Slackの #deploy チャンネルに通知を送ってください

.claude/
└── skills/
    ├── deploy-staging.md
    └── scripts/
        └── deploy-staging.sh

---
name: deploy-staging
description: |
  ステージング環境にデプロイする。
  「ステージングにデプロイして」「stgにあげて」「動作確認用にデプロイ」などで呼び出す。
---

# ステージングデプロイ

以下のスクリプトを実行してください：

```bash
sh .claude/skills/scripts/deploy-staging.sh
```

実行後、スクリプトの出力を確認し、エラーがあれば内容をそのまま報告してください。
スクリプトが正常終了した場合は完了をユーザーに伝えてください。

#!/bin/bash
# .claude/skills/scripts/deploy-staging.sh
set -euo pipefail

# カラー出力用
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'

echo -e "${YELLOW}=== ステージングデプロイ開始 ===${NC}"

# 1. 未コミットの変更チェック
if [[ -n "$(git status --porcelain)" ]]; then
  echo -e "${RED}エラー: 未コミットの変更があります。コミットまたはスタッシュしてから実行してください。${NC}"
  exit 1
fi

# 2. テスト実行
echo "テストを実行中..."
if ! npm run test:ci --silent; then
  echo -e "${RED}エラー: テストが失敗しました。デプロイを中止します。${NC}"
  exit 1
fi
echo -e "${GREEN}テスト: OK${NC}"

# 3. ビルド
echo "ビルド中..."
npm run build:staging
echo -e "${GREEN}ビルド: OK${NC}"

# 4. デプロイ（環境変数からターゲットを取得）
DEPLOY_TARGET="${STG_SERVER:-staging.example.com}"
echo "デプロイ先: $DEPLOY_TARGET"
rsync -avz --delete dist/ "${DEPLOY_USER}@${DEPLOY_TARGET}:/var/www/staging/"

# 5. ヘルスチェック
echo "ヘルスチェック中..."
sleep 5
HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" "https://${DEPLOY_TARGET}/health")
if [[ "$HTTP_STATUS" != "200" ]]; then
  echo -e "${RED}エラー: ヘルスチェックが失敗しました (HTTP $HTTP_STATUS)${NC}"
  exit 1
fi
echo -e "${GREEN}ヘルスチェック: OK (HTTP 200)${NC}"

# 6. Slack通知
COMMIT_HASH=$(git rev-parse --short HEAD)
COMMIT_MSG=$(git log -1 --pretty=format:'%s')
TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')

curl -s -X POST "${SLACK_WEBHOOK_URL}" \
  -H 'Content-type: application/json' \
  --data "{
    \"text\": \"✅ ステージングデプロイ完了\",
    \"attachments\": [{
      \"color\": \"good\",
      \"fields\": [
        {\"title\": \"コミット\", \"value\": \"${COMMIT_HASH}: ${COMMIT_MSG}\", \"short\": false},
        {\"title\": \"日時\", \"value\": \"${TIMESTAMP}\", \"short\": true},
        {\"title\": \"デプロイ先\", \"value\": \"${DEPLOY_TARGET}\", \"short\": true}
      ]
    }]
  }"

echo -e "${GREEN}=== デプロイ完了 ===${NC}"

DEPLOY_TARGET="${STG_SERVER:-staging.example.com}"  # デフォルト値付き
rsync -avz --delete dist/ "${DEPLOY_USER}@${DEPLOY_TARGET}:/var/www/staging/"
curl -s -X POST "${SLACK_WEBHOOK_URL}" ...

# .env.claude（.gitignoreに追加必須）
DEPLOY_USER=your-username
STG_SERVER=staging.your-domain.com
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/T00000000/B00000000/xxxxxx
DB_BACKUP_BUCKET=my-backup-bucket

# .envrc
dotenv .env.claude

# デプロイ前提条件

- AWS認証情報は `~/.aws/credentials` の `[staging]` プロファイルを使用
- SSHキーは `~/.ssh/deploy_rsa` を使用（権限600であること）
- Slack通知用のWebhook URLは環境変数 `SLACK_WEBHOOK_URL` に設定すること
- 環境変数の設定方法は `.env.claude.example` を参照

# 必須環境変数チェック
REQUIRED_VARS=("DATABASE_URL" "SLACK_WEBHOOK_URL" "DEPLOY_USER")
for var in "${REQUIRED_VARS[@]}"; do
  if [[ -z "${!var:-}" ]]; then
    echo -e "${RED}エラー: 環境変数 $var が設定されていません${NC}"
    echo "ヒント: .env.claude を確認してください"
    echo "テンプレート: .env.claude.example"
    exit 1
  fi
done

#!/bin/bash
DRY_RUN=false
while [[ $# -gt 0 ]]; do
  case $1 in
    --dry-run) DRY_RUN=true; shift ;;
    *) echo "不明なオプション: $1"; exit 1 ;;
  esac
done

run_cmd() {
  if [[ "$DRY_RUN" == true ]]; then
    echo "[DRY RUN] $*"
  else
    "$@"
  fi
}

# 使用例
run_cmd rsync -avz --delete dist/ "${DEPLOY_USER}@${DEPLOY_TARGET}:/var/www/staging/"
run_cmd aws s3 cp "/tmp/${BACKUP_FILE}" "s3://${S3_BUCKET}/${S3_PREFIX}/${BACKUP_FILE}"

.claude/skills/
├── weekly-report.md
└── scripts/
    └── weekly-report.sh

---
name: weekly-report
description: |
  週次の開発進捗レポートを自動生成してSlackに投稿する。
  
  呼び出しトリガーとなる言い回し（例）：
  - 「週次レポートを作って」「週報を生成して」「今週のレポート」
  - 「月曜のレポート」「週次まとめ」「週の集計」
  - 「今週のコミットをまとめて」「週の進捗をレポートにして」
  - 「weekly report」「週次を流して」
  
  毎週月曜日の朝に実行することを想定しているが、曜日は問わず実行できる。
  対象期間はデフォルトで直近7日間。
---

# 週次レポート生成

## Step 1: データ収集スクリプトの実行

```bash
bash .claude/skills/scripts/weekly-report.sh
```

## Step 2: レポートの整形

スクリプトの出力を基に、以下の構成でMarkdownレポートを作成してください：

見出し：`# 週次レポート: YYYY年MM月DD日週`

セクション：
- 📊 今週のサマリー（コミット数、マージPR数、クローズIssue数）
- ✅ 今週完了したこと（コミットメッセージとPRタイトルから要約、3〜5行で簡潔に）
- 🔄 進行中のこと（オープン中のPR一覧）
- ⚠️ 注意事項（CI失敗や長期オープンのIssueがあれば記載、なければ省略）
- 📅 来週の予定（Step 3でユーザーに確認）

文体は体言止めで簡潔に。技術用語はそのまま使ってよい。

## Step 3: 来週の予定を確認

レポート本文を作成したあと、「来週の予定を教えてください」とユーザーに確認してください。
入力を受け取ったらレポートに追記します。

## Step 4: 保存とSlack投稿

1. レポートを `reports/weekly/YYYYMMDD.md` に保存する
2. 環境変数 `SLACK_WEEKLY_WEBHOOK_URL` を使ってSlackに投稿する

Slack投稿のフォーマット：
- 先頭に「📋 週次レポートを投稿します」と書く
- 本文をそのまま投稿（Markdownはそのまま貼る）

完了したらユーザーに「週次レポートを投稿しました」と報告してください。

#!/bin/bash
# .claude/skills/scripts/weekly-report.sh
# 週次レポート用のデータ収集スクリプト
set -euo pipefail

# 期間の設定（デフォルト：直近7日）
DAYS="${REPORT_DAYS:-7}"

# macOS / Linux 両対応の日付計算
if date --version > /dev/null 2>&1; then
  # GNU date (Linux)
  SINCE_DATE=$(date -d "-${DAYS} days" '+%Y-%m-%d')
else
  # BSD date (macOS)
  SINCE_DATE=$(date -v-${DAYS}d '+%Y-%m-%d')
fi
UNTIL_DATE=$(date '+%Y-%m-%d')
REPORT_DATE=$(date '+%Y年%m月%d日')

echo "=== 週次レポート データ収集 ==="
echo "対象期間: ${SINCE_DATE} 〜 ${UNTIL_DATE}"
echo "レポート日: ${REPORT_DATE}"
echo ""

# Gitリポジトリかどうか確認
if ! git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
  echo "エラー: gitリポジトリ内で実行してください"
  exit 1
fi

# ===== コミット情報 =====
echo "## コミット一覧"
COMMITS=$(git log \
  --since="${SINCE_DATE}" \
  --until="${UNTIL_DATE}" \
  --format="%h %ad %s [%an]" \
  --date=short \
  --no-merges)

if [[ -z "$COMMITS" ]]; then
  echo "（この期間のコミットはありません）"
else
  echo "$COMMITS"
fi
echo ""

COMMIT_COUNT=$(git log --since="${SINCE_DATE}" --until="${UNTIL_DATE}" --no-merges --oneline | wc -l | tr -d ' ')
echo "コミット総数: ${COMMIT_COUNT}件"
echo ""

# ===== 変更統計 =====
echo "## ファイル変更統計"
OLDEST_COMMIT=$(git log --since="${SINCE_DATE}" --no-merges --format="%H" | tail -1)
if [[ -n "$OLDEST_COMMIT" ]]; then
  git diff --stat "${OLDEST_COMMIT}^" HEAD 2>/dev/null \
    | tail -5 \
    || echo "（差分統計を取得できませんでした）"
else
  echo "（対象期間内にコミットがありません）"
fi
echo ""

# ===== GitHub CLI 連携 =====
if command -v gh &> /dev/null && gh auth status &> /dev/null 2>&1; then
  echo "## マージ済みPR（直近${DAYS}日）"
  MERGED_PRS=$(gh pr list \
    --state merged \
    --json number,title,mergedAt,author \
    --jq ".[] | select(.mergedAt >= \"${SINCE_DATE}\") | \"#\(.number) \(.title) [@\(.author.login)] \(.mergedAt[:10])\"" \
    2>/dev/null)
  if [[ -z "$MERGED_PRS" ]]; then
    echo "（なし）"
  else
    echo "$MERGED_PRS"
    MERGED_COUNT=$(echo "$MERGED_PRS" | wc -l | tr -d ' ')
    echo "マージPR総数: ${MERGED_COUNT}件"
  fi
  echo ""

  echo "## オープン中のPR"
  OPEN_PRS=$(gh pr list \
    --state open \
    --json number,title,createdAt,author,reviewDecision \
    --jq ".[] | \"#\(.number) \(.title) [@\(.author.login)] 作成: \(.createdAt[:10]) レビュー状態: \(.reviewDecision // \"未レビュー\")\"" \
    2>/dev/null)
  if [[ -z "$OPEN_PRS" ]]; then
    echo "（なし）"
  else
    echo "$OPEN_PRS"
  fi
  echo ""

  echo "## クローズされたIssue（直近${DAYS}日）"
  CLOSED_ISSUES=$(gh issue list \
    --state closed \
    --json number,title,closedAt \
    --jq ".[] | select(.closedAt >= \"${SINCE_DATE}\") | \"#\(.number) \(.title) (\(.closedAt[:10]))\"" \
    2>/dev/null)
  if [[ -z "$CLOSED_ISSUES" ]]; then
    echo "（なし）"
  else
    echo "$CLOSED_ISSUES"
  fi
  echo ""

  echo "## 長期オープンのIssue（30日以上）"
  STALE_DATE=$(date -d "-30 days" '+%Y-%m-%d' 2>/dev/null || date -v-30d '+%Y-%m-%d')
  gh issue list \
    --state open \
    --json number,title,createdAt \
    --jq ".[] | select(.createdAt <= \"${STALE_DATE}\") | \"⚠️  #\(.number) \(.title) (作成: \(.createdAt[:10]))\"" \
    2>/dev/null || true
  echo ""

else
  echo "## 注意"
  echo "GitHub CLI（gh）が使えないため、PR/Issue情報は取得できませんでした。"
  echo "必要であれば 'gh auth login' で認証してください。"
  echo ""
fi

echo "=== データ収集完了 ==="

---
name: pre-migration-check
description: |
  データベースマイグレーションの事前チェックを行う。実際のDB変更は行わない。
  
  呼び出しトリガーとなる言い回し（例）：
  - 「マイグレーション前のチェックをして」「DBマイグレーションを確認して」
  - 「マイグレーション実行前に問題がないか見て」
  - 「スキーマ変更の影響を確認して」「migrationの事前確認」
  - 「マイグレーションして大丈夫か調べて」
  
  実際のマイグレーション実行（apply、run）とは別のSkillであることに注意。
  チェックのみ実施し、DB変更は行わない。
---

# DBマイグレーション事前チェック

**重要**: このSkillはチェックのみ実行します。実際のDB変更は行いません。

## Step 1: チェックスクリプトの実行

```bash
bash .claude/skills/scripts/pre-migration-check.sh
```

## Step 2: 結果の解釈と報告

スクリプトの出力を確認し、以下の観点でユーザーに報告してください：

1. **未適用マイグレーション**: 何件あるか、どのような変更内容か
2. **破壊的変更の有無**: DROP COLUMN、型変更、NOT NULL追加など
3. **推定影響範囲**: 大きなテーブルへの変更でインデックス再構築が必要か
4. **推奨アクション**: 実行前に取るべき対策（バックアップ、メンテナンスウィンドウなど）

問題がなければ「実行可能と判断します」と伝えてください。
懸念点があれば「以下の点を確認してから実行してください」と具体的に示してください。

#!/bin/bash
# .claude/skills/scripts/pre-migration-check.sh
set -euo pipefail

RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'

echo "=== DBマイグレーション事前チェック ==="
echo ""

# DATABASE_URL の確認
DB_URL="${DATABASE_URL:-}"
if [[ -z "$DB_URL" ]]; then
  echo -e "${RED}エラー: DATABASE_URL が設定されていません${NC}"
  echo "ヒント: .env.claude に DATABASE_URL=postgres://... を設定してください"
  exit 1
fi

# マイグレーションフレームワークの自動検出
if [[ -f "package.json" ]] && grep -q '"prisma"' package.json 2>/dev/null; then
  FRAMEWORK="prisma"
elif [[ -f "package.json" ]] && grep -q '"typeorm"' package.json 2>/dev/null; then
  FRAMEWORK="typeorm"
elif [[ -f "alembic.ini" ]] || [[ -d "alembic" ]]; then
  FRAMEWORK="alembic"
elif [[ -d "db/migrate" ]] && [[ -f "Gemfile" ]]; then
  FRAMEWORK="rails"
elif [[ -d "migrations" ]] && ls migrations/*.sql > /dev/null 2>&1; then
  FRAMEWORK="sql"
else
  FRAMEWORK="unknown"
fi

echo "検出されたフレームワーク: ${FRAMEWORK}"
echo ""

case "$FRAMEWORK" in
  prisma)
    echo "## 未適用マイグレーション確認"
    npx prisma migrate status 2>&1 || true
    echo ""
    echo "## スキーマ変更のプレビュー"
    npx prisma migrate diff \
      --from-schema-datasource prisma/schema.prisma \
      --to-schema-datamodel prisma/schema.prisma \
      --script 2>/dev/null \
      | head -80 \
      || echo "（prisma migrate status を参照してください）"
    ;;

  alembic)
    echo "## マイグレーション履歴"
    python -m alembic history --indicate-current 2>&1 \
      || alembic history --indicate-current 2>&1 \
      || echo "alembic コマンドの実行に失敗しました"
    echo ""
    echo "## 適用予定のSQL（--sql オプション）"
    python -m alembic upgrade head --sql 2>&1 | head -100 \
      || alembic upgrade head --sql 2>&1 | head -100 \
      || echo "SQL出力の取得に失敗しました"
    ;;

  rails)
    echo "## マイグレーション状態"
    bin/rails db:migrate:status 2>&1 \
      || bundle exec rake db:migrate:status 2>&1 \
      || echo "Rails マイグレーション状態の取得に失敗しました"
    ;;

  sql)
    echo "## 未適用のSQLファイル"
    find migrations/ -name "*.sql" | sort | head -20
    ;;

  *)
    echo -e "${YELLOW}警告: マイグレーションフレームワークを自動検出できませんでした${NC}"
    echo "最近変更されたマイグレーション関連ファイル:"
    find . \
      \( -name "*migration*" -o -name "*migrate*" -o -name "schema*" \) \
      -not -path "*/node_modules/*" \
      -not -path "*/.git/*" \
      -newer ".git/index" \
      2>/dev/null | head -20
    ;;
esac

echo ""
echo "## 破壊的変更キーワードチェック"

# 直近で変更されたマイグレーションファイルを検索
MIGRATION_FILES=$(find . \
  \( -name "*.sql" -o -name "*migration*.ts" -o -name "*_migration.py" \
     -o -name "*.rb" -path "*/migrate/*" \) \
  -not -path "*/node_modules/*" \
  -not -path "*/.git/*" \
  -newer ".git/ORIG_HEAD" \
  2>/dev/null || true)

if [[ -n "$MIGRATION_FILES" ]]; then
  echo "変更されたマイグレーションファイル:"
  echo "$MIGRATION_FILES"
  echo ""

  DANGEROUS=$(echo "$MIGRATION_FILES" | xargs grep -iEl \
    "DROP COLUMN|DROP TABLE|ALTER COLUMN|MODIFY COLUMN|NOT NULL|RENAME COLUMN|TRUNCATE" \
    2>/dev/null || true)

  if [[ -n "$DANGEROUS" ]]; then
    echo -e "${RED}⚠️  以下のファイルに破壊的変更の可能性があるキーワードが見つかりました:${NC}"
    echo "$DANGEROUS"
    echo ""
    echo "該当箇所の詳細:"
    echo "$DANGEROUS" | xargs grep -in \
      "DROP COLUMN\|DROP TABLE\|ALTER COLUMN\|MODIFY COLUMN\|NOT NULL\|RENAME COLUMN\|TRUNCATE" \
      2>/dev/null | head -20
  else
    echo -e "${GREEN}✅ 明らかな破壊的変更キーワードは見つかりませんでした${NC}"
  fi
else
  echo "最近変更されたマイグレーションファイルは見つかりませんでした"
fi

echo ""
echo "=== チェック完了 ==="

---
name: update-changelog
description: |
  CHANGELOG.md をgitのコミット履歴から自動更新する。
  
  呼び出しトリガーとなる言い回し（例）：
  - 「CHANGELOGを更新して」「チェンジログを作って」「変更履歴を更新」
  - 「リリースノートを作って」「バージョンアップのCHANGELOGを書いて」
  - 「今回のリリースの変更をまとめて」「changelog生成して」
  
  新バージョン番号はユーザーが指定するか、既存のCHANGELOGから推測する。
---

# CHANGELOG更新

## Step 1: バージョン番号の確認

ユーザーに新バージョン番号を確認してください。
指定がない場合は package.json または既存の CHANGELOG.md の最新バージョンを読み取り、
セマンティックバージョニングに従って提案してください（例：「v1.2.3 でよいですか？」）。

## Step 2: コミット履歴の取得

```bash
bash .claude/skills/scripts/generate-changelog.sh
```

## Step 3: CHANGELOG.md の更新

スクリプトの出力を基に、以下のフォーマットで CHANGELOG.md の先頭（既存の内容の前）に追記してください：

```
## [バージョン番号] - YYYY-MM-DD

### 追加
- （feat: / add: プレフィックスのコミットから。体言止めで）

### 変更
- （refactor: / improve: / change: プレフィックスのコミットから）

### 修正
- （fix: / bug: プレフィックスのコミットから）

### その他
- （上記以外のコミットから。trivial なもの（typo修正など）は省略可）
```

コミットメッセージをそのまま羅列するのではなく、人間が読みやすいように要約・統合してください。

## Step 4: ユーザー確認と保存

更新内容をユーザーに確認してから、ファイルを保存してください。
確認後は「CHANGELOG.md を更新しました」と報告してください。

#!/bin/bash
# .claude/skills/scripts/generate-changelog.sh
set -euo pipefail

echo "=== CHANGELOG生成 データ収集 ==="
echo ""

# 前回のタグを取得
LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")

if [[ -n "$LAST_TAG" ]]; then
  echo "前回タグ: ${LAST_TAG}"
  echo "対象: ${LAST_TAG} 〜 HEAD"
  RANGE="${LAST_TAG}..HEAD"
else
  echo "タグが見つかりません。全コミット履歴を対象にします。"
  RANGE="HEAD"
fi
echo ""

echo "## コミット一覧"
git log \
  "$RANGE" \
  --format="%s [%h] %ad" \
  --date=short \
  --no-merges \
  | grep -v "^Merge" \
  | head -100
echo ""

echo "## カテゴリ別集計"

echo "### feat / add（新機能）"
git log "$RANGE" --format="%s" --no-merges \
  | grep -iE "^feat:|^add:|^feature:" \
  | sed 's/^[^:]*: *//' \
  || echo "（なし）"
echo ""

echo "### fix / bug（バグ修正）"
git log "$RANGE" --format="%s" --no-merges \
  | grep -iE "^fix:|^bug:|^hotfix:" \
  | sed 's/^[^:]*: *//' \
  || echo "（なし）"
echo ""

echo "### refactor / improve / chore（改善・整理）"
git log "$RANGE" --format="%s" --no-merges \
  | grep -iE "^refactor:|^improve:|^chore:|^perf:|^docs:|^style:" \
  | sed 's/^[^:]*: *//' \
  || echo "（なし）"
echo ""

echo "### その他"
git log "$RANGE" --format="%s" --no-merges \
  | grep -viE "^feat:|^add:|^feature:|^fix:|^bug:|^hotfix:|^refactor:|^improve:|^chore:|^perf:|^docs:|^style:|^Merge" \
  | head -20 \
  || echo "（なし）"
echo ""

# 変更ファイル数
echo "## 変更統計"
git diff --stat "${LAST_TAG:-$(git rev-list --max-parents=0 HEAD)}..HEAD" 2>/dev/null \
  | tail -3 \
  || echo "（統計取得に失敗）"
echo ""

echo "=== 収集完了 ==="

skills/
└── deploy.md   ← ステージング、本番、ロールバック、事後確認が全部入り

---
name: deploy
description: デプロイ関連の全作業を行う
---

## ステージングデプロイ
（50行の手順）

## 本番デプロイ
```markdown
（70行の手順）

## ロールバック
（40行の手順）

## デプロイ後の確認
（30行の手順）

skills/
├── deploy-staging.md      # ステージングデプロイのみ（35行）
├── deploy-production.md   # 本番デプロイのみ（40行）
├── deploy-rollback.md     # ロールバックのみ（25行）
└── deploy-postcheck.md    # デプロイ後確認のみ（20行）

---
name: db-backup
description: |
  本番DBのバックアップを取る。「DBバックアップして」「バックアップ取って」で呼び出す。
---

# 本番DBバックアップ

以下の手順でバックアップを実行してください：

1. 環境変数 `DATABASE_URL` から接続文字列を読んでください
2. `pg_dump` でダンプを取得してください。ファイル名は `backup_YYYYMMDD_HHMMSS.sql` 形式にしてください
3. ダンプを gzip 圧縮してください
4. 圧縮ファイルを `s3://my-bucket/db-backups/` にアップロードしてください
5. 7日以上前の古いバックアップを削除してください
6. Slackの #ops チャンネルに完了通知を送ってください

# ワイルドカードに頼らない安全な削除ロジック
aws s3 ls "s3://${S3_BUCKET}/${S3_PREFIX}/" | \
  awk '{print $4}' | \
  grep -E "^backup_[0-9]{8}_[0-9]{6}\.sql\.gz$" | \  # ← パターンが厳密
  while read -r file; do
    FILE_DATE="${file:7:8}"   # backup_YYYYMMDD_ から日付部分だけ抽出
    if [[ "$FILE_DATE" < "$CUTOFF_DATE" ]]; then
      echo "削除: ${file}"
      aws s3 rm "s3://${S3_BUCKET}/${S3_PREFIX}/${file}"
    fi
  done

description: Deploy to staging environment

description: |
  ステージング環境にデプロイする（Deploy to staging environment）。
  「stgにデプロイ」「staging deploy」「ステージングにあげる」などで呼び出す。

## Step 4: 完了処理

デプロイが成功したら、deploy-postcheck Skill を使って事後確認を実行してください。

## Step 4: 完了処理

デプロイが正常に完了しました。

次のどちらかを選択してください：
1. 事後確認を実行する（推奨）→ 「事後確認してください」と伝えてください
2. 事後確認はスキップする → 「完了でよい」と伝えてください

「現在使えるSkillを一覧表示して」

ls -la .claude/skills/

# NG: description以降のインデントが揃っていない
description: |
  ステージングにデプロイする
「stgにあげて」で呼び出す        ← インデントなし（YAMLエラー）

# OK
description: |
  ステージングにデプロイする
  「stgにあげて」で呼び出す      ← 2スペース以上で揃える

# 環境変数をセットして直接実行
source .env.claude
bash -x .claude/skills/scripts/deploy-staging.sh

source .env.claude
bash -x .claude/skills/scripts/deploy-staging.sh --dry-run

# Claude Codeのセッションで使える環境変数を確認
env | grep -E "DEPLOY|SLACK|DATABASE|AWS|S3" | sort

direnv allow
direnv status

---
name: YOUR_SKILL_NAME
description: |
  （このSkillが何をするかを1文で）
  
  呼び出しトリガーとなる言い回し（例）：
  - 「（よく使う言い回し1）」
  - 「（よく使う言い回し2）」
  - 「（略称や口語表現）」
  
  （使ってはいけないケースがあれば：〜のときには使わないこと）
---

# （Skill名）

## 実行

```bash
bash .claude/skills/scripts/YOUR_SCRIPT.sh
```

## 完了後の対応

- 成功した場合：（Claudeへの指示：何をユーザーに報告するか）
- 失敗した場合：エラーメッセージをそのままユーザーに報告し、対処方法を提案してください。

#!/bin/bash
# .claude/skills/scripts/YOUR_SCRIPT.sh
# 説明: （このスクリプトが何をするか1行で）
set -euo pipefail

# ===== カラー出力 =====
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'

# ===== オプション解析 =====
DRY_RUN=false
while [[ $# -gt 0 ]]; do
  case $1 in
    --dry-run) DRY_RUN=true; shift ;;
    *) echo "不明なオプション: $1"; exit 1 ;;
  esac
done

[[ "$DRY_RUN" == true ]] && echo -e "${YELLOW}[DRY RUN] 実際には実行しません${NC}"

# ===== 必須環境変数チェック =====
REQUIRED_VARS=("ENV_VAR_1" "ENV_VAR_2")
for var in "${REQUIRED_VARS[@]}"; do
  if [[ -z "${!var:-}" ]]; then
    echo -e "${RED}エラー: 環境変数 $var が設定されていません${NC}"
    echo "ヒント: .env.claude を確認してください"
    exit 1
  fi
done

# ===== dry-run 対応コマンド実行関数 =====
run_cmd() {
  if [[ "$DRY_RUN" == true ]]; then
    echo "[DRY RUN] $*"
  else
    "$@"
  fi
}

# ===== メイン処理 =====
echo -e "${YELLOW}=== 処理開始 ===${NC}"

# ここに処理を書く
# run_cmd your_command --with-args

echo -e "${GREEN}=== 完了 ===${NC}"

# .env.claude
# このファイルは .gitignore に追加してください
# テンプレートは .env.claude.example としてリポジトリに含めること

# デプロイ設定
DEPLOY_USER=your-username
STG_SERVER=staging.your-domain.com
PROD_SERVER=your-domain.com

# Slack通知
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/xxx/yyy/zzz
SLACK_WEEKLY_WEBHOOK_URL=https://hooks.slack.com/services/xxx/yyy/zzz

# DB設定
DATABASE_URL=postgres://user:pass@localhost:5432/dbname

# バックアップ設定
DB_BACKUP_BUCKET=your-backup-bucket
DB_BACKUP_RETENTION=7

# Claude Code Skills 秘密情報
.env.claude
.env.claude.local

# バックアップファイル（誤ってコミットしないように）
*.sql.gz
*.dump