Imported from fkubota/dotfiles (claude/skills/survey_alert/SKILL.md). Install upstream with npx skills add fkubota/dotfiles --skill survey_alert. Copyright stays with the author.

アラート調査コマンド

注意事項

• 食材名・商品名などシステム上の名称はそのまま使うこと
• 食材名と商品名を混ぜた表記（例：「レモネードベース（シロップ レモン 1L）」）は使わない
• ユーザーが質問文でそのような表記を使っていても、回答では使わない

起動時の動作

$ARGUMENTS に Redash の URL が含まれている場合はそれを使って調査を開始する。

含まれていない場合は以下を聞く：

調査したいアラートの Redash URL を教えてください。

調査フロー

Step 1: Redash からアラートデータを取得

URL からクエリIDを抽出し、Redash API でクエリ情報・結果を取得する：

API_KEY=$(fish -c 'source ~/.config/fish/secrets.fish; echo $REDASH_API_KEY')

# クエリ情報（名前・SQL確認）
curl -s "https://redash.hanzo.cloud/api/queries/{query_id}?api_key=$API_KEY"

# 最新結果を取得
curl -s "https://redash.hanzo.cloud/api/queries/{query_id}/results?api_key=$API_KEY"

result_id が URL に含まれている場合：

curl -s "https://redash.hanzo.cloud/api/query_results/{result_id}?api_key=$API_KEY"

Step 2: パラメータを抽出する

クエリ結果の行データから以下を抽出する：

複数行ある場合は全行を対象とし、行ごとに調査して1つの総合レポートにまとめる。

Step 3: アラート種別を自動判定する

クエリ名・SQL・結果データから以下の観点でアラート種別を判断する：

Step 4: ダッシュボードで調査する

調査ダッシュボード: サジェスト調査系ダッシュボード（Redash #27 / slug: -_6）

パラメータを指定してダッシュボードのクエリ結果を取得する。抽出したパラメータで Redash API を叩いて調査する。

# パラメータ付きでクエリを再実行する例（最新データ取得）
curl -s -X POST "https://redash.hanzo.cloud/api/queries/{query_id}/results" \
  -H "Content-Type: application/json" \
  -d '{"max_age": 0, "parameters": {"company_id": "<company_id>", "shop_id": "<shop_id>", "master_ingredient_id": "<master_ingredient_id>", "purchase_date": "<purchase_date>"}}' \
  "?api_key=$API_KEY"

調査に使うダッシュボードクエリ一覧

必ず取得するクエリ（全アラート共通）

サジェスト異常値・発注量がおかしい場合

未サジェスト調査

在庫・OUT関連の調査

出数・売上・需要予測関連

イベント・販促・他店舗比較

発注精度・成功判定

リンク集

アラート種別や状況に応じて必要なクエリを選んで取得する。不要なクエリは取得しない。

Step 5: DB で追加調査（必要な場合のみ）

ダッシュボードクエリで不足している情報がある場合のみ DB に直接クエリを実行する。

DB接続情報・手順は「共通：DB接続情報」セクションを参照。

Step 6: レポート作成

総合レポートのファイル名

~/alert_log/reports/YYYYMMDD/<NNN>_<アラート名>_<識別情報>.txt

• NNN: 当日ディレクトリ内の連番（001, 002, ...）
• アラート名: アラート種別の日本語名（例: サジェスト異常値, 販促過剰, 未サジェスト, 削除検知, 納品不可）
• 識別情報: 食材名・取引先名・店舗名など識別しやすい補足

例:

~/alert_log/reports/20260313/001_削除検知_串カツ田中_別注不織布おしぼり.txt
~/alert_log/reports/20260313/002_未サジェスト_デリカフェ_レモネードベース.txt

連番の決め方

# 当日ディレクトリの最大番号を確認して +1 する
ls ~/alert_log/reports/YYYYMMDD/ 2>/dev/null | grep -oE '^[0-9]+' | sort -n | tail -1

ファイルが存在しない場合は 001 から始める。

総合レポートのフォーマット

Slack にそのままコピペできる形式で書く。マークダウン記法ではなく Slack の mrkdwn 記法を使う。

*[アラート種別] 総合レポート*　Redash #XXXX / YYYY-MM-DD
━━━━━━━━━━━━━━━━━━━━━━━

*📊 総括*
対象: X件　|　要対応: X件　|　正常動作: X件

━━━━━━━━━━━━━━━━━━━━━━━

*✅ Case 1 — 正常動作*  （または *🔴 Case 1 — 設定問題（CS対応要）* など）
*<店舗名> / <食材名>*

• 取引先: <取引先名>
• kind: `<kind値>`
• <調査で判明した重要な数値・設定を箇条書き>

> <根拠の説明を1〜3文で>

*→ <アクション>*

━━━━━━━━━━━━━━━━━━━━━━━

（Case 2 以降も同様）

━━━━━━━━━━━━━━━━━━━━━━━

*📋 対応サマリ*
1. <店舗名> / <食材名> → <アクション>
2. <店舗名> / <食材名> → <アクション>

記法のルール:

• *テキスト* → Slack で太字
• `コード` → Slack でインラインコード
• > テキスト → Slack で引用ブロック（根拠説明に使う）
• • → 箇条書き（ハイフンより視認性が高い）
• ━━━ → セクション区切り
• 判断の絵文字: ✅ 正常動作 / 🔴 要対応 / 🟡 要確認

共通：alert_log ディレクトリ構造

調査結果・クエリ・知見は ~/alert_log/ に蓄積する。

~/alert_log/
├── INDEX.md                        # 調査ログの一覧・クイックリファレンス
├── reports/                        # 調査レポート（日付別）
│   └── YYYYMMDD/
│       └── <NNN>_<アラート名>_<識別情報>.txt
└── knowledge/                      # 繰り返し発生するパターン・知見
    └── patterns.md

初回実行時

ディレクトリが存在しない場合、自動的に作成する：

mkdir -p ~/alert_log/reports
mkdir -p ~/alert_log/knowledge

INDEX.md が存在しない場合は以下の内容で作成する：

# Alert Log Index

## 調査ログ
<!-- 調査のたびに追記 -->

## 知見・パターン
- [patterns.md](knowledge/patterns.md) - よくある異常パターンまとめ

共通：情報ソース

1. 蓄積済み知見（最優先）

• ~/alert_log/knowledge/patterns.md - 過去の調査から蓄積したパターン

2. プロダクトソースコード・ドキュメント（必要に応じて参照）

• ~/work/foodies/ - プロダクトリポジトリ（ロジックの詳細確認）
• ~/work/foodies/hanzo-docs/ - HANZOのドキュメント（仕様確認）

foodies リポジトリが見つからない場合

~/work/foodies/ が見つかりませんでした。プロダクトリポジトリはどこにありますか？

ユーザーが正しいパスを教えてくれたら、このコマンドファイル内の ~/work/foodies/ を正しいパスに自動で書き換える。

共通：DB接続情報（本番DB）

接続手順（VPN不要・AWS SSM経由）

1. AWS SSO ログイン

aws sso login --profile goals-hanzo

2. SSHトンネル確認・起動

lsof -iTCP:15432 -sTCP:LISTEN

未接続の場合はバックグラウンドで起動する：

ssh -f -N \
    -L 15432:readerdatabase.production.internal.foodies.jp:5432 \
    ssm-prod

3. 接続確認

PGPASSWORD=<password> psql -h localhost -p 15432 -U table_plus -d foodies -c "SELECT 1;"

トラブルシューティング

パスワードは毎回ユーザーに確認する：「DBのパスワードを教えてください（いつものやつです）」

共通：アウトプット後処理

INDEX.md の更新

~/alert_log/INDEX.md の調査ログセクションに1行追記する：

- [YYYY-MM-DD] #NNN <アラート名> <食材/取引先/商品名> / <店舗名> - <総合判断> → [レポート](reports/YYYYMMDD/<NNN>_<アラート名>_<識別情報>.txt)

knowledge/patterns.md の更新

新たなパターンや知見が得られた場合に追記する。

パーミッション

• 読み取り専用: DBへの書き込みは行わない
• 自動書き込み可能な場所: ~/alert_log/ 配下のみ
• このコマンドファイル自体は、foodiesリポジトリのパスが変わった場合や、ユーザーから仕様変更の指示があった場合に書き換える