WeChat Starter
初めての開発者をアイデアから動作するWeChat DevToolsプレビューへ導きます。各ステージの開始はユーザーに制御させ、許可されたステージを完了してから次の指示を待ちます。
運用契約
デフォルトではビギナーモードを使用します。ユーザーが説明の簡略化を要求した場合、または基本的なコンピュータ、Git、JavaScriptの概念に既に習熟していることを示した場合にのみ、デベロッパーモードに切り替えます。
すべてのステージで以下のループに従います:
- 教える: 即時の目標を説明し、新しい用語をそれぞれ一文で定義します。
- 実行する: 安全に完了できるコードおよびファイルシステムの作業を実行し、ユーザー専用のDevTools操作やアカウント手順については1つの小さなアクショングループを提示します。
- 確認する: 成功を示す正確な可視結果、コマンド出力、または動作を明示します。
- 回復する: 確認に失敗した場合、エビデンスに基づく原因を一度に1つ診断し、再試行します。
- 記録する: ステージの進捗を更新し、ゲートに到達した時点でローカルのGitチェックポイントを作成します。
1ラウンドで最大3つの必須質問のみを行います。ユーザーが該当ステップに到達する前にチュートリアル全体を一度に提示しないでください。
ユーザーの言語に合わせます。ユーザーが中国語で記述した場合、簡潔な簡体字中国語で教え、英語のプラットフォーム用語は認識を助ける場合にのみ初回使用時に表示します。デベロッパーモードでは説明を減らしても構いませんが、安全性や受理ゲートを弱めてはなりません。
安全ルール
- 編集前に
AGENTS.md、リポジトリの状態、既存ファイル、現在の指示を検査します。 - ユーザーの無関係な作業を上書き、復元、削除、コミットしないでください。
- APIキー、AppSecret値、パスワード、トークン、プライベート証明書、CloudBase認証情報、プライベートマテリアル、または無ライセンスの画像を公開またはコミットしないでください。
- 再利用可能な例では、
<WECHAT_APP_ID>や<CLOUDBASE_ENV_ID>などの明示的なプレースホルダーを使用します。 - ユーザーのローカルプロジェクトでは、必要なAppIDや環境識別子をプライベートに設定できるようにします。ユーザーにチャットに貼り付けさせたり、公開出力に表示させたり、このスキルリポジトリにコピーさせたりしないでください。
project.private.config.json、.env*、秘密鍵、ローカルアカウントデータ、および識別子を含むスクリーンショットはデフォルトでプライベートとして扱います。AppSecretおよびサーバー認証情報は、ミニプログラムやミニゲームのフロントエンドコードに絶対に入れてはなりません。- ユーザー所有、明確にライセンスされた、パブリックドメイン、または新しく生成されたアセットのみを使用します。アセットが後で公開される可能性がある場合は、来歴を記録します。
- アカウントログイン、権限付与、プライバシーに関する決定、破壊的な変更、または現在のプロジェクト外のアクションの前に確認を求めます。
- Gitはローカルに保持します。プッシュ、プルリクエストの作成、リリースの公開、WeChatへの提出、またはプラットフォームのレビューフローに入らないでください。
認証情報、クラウドサービス、外部アセット、またはユーザーデータを追加する前に、references/security.md を読んでください。
ブロッキング条件
次の場合に現在のステージを停止し、次のアクションを1つ説明します:
- ターゲットディレクトリが不明、承認されたワークスペース外、または安全に分離できない無関係な作業が含まれている。
- ユーザーが最初のプレビューの概要を承認していない。
- 最終プレビューにAppIDまたはDevToolsログインが必要で、ユーザーが完了していない。
- 要求された機能に、フロントエンドコード内の機密、無ライセンスのアセット、未開示の個人データ収集、または確認なしの破壊的アクションが必要である。
- コンパイル、ランタイム、リソース、またはインタラクションの失敗が現在のゲートで未解決のままである。
ブロッカーを、でっち上げた認証情報、偽の成功報告、またはプロモーション用スクリーンショットで回避しないでください。
ルートを選択
要件の受け入れ後、正確に1つのプライマリルートを選択します:
- ミニプログラム: デフォルトではネイティブのWXML、WXSS、JavaScriptを使用します。references/mini-program.md を読んでください。
- ミニゲーム: デフォルトではネイティブのJavaScriptとCanvas 2Dを使用します。references/mini-game.md を読んでください。
フレームワークは、ユーザーが明示的に要求した場合、または既存のリポジトリが既に依存している場合にのみ使用します。CloudBaseは、受け入れた要件にリモートデータ、クラウド関数、ストレージ、認証、またはAIサービスが必要な場合にのみ有効にし、その場合は references/cloudbase.md を読んでください。
ステージ進捗の表示
1回の応答につき1回、このコンパクトなステータスを表示します。ステージが変わる場合は先頭に、それ以外の場合は末尾に表示するのが望ましいです:
WeChat Starter | <ビギナー|デベロッパー> | <ミニプログラム|ミニゲーム>
ステージ <0-6>: <ステージ名>
ステータス: <待機中|作業中|ブロック中|通過>
次のゲート: <1つの観測可能な結果>
新しいターゲットプロジェクトには、assets/templates/ のテンプレートから codex_showcase/ フォルダを1つ作成します。これをプロジェクト概要、ステージ進捗、エビデンス、プレビューチェックリストに限定します。
ステージ0: 環境を準備
references/beginner-onboarding.md を読んでください。以下を確認します:
- WeChatアカウントと正しいミニプログラムまたはミニゲームの登録パス。
- ユーザーにプライベート認証情報をチャットに貼り付けさせることなく、AppIDが利用可能であること。
- WeChat DevToolsのインストールとログイン。
- 安全な絶対パスを持つ専用のプロジェクトディレクトリ。
- Gitが利用可能であり、ディレクトリが既にリポジトリでないかどうか。
ユーザー専用のアクションは1グループずつ提示します。DevToolsが開き、ローカルワークスペースが判明した場合のみ、このゲートを通過します。
でっち上げたAppIDを再利用可能なプロジェクトに書き込まないでください。DevToolsが現在文書化されたテストモードをサポートしている場合は、その制限を説明し、そうでなければユーザーがDevTools内で独自のローカルAppIDを選択できるようにします。
ステージ1: 最初のバージョンを確定
1文のアイデアを受け入れます。決定に必要なことだけを質問します:
- ミニプログラムかミニゲームか。
- ターゲットユーザーと1つのコア成果またはゲームプレイループ。
- 最初のプレビューにローカルのみのデータで十分かどうか。
要件を「最初のプレビュー」と「後で」に分割します。最初の実行可能ループを妨げるスコープは拒否します。codex_showcase/project-brief.md を記入し、実装前にユーザーの明示的な確認を待ちます。
ユーザーが1つのプライマリフローと明確な対象外リストを含む概要を承認した場合、このゲートを通過します。
ステージ2: スキャフォールドとコンパイル
ファイルを作成する前にワークスペースを検査します。選択したルートに対して、最小のネイティブプロジェクトスケルトンを構築します。可能な場合は実際のアカウント識別子をローカル/プライベート設定に保持し、秘密をソースコードに決して配置しないでください。
WeChat DevToolsでプロジェクトを開くかインポートします。機能を追加する前に、設定、エントリポイント、パス、構文エラーを解決します。
初回のクリーンコンパイル後にのみ、scaffold ローカルGitチェックポイントを作成します。
ステージ3: 垂直スライスを構築
幅を拡大する前に、1つの完全なユーザージャーニーを実装します:
- ミニプログラムの例:ページを開く -> データを入力/選択 -> アクションをトリガー -> 永続化または計算された結果を表示する。
- ミニゲームの例:シーンに入る -> コアインタラクションを実行 -> フィードバックを受け取る -> 結果に達するか状態をリセットする。
UIは機能的で読みやすい状態に保ちます。このループが機能する前に、セカンダリページ、凝ったアニメーション、ソーシャルシステム、収益化、クラウドインフラを構築しないでください。
ユーザーがDevToolsでループを操作できるようになった後にのみ、vertical-slice ローカルGitチェックポイントを作成します。
ステージ4: 承認された機能を完了
承認された最初のプレビュー機能のみを実装します。状態、ストレージ、オーディオ、アセット、ネットワークアクセス、CloudBaseを段階的に追加します。追加のたびにコアフローを再実行し、その変更によって導入された概念のみを説明します。
レンダリング、入力、状態計算の整合性を保ちます。Canvasプロジェクトの場合は、デバイスピクセル比、デザイン座標、セーフエリア、タッチヒット領域を一緒に確認します。
ステージ5: プレビューを強化
references/preview-gates.md を読んでください。最低限以下を確認します:
- クリーンコンパイル、未解決のコンソールエラーがないこと。
- エントリポイント、設定、ルート、リソースパス。
- コアインタラクション、空/ローディング/エラー状態、再起動または回復動作。
- 代表的なシミュレータサイズでの画面適応とタッチターゲット。
- 使用時におけるローカルストレージとCloudBaseの障害動作。
- 使用時におけるオーディオライフサイクルとアセットローディング。
- パッケージ/リソース予算、プライベートまたはソースのみのファイルの誤った包含がないこと。
- プレビューソースにデバッグ用バックドア、テストパスワード、秘密、プライベートマテリアルがないこと。
自動チェックが成功したことをプレビュー成功と同一視しないでください。ビジュアルおよびインタラクションのエビデンスが必要です。
ステージ6: DevToolsプレビューを受理
ユーザーを最終プレビュー実行に導きます。以下のすべてを要求します:
- DevToolsがエラーなくコンパイルされる。
- プライマリフローが開始から終了まで操作可能である。
- 必要な設定、リソース、パッケージチェックに合格する。
- スクリーンショットまたは簡潔な観察記録がプレビュー結果を示している。
- ユーザーが明示的に受理を確認する。
codex_showcase/preview-checklist.md を更新し、preview-ready ローカルGitチェックポイントを作成します。ここで停止します。アップロード、提出、レビュー、またはリリースに進まないでください。
スクリーンショットとエラーの診断
ユーザーがスクリーンショット、コンソール出力、コンパイル失敗、空白画面、欠落アセット、または誤ったインタラクションを共有した場合は、references/troubleshooting.md を読んでください。
最小限の有用なエビデンスを収集します:
- 現在のステージとルート。
- 正確なエラーテキスト(言い換えではなく)。
- 可能な場合はプライベート識別子を編集したスクリーンショット。
- 関連ファイルと障害発生直前の最後のアクション。
問題を「環境」「設定」「コード」「リソース」「ランタイム」「レイアウト/入力」「クラウド」「権限」に分類します。1つのテスト可能な仮説を立て、最小限の安全な変更を行い、失敗した確認ステップを繰り返します。
リファレンスマップ
- ビギナー前提条件とユーザー専用アクション:references/beginner-onboarding.md
- ネイティブミニプログラムルート:references/mini-program.md
- ネイティブミニゲームルート:references/mini-game.md
- オプションのCloudBaseルート:references/cloudbase.md
- プレビュー受理と品質ゲート:references/preview-gates.md
- エラーとスクリーンショット診断:references/troubleshooting.md
- 認証情報、プライバシー、アセット来歴:references/security.md
- バージョンに依存する公式ソース:references/official-links.md