Communitygithub.com

waitlist-launch — 候補名單站上線プロセス

あらゆるウェブサイトやプロジェクト向けに、ゼロから本番運用可能な waitlist(仮登録サイト)を構築します。Cloudflare Worker + KV によるメール収集、Resend 同期、3層のスパム対策、OG共有カード、リファラルループ、Web Analytics を含み、コピーライティングの公式やトラフィック獲得の playbook、リリース前のゲートチェックリストも完備しています。

waitlist-launch — 候補名單站上線プロセス とは?

このスキルは、あらゆるウェブサイトやプロジェクトに対して、本番運用可能な waitlist(仮登録サイト)をゼロから構築・公開するための包括的なプロセスを提供します。具体的には、Cloudflare Worker + KV を用いたメールアドレス収集、Resend によるリスト同期、3層のスパム対策(ハニーポット、レート制限、Turnstile)、OG共有カード、リファラルループ、そして Web Analytics を実装します。このスキルは、マーケティングコピーの公式、トラフィック獲得チャネルのプレイブック、リリース前の厳格なゲートチェックリストを含む、単なる技術実装を超えた製品・マーケット戦略を提供します。サポートプラットフォームは Cloudflare Workers と Resend メールサービスです。主な仕組みは、KV を唯一の信頼できるデータストアとし、スパム対策に KV の書き込みを消費しない設計、すべての公開設定をランタイム変数で管理するというアーキテクチャ原則に基づいています。さらに、事前インタビュー、段階的な実装フェーズ、検証手順、既知の落とし穴とその回避策など、複数の subagent が関わるプロジェクト管理のためのディスパッチルールも含まれています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Heng-xiu/xiuxiu-agent-skills/tree/HEAD/skills/waitlist-launch

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

waitlist-launch — 候補名單站上線プロセス は何をしますか?

fare-waitlist 実戦から抽出(2026-07, early-fare.hengshiou.com、参考実装: /Users/xiuxiu/Documents/個人事宜/1_Projects/fare-waitlist)。 コアコンセプト:KV が名簿の唯一の真値、スパム対策に KV write を使わない、公開設定はすべて runtime var、 アナリティクスがないうちはトラフィックを流さない、コピーは逆営業で信頼を構築

三つのロール別ドキュメント(必要に応じて読み込み、一度に全部読まないこと)

ファイルロールいつ読むか
references/architecture.md情報アーキテクト開発着手時に必読:事前インタビューリスト、6フェーズプロセス、API/KV 契約(そのまま流用可)、var vs secret の境界、ツール権限表、検証マニュアル、既知の落とし穴
references/copywriting.mdマーケティング担当ページコピー、シェア用コピー、OG 画像、トラフィックチャネル計画作成時に読む:H1 痛点表現、lede 構造、同意フォーム、逆営業ガイド、チャネルプレイブック + ref アトリビューションコード
references/operations.mdプロダクトマネージャーリリース前検収とリリース後運用時に読む:ゲートチェックリスト(必須/推奨の2段階)、成功指標と虚栄指標、エンゲージメント維持のリズム、意思決定の境界、イテレーションバックログテンプレート

実行プロセス(オーケストレーター視点)

  1. 事前インタビュー:architecture.md §1 の9つの質問をユーザーに行い、回答が得られなければ作業を開始しない。 特に注意:コミュニティハンドルは必ず検証すること(ユーザーの既存サイトのソースコードを grep するか、本人に確認してもらう)。モデルの記憶で推測してはいけない。
  2. 現状調査:既存のリポジトリの場合は、まず git log で確認する。wrangler のログインアカウントと zone 権限を確認する。
  3. フェーズ別実装(詳細手順、Done の定義は architecture.md §2 参照):
    • フェーズ1 基本サイト構築(Worker + assets + KV + custom domain)
    • フェーズ2 Resend 名簿同期(best-effort + ops/sync で冪等にバックフィル)
    • フェーズ3 スパム対策3層(ハニーポット → ネイティブレート制限 → Turnstile、すべて KV write を使わない)
    • フェーズ4 個人ブランド footer(控えめに、CTA より視覚的重みを低く)
    • フェーズ5 露出層(og:image → referral → analytics、この順番で、すべて index.html を変更)
    • フェーズ6 デプロイ検証(smoke チェックリスト + cache-buster)
  4. コピー:すべてのコピー箇所(H1/lede/bullets/consent/証明カード/シェア用コピー)に copywriting.md の公式を適用する。 誠実な説得回避文は必ず本物でなければならない。
  5. リリースゲート:operations.md §1 に従い、各項目をチェックする。「必須」レベルの項目が1つでも合格しなければリリースしない。 アナリティクスがないうちはトラフィックを流さない。
  6. リリース後:チャネルに ref コードを付けてアトリビューション(copywriting.md §4)、名簿が100を超えたらエンゲージメント維持、 社会的証明の人数が閾値を超えたら表示する(operations.md §3)。

タスクディスパッチのルール(複数 subagent の場合)

  • 複数のタスクが同じファイルを変更する場合(典型的には、露出層の3つのサブタスクがすべて index.html を変更)→ 順番にタスクを割り当て、並行実行しないこと。
  • 各 subagent へのタスク指示には必ず:変更して良いファイルのみ、Done の定義、実測の証拠(スクリーンショット/curl 出力)を添付するよう要求、 コミットもデプロイも禁止。
  • オーケストレーターはタスクごとに diff を検収し、重要な成果物を目視確認(画像は必ず Read で確認する)、タスクごとにコミットする。 すべて完了したらまとめてデプロイ + オンライン smoke テストを実行する。
  • 報告は4つのことを伝える:ブランチ、コミットハッシュ、デプロイ済みかどうか、ワークツリーをクリーンアップしたかどうか。

ユーザーが手動で行う必要があること(自動化不可、事前に伝える)

  • CF ダッシュボードで Turnstile site を作成(site key + secret を取得)
  • CF ダッシュボードで Web Analytics site を作成(beacon token を取得。wrangler OAuth には RUM 権限がなく、API では作成不可)
  • Resend:オーディエンスを作成、専用の API key を生成(他サイトから流用しない)、送信ドメインの DNS 検証
  • Custom domain を初めて設定する場合、ダッシュボードで DNS/証明書を確認する必要がある場合がある

コードは runtime var モードで事前に記述しておく(/api/health が動的にフロントエンドに提供)。上記の認証情報が準備でき次第、var/secret を入力し、再デプロイするだけで有効になる – コードの変更は不要。これにより「認証情報待ち」が開発をブロックしない。

最もハマりやすい落とし穴(完全なリストは architecture.md §5.3 を参照)

  • Headless Chrome で OG 画像をキャプチャする際:--force-device-scale-factor=1(Retina だと 2x になってしまう)+ --virtual-time-budget=4000(Web フォントの読み込みを待つ)。キャプチャ後は必ず目視確認する(フォールバックフォント、見出しの orphan 行)。
  • デプロイ後にエッジキャッシュが古い HTML を返す → ?cb=<timestamp> で検証する。
  • 本番環境で Turnstile が有効だと、curl で /api/join をテストできない → 契約テスト(正常/重複/ハニーポットの3ケース)はローカルの wrangler dev でのみ行う(secret がなければ自動的にスキップされる)。
  • ハニーポット/レート制限に引っかかった場合は、ソフトに成功を返すが、refCode は返さない(ボットに情報を与えない)。既に名簿にある場合は、already と同一の refCode を返す(冪等)。
  • 平文の API key が会話やファイルに現れた → 直ちに secret に変更する。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル