jigx

Jigx Core SDK

Jigx アプリのコードを記述または変更する前に、このスキルを使用してください。タスクに必要なリファレンスファイルだけを読みます。

ワークフロー

1. 変更するアプリの領域を特定します：データソース、フォーム、ナビゲーション、タブ、メディア、PDF、JavaScript 関数、検証、またはビルド／デプロイ。

2. references/recipe-index.md を読み、次に該当領域の具体的なリファレンスファイルを読みます。

3. ローカル優先の動作を維持します：まずユーザーの作業をローカルに保存し、その後、明示的なアクションからリモート処理または生成処理を実行します。

4. 親子フローでは、安定したローカル ID を使用します。子画面を開く前に親 ID を生成し、入力を通じて渡します。

5. 生成された YAML と TypeScript の整合性を保ちます。SDK の出力が曖昧な場合は、実行時の動作を推測する前に、生成された YAML を確認します。

6. 新しいパターンを学んだら、実装と同時に、または実装前に、該当するリファレンスを更新します。

7. 新しいソリューション、またはフォーム／同期／送信の一連の流れを変更する場合は、実装前に references/runtime-verification.md を読みます。公開前に、そこに記載された生成チェッカーを実行し、影響を受ける対象アプリの一連の流れを検証します。 コンパイルできただけでは、動作が機能することの証明にはなりません。

リファレンスマップ

• references/recipe-index.md - 各リファレンスを読むタイミング。

• references/app-architecture.md - プロジェクト構成、定数、ビルド／デプロイの順序。

• references/datasources.md - ローカルテーブル、SQL、JSON 抽出、検索、更新。

• references/forms-state-navigation.md - フォーム、保存アクション、変更状態、入力、親子 ID、コピーのフロー。

• references/tabs-sections-lists.md - タブ付きワークスペース、セクション、リスト項目、スワイプアクション、ヘッダーアクション、下部アクション。

• references/media-pdf-javascript.md - メディアフィールド、ファイルパス、HTML／PDF 生成、スクリプト、共有／再生成フロー。

• references/jsonata-validation-formatting.md - JSONata、検証、書式設定、ドロップダウン、アイコン、フィールドの規約。

• references/runtime-verification.md - 生成チェック、デバイス上の一連の操作、デバッグの証拠、検証に関する主張。

ガードレール

• シークレット、トークン、組織 ID、または顧客固有の認証情報をハードコードしないでください。
• アプリが直接送信のフローを明示的に使用している場合を除き、主要な保存アクションから外部 API を呼び出さないでください。
• 読み取り時の更新と書き戻しの境界を曖昧にしないでください。オフライン対応の書き込みは、ユーザーに表示されるアクションから処理する必要があります。
• デバイスローカルのファイルパスを、デバイス間で利用できるかのように保存しないでください。
• 親または子のレコードを保存する際に、安定した画面入力の代わりとして jig state を使用しないでください。
• 生成された YAML が意図どおりだと決めつけないでください。動作が不明確な場合は確認してください。