Quiz Site Builder — ポータブルエージェントスキル
ユーザーとクイズのコンセプトを共同作成し、合意したデザインを洗練されたテスト済みのCloudflare Pages対応Webサイトに仕上げます。このスキルはベンダーニュートラルなAgent Skillsフォルダ形式に従います。特定のエージェント製品やベンダー固有のツールを要求することはありません。GitHubソースホスティングとCloudflare Webサイトデプロイは常に区別してください。このスキル自身のリポジトリと、生成された各クイズサイトのリポジトリは別物です。
最初に読んでください
- ファイルに触れる前に、ユーザーの作業ディレクトリを確認してください。既存のプロジェクト、ファイル、設定、デプロイを上書きしないでください。
- 共同作成中は、メカニズムを黙って修正するのではなく提案してください。完全な実装の前に確認または委任を受けてください:
- 性格/キャラクターマッチング: 次元 → 決定論的なタイプ/キャラクターマッチング; 同点処理を説明してください。
- サバイバル/インタラクティブストーリー: 順序付き選択 → 追跡された状態変数とチェックポイント → 到達可能なエンディング。
- 診断/強み: 自然な得意分野 + 消耗要因 + ピーク体験 → 解釈可能な強みとアクション。
- 質問、結果、スコアバランスについては
references/quiz-design.mdを読んでください。テーマライティングとデザインについてはreferences/visual-and-copy.mdを読んでください。フォント、画像、依存関係を選択する前にreferences/mainland-readiness.mdを読んでください。完了を宣言する前にreferences/qa.mdを読んでください。デプロイを依頼された場合は、GitHub経由のCloudflare Pages についてreferences/publishing.mdを読んでください。 - 承認された開発段階で、ゼロから始める場合:
assets/starter/の全体を新しいWebサイトディレクトリにコピーしてください。再利用可能なスターターを直接変更しないでください。スターターには3つのサンプルクイズ、型付きスコアリングエンジン、レスポンシブビュー、結果共有が含まれています。コンポーネントを編集する前にsrc/data/*.jsonをカスタマイズしてください。 - デフォルトではペイウォールなし。 ユーザーが明示的に要求しない限り、課金、カードコード、Cloudflare Workers、認証、D1、KVを導入しないでください。アクセスコードが要求された場合は、
references/access-codes-optional.mdを読み、ユーザーを安全なアーキテクチャに導いてください。黙って実装したり、課金可能なサービスをデプロイしたりしないでください。
デフォルトモード: ユーザー参加共创
たとえ初期リクエストが「Webサイトを作って」や開発タスクのリストであっても、デフォルトで共同作成モードにします。まずクリエイティブの方向性を明確にし、すぐに完全な問題バンクを生成したり、スターターをコピーしたり、サイト全体を構築したりしないでください。ユーザーがすでに与えた選択肢は、再度尋ねるのではなく再利用してください。既存ファイルの確認と範囲を限定した提案の準備は許可されています。
以下の3つの段階を順番に進めてください。通常は1応答につき1段階です。各段階では具体的な推奨事項を示し、合計で最大1~2の主要な質問をしてください。すでに回答済みの質問を繰り返さないでください。どのエージェントでも通常のチャットを使用してください。オプションフォームは必須にしてはいけません。
- 探索创意(アイデア探索) — ユーザーのトピックについて、意味の異なる2~3の角度を提案します。それぞれにフック、対象読者、差別化された体験を含めてください。特徴的なプレイヤーの緊張感と、記憶に残り正直に共有できる結果を重視し、根拠のないバイラル性を主張しないでください。ユーザーが明示的に異なる数(例:5つのアイデア)を要求した場合は、2~3を強制するのではなくそれに従ってください。1つを推奨し、その理由を説明してください。どの角度を発展させるかを尋ね、コンセプトを実質的に変える追加質問は最大1つにしてください。
- 设计测试(テスト設計) — 提案するアルゴリズムを平易な言葉で提示し(状態/次元、選択がそれらにどう影響するか、チェックポイント/同点、エンディングの選択方法)、結果タイプとその違い、さらに2~3の完全なサンプル質問と選択肢、および説明されたトレードオフを示してください。確認された角度に合うメカニズムを推奨し、それを採用するか主要なトレードオフを変更するかを尋ねてください。サンプルは提案であり、完全な問題バンクではありません。
- 确定风格(スタイル決定) — パレット、タイポグラフィ、電話フロー、3:4シェアカード処理を含む2~3の具体的なビジュアル方向性を提案し、1つを推奨してください。タイトル、解釈、強み、コスト、アドバイスを含む代表的な結果レポートのドラフトを示してください。ビジュアルの選択と統合デザインの最終承認を求め、最大2つの質問をしてください。ユーザーがデザインを確認するか、残りの決定を明示的に委任するまで、本格的な開発を開始しないでください。
各段階の終わりに、簡潔な决定记录(決定記録) を表示してください。確認済みの選択、まだ確認待ちのAI推奨、および未決定の事項を含めます。委任/スキップされた選択は「AI决定(AI決定)」または「跳过,采用建议(スキップ、推奨を採用)」として記録し、ユーザーが選択した設定として記録しないでください。この記録をチャット内で引き継ぎ、承認後は生成されたサイトの docs/DESIGN.md に保存してください。ユーザーが決定を修正した場合は、記録を更新し、実質的に影響を受ける提案のみを再検討し、全段階をやり直さないでください。
各段階でユーザーは修正、スキップ、またはAIに決定を任せることができます。「跳过这一步(このステップをスキップ)」はその段階のみを委任します。推奨されるデフォルトを記録し、次の段階に進んでください。「你决定剩下的(残りはあなたが決めて)」は残りのすべての選択を委任します。選択したデザインを簡単に記録し、実装に進んでください。沈黙や経過時間は承認ではありません。入力が必要な場合は、該当する段階で停止してください。応答がないことを構築の許可として扱わないでください。
ワンクリックモード / 一键生成
ユーザーが「直接做(直接やって)」「一键生成(ワンクリック生成)」「你来决定(あなたが決めて)」と言った場合、またはすべてのデザイン議論をスキップしてすぐに構築するよう明示的に要求した場合は、現在のリクエストに対してワンクリックモードに切り替えてください。選択されたデフォルトを述べ、3つの会話ゲートなしにコンテンツ、ロジック、UI、バリデーション、ローカルプレビューを自律的に進めてください。既存のユーザー制約は引き続き適用されます。ユーザーはいつでも共同作成モードに戻ることができます。明確な事前のデザイン承認も、段階を繰り返さずに自律的な開発を許可します。
デザイン承認またはワンクリックモードは、要求された開発とデバッグを許可しますが、無関係な外部アクションは許可しません。要求されたローカルのみの境界を維持してください。GitHubへの公開とCloudflareへのデプロイには、依然としてユーザーの意図と利用可能な認可が必要です。
エンドツーエンドのワークフロー
1. ユーザーのアイデアを使用可能な製品仕様に変換する
共同作成モードでは、上記の3つの段階を完了し、実装前に決定記録を統合してください。ワンクリックモードでは、デフォルトを選択し、待たずに簡単に述べてください。ワンセンテンスのフック、対象読者、質問数(デフォルト約10~16)、結果クラス、メカニズム、トレードオフ、テーマ/カラー方向性、モバイルフロー、シェアカードのアイデアを含めます。指定がない場合、デフォルトは無料、匿名、プログレスをローカル保存する静的サイトにします。確認済みの選択について再度尋ねないでください。共同作成モードでは、提案されたデフォルトが受け入れられるか委任されるまでラベルを付けてください。エンターテイメントの性格テストを科学的診断と決して説明しないでください。
2. デザイン承認または委任後、UIの前にクイズコンテンツとロジックを書く
プレースホルダーサンプルではなく完全な問題バンクを自律的に提供し、承認されたサイトを実装/デバッグしてください。日常的な技術的判断について尋ねないでください。もっともらしく明白でない選択肢を持つ物語的な質問を使用してください。src/data/*.json を正規のクイズデータとして保持してください。各性格/診断オプションについて、宣言された軸のみを参照してください。サバイバルの場合、danger と influence は有限の整数状態効果とし、エピソードは順序付けられ、複数のエンディングが現実的に到達可能である必要があります。失敗と成功への経路をテストし、「常に最も安全な答えを選ぶ」という悪用を防いでください。ライセンスされたメディア/名前付き作品については、検証可能なプロットの事実と創作された状況を分離してください。実際の年表を主張する前に、信頼できる情報源またはユーザー提供の参考文献を参照してください。入手できない場合は、ギャップを述べ、ユーザーが選択できるオリジナルの代替案を提案してください。名前付き作品のリクエストを、その画像、会話、プロモーションアセットをコピーする許可として扱わないでください。使用権を確認し、正確なプロット年表を作り上げないでください。
3. 魅力的で中国対応の静的UIを構築する
デフォルトではスターターからのVite + React + TypeScriptを使用し、Cloudflare Pages用に base: '/' を設定してください。以下を維持してください: 一度に一問表示、プログレス、戻る、再開、リスタート、キーボードサポート、320px以上の電話画面、共有リンクプレビュー、3:4シェアカードエクスポート。Google Fonts、リモート画像CDN、サードパーティスクリプト/SDK、海外API、クライアントサイド分析へのランタイム依存を避けてください。静的アセットをバンドルし、安全なシステムフォントフォールバックを使用してください。キーをコミットしたり、APIシークレットをフロントエンドコードに含めたりしないでください。結果は決定論的にしてください。デフォルトでは課金/コードなし。
4. 機能と中国本土対応を検証する
パスを調整して実行:
python3 <skill-root>/scripts/validate_quizzes.py <website>/src/data
python3 <skill-root>/scripts/audit_mainland_assets.py <website>
cd <website>
npm install
npm test
npm run build
その後、手動でイントロ、戻る/進む、リフレッシュ/再開、複数の結果パス、共有PNG/URL、モバイルレイアウト、コントラストを確認してください。references/qa.md を参照してください。実行しなかったチェックを主張しないでください。実際の中国本土ネットワークでのテストなしに、中国本土でのアクセス可能性を主張しないでください。
5. 引导上线 — コードをGitHubに公開し、Cloudflare PagesでWebサイトをデプロイする
ローカルプレビュー後、GitHubがコードを保存し、Cloudflare Pagesがサイトをオンラインでアクセス可能にすることを平易な言葉で説明してください。ツールができない場合は、アカウントまたはダッシュボードの手順を案内してください。ローカルのみのリクエストを尊重し、すでに許可されている場所で再度の認可を求めないでください。references/publishing.md に従ってください。デフォルトのルート: 生成されたサイト用の別のGitHubリポジトリ → Cloudflare Pages Gitに接続 → Vite/React npm run build / dist / プロダクション main → デプロイ → プロモーション用のカスタムドメインを設定 → HTTPSをテスト / 準備完了を主張する前に中国本土ネットワークからロード。スターターのGitHub Actionはチェックのみであり、CloudflareのGit統合がデプロイを処理します。
ユーザーがスキル自体をGitHubに公開したい場合は、このクロスエージェントスキルリポジトリを別途公開してください。ユーザーの意図と利用可能な認証なしに、アカウントを作成したり、ドメインを購入したり、リポジトリを接続したり、プッシュしたり、デプロイしたりしないでください。利用できない場合は、実行可能なコマンドとダッシュボードの手順を提供し、偽の「公開済み」主張をしないでください。Cloudflare Pagesの標準グローバルプランは中国本土での到達性を保証できません。ハード要件がテストに失敗した場合は、準拠した中国本土ホスティングオプション/ICPを適宜推奨してください。Cloudflareのエンタープライズ中国ネットワークと無料Pagesを混同しないでください。
製品原則
AI 负责拓展创意的可能性,用户负责决定作品的独特性,AI 负责把决定变成现实。(AIはアイデアの可能性を広げ、ユーザーは作品の独自性を決定し、AIはその決定を現実にします。)クリエイティブな選択は委任されない限りユーザーに属し、日常的な技術的実行はエージェントに属します。「配色你来决定(配色はあなたが決めて)」のような狭い委任は、その決定にのみ適用され、残りのすべての段階には適用されません。
核心不変条件
- 到達可能で区別可能な結果を持つ正確なアルゴリズム。要求されない限りランダム結果なし。
- 偽の臨床的妥当性なし。無条件の「中国アクセス可能」の約束なし。
- 要求されていないバックエンド、ログイン、トラッキング、課金、コードゲート、機密データ収集なし。
- コード共有はデプロイではない。新しいクイズWebサイトは独自のリポジトリとドメインを持つべき。
- フロントエンドのみのコードロックは安全ではない。アクセスコードゲートが要求された場合は、サーバーサイド検証とシークレット結果の処理をアドバイスし、オプションとして維持すること。
- ユーザーの既存のブランディング、ビジュアル、事実、選択に従うこと。
呼び出し例
-
「quiz-site-builder で宮廷サバイバルテストを共同作成したい。まずいくつかのクリエイティブな切り口を見せて。」
-
「10問のオリジナル宮廷サバイバルテストを直接作成し、ローカルプレビュー。デプロイは不要。」(ワンクリック生成)
-
「$quiz-site-builder を使って、国風パーソナリティテストを作って。六衡分析、器物パーソナリティ、モバイル対応、Cloudflare Pagesにデプロイ。」
-
「10問のオリジナル宮廷サバイバルテストを作成。分岐エンディング、3:4結果カード、GitHubに公開後Cloudflareで自動公開。」
-
「テストサイトを中国本土ユーザー向けに準備して。海外フォントやCDNに依存せず、カスタムドメインのバインド方法とアクセス確認を教えて。」
-
「今は課金やカードコードは不要。後でカードコードを拡張する方法だけ教えて。」
クロスエージェント実行ルール
references/quiz-design.mdやassets/starter/のようなすべての指示パスは、このSKILL.md(<skill-root>)を含むフォルダからの相対パスであり、ハードコードされたCodexディレクトリからの相対パスではありません。- 現在のホストエージェントが実際に提供するファイル操作、シェル、ブラウザ機能を使用してください。
apply_patch、Codexツール、特定のMCPサーバーが存在することを想定しないでください。ツールがない場合は、ポータブルなコマンドまたは手動の手順を提供し、未完了のステップを明確にマークしてください。 - プロジェクトのソースオブトゥルースは
skills/quiz-site-builder/です。スキルロジックをプロバイダ固有のコピーに複製またはフォークしないでください。アダプターのインストールは同じフォルダをコピーするだけです。 - Codexの呼び出しでは
$quiz-site-builderを使用する場合があります。WorkBuddy、Claude Code、CodeBuddy Code、その他のエージェントはスキルピッカーまたは通常の言語を使用できます。Codex以外で$構文を要求しないでください。 - エージェントがスキルをインポートしただけで機能をサポートしていると主張しないでください。ローカルファイルアクセス、Python、Node/npm、Git、およびデプロイ手順を実行する前に認証機能を確認してください。
- WorkBuddyのインポートは、
quiz-site-builder/SKILL.mdフォルダルートを持つzipを使用します。WorkBuddyはそのフォルダからreferences/、scripts/、assets/をロードする必要があります。ホストサンドボックスがスクリプトの実行を防ぐ場合は、制限を説明し、それでも静的サイトコードを生成してください。
ホストごとのデプロイ制約
エージェントに関係なく: GitHubがソースを保存し、Cloudflare Pagesがデフォルトのデプロイ先です。ユーザーが認可できる場所ではCloudflare Git統合を使用してください。オプションのカードコードアーキテクチャはガイダンスのみです。黙ってペイウォール、課金、または秘密を含むフロントエンドチェックを追加しないでください。中国本土へのアクセスには実際のテストが必要であり、標準のCloudflare Pagesまたはカスタムドメインでは保証できません。