---

name: publish-gate description: "AI Solo Craft用の公開ゲートスキル。DB検証、ビルド、CI、デプロイ確認、Slack報告まで行う。"

publish-gate

役割

• 公開前の blocking error を潰す
• ビルドと CI を通す
• 本番反映を確認する
• Slack に完了報告する

現行前提

• 本番URLは https://ai-solo-craft.craftgarden.studio
• DB-first 運用
• validate-content-db.mjs の warnings には既存負債が含まれる
• release blocker は error。warnings は current batch に関係するものだけ即対応する

開始前チェック

• 対象の digest / news が DB に入っている
• digest の場合:
  • digest_details がある
  • digest_rankings + digest_ranking_items がある（メールテンプレートに必須）
• 画像、分類タグ、relatedProducts が埋まっている
• 編集部コメント が body_markdown 末尾に入っている（editorial-section クラスの有無で確認。product 記事は対象外）

digest_rankings 確認

スクリプト: scripts/check-digest-rankings.sh

./scripts/check-digest-rankings.sh daily-news-YYYY-MM-DD

手順

1. 進捗投稿

• 開始をすぐ伝える
• push 後、CI 待機前、完了時にも短く更新する

2. DB validation

cd /Users/satokeita/Dev/ai-solo-craft
node scripts/validate-content-db.mjs

よくある blocker:

• digest_details missing
• hero_image_url is required
• 必須フィールド不足

3. publish gate

cd /Users/satokeita/Dev/ai-solo-craft
npm run publish:gate

4. Git push

cd /Users/satokeita/Dev/ai-solo-craft
git add -A
git commit -m "publish: YYYY-MM-DD digest"
git push origin main

5. CI wait

cd /Users/satokeita/Dev/ai-solo-craft
npm run ci:wait

6. Deploy verify

cd /Users/satokeita/Dev/ai-solo-craft
npm run verify:deploy

必要に応じて対象 URL を直接 fetch して 200 を確認する。

Slack

OpenClaw 環境

• 利用可能な Slack / message 手段で、開始投稿のスレッドに返信する

Codex cron fallback

start_ts=$(printf '%s' "message body" | /Users/satokeita/.openclaw/scripts/codex-slack-notify.sh --channel C0AELF58Z5E --stdin --ts-only)
printf '%s' "reply body" | /Users/satokeita/.openclaw/scripts/codex-slack-notify.sh --channel C0AELF58Z5E --thread-ts "$start_ts" --stdin

完了報告に入れるもの

• 公開URL
• 作成本数
• validation / build / CI / deploy の結果
• 残課題があれば 1 行

禁止

• CI 待機中に無言
• warning と error を区別せずに報告
• 旧ドメイン ai.essential-navigator.com を使う
• X 投稿失敗を隠す

⚠️ よくある落とし穴

• ローカル成功 ≠ 公開成功: DB投入・validate-content-db.mjs・CI・本番200確認はそれぞれ別のステップ。ローカルでvalidation通過しても、CI失敗やデプロイ未反映は起こり得る。各ステップを分けて確認すること
• validate-content-db.mjs の warnings に振り回される: warnings には歴史的負債（既存コンテンツの古い形式など）が混ざっている。まず blocking error を先に潰す。warnings は current batch に関係するものだけ即対応し、残りは別タスクで対処
• 「完了」報告前にメール実送信を確認していない: digest 公開の場合、DB投入・ビルド・デプロイが成功しても newsletter が実際に送信されたとは限らない。newsletter_send_logs テーブルで実送信を確認してから完了報告する
• digest_rankings / digest_ranking_items の未作成: digest を公開する際、digest_details だけ作って digest_rankings + digest_ranking_items を忘れるとメールテンプレートが壊れる。開始前チェックで必ず確認する
• 旧ドメイン ai.essential-navigator.com を使う: 本番URLは https://ai-solo-craft.craftgarden.studio。旧ドメインで確認すると正しい結果が得られない

次

• 必要なら x-publisher
• 失敗や学びが出たら MEMORY.md と該当 skill に反映