datex-studio-runtime について
Datex Studioのランタイム仕様と実行モデルを参照するスキルです。コンポーネント作成スキルが必要な文書を参照できる索引を備え、ワークフローではなくライブラリとして機能します。
主な機能
- 01ランタイム文書の索引
- 02プラットフォーム注入グローバルの説明
- 03実行階層と呼び出し規則の記録
- 04コントロール種別と設定の解説
- 05スケジュールジョブAPIの参照
活用シーン
- 01flowコードで使えるランタイムグローバルの確認
- 02実行階層間の呼び出し制限の確認
- 03コントロール設定やジョブ仕様の参照
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ datex/ skills --skill datex-studio-runtimeインストール後、Claude Code で/datex-studio-runtimeを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
calling-conventions.mdcontrol-types.mdruntime-globals.mdscheduled-jobs.md詳細
Datex Studio — ランタイムのセマンティクスと実行モデル
このスキルはワークフローではなく、ライブラリです。Datex Studio のコンポーネント作成スキルは、相対パス(例:../datex-studio-runtime/calling-conventions.md)を使って、ここにあるファイルを参照します。npx skills / skills.sh で利用側のスキルと一緒にインストールできるよう、独立したスキルとして用意されています。これらのツールでは、隣接するスキルではないディレクトリはコピーされないためです。
このスキルが役立つ場面
Datex Studio のコンポーネント作成スキルに従っていて、そこからここを参照するよう指示された場合に使用します。親スキルで指定された参照ファイルだけを読み、ツリー全体を事前に読み込まないでください。
より具体的なスキルの対象になっていないランタイムに関する質問(例:「アクションから関数を呼び出せますか?」「データソースのティアルールは何ですか?」「$utils.isDefined のセマンティクスは何ですか?」「codeBoxConfig にはどのフィールドがありますか?」)を受けた場合は、以下の索引から適切なファイルを探してください。
参照索引
- runtime-globals.md — プラットフォームが注入するグローバルの参照表(プラットフォームがフローコード内で公開するすべての
$...グローバル、その構造とティア制限)および$utilsヘルパーの重要なセマンティクス(isDefinedはコレクションを考慮し、isDefinedTrimmedは空白を考慮します)。 - calling-conventions.md — 3 つの実行ティア(関数/アクション/UI コンポーネント)、ティアごとの呼び出し元→呼び出し先の許可/禁止マトリクス、データソースのティアルール、ストレージのティアルール(
$dbは関数ティアでのみ使用可能)、汎用 CRUD アクション一式(Utilities パッケージのcrud_create_entity/crud_update_entity/crud_delete_entity)。 - control-types.md — フォーム/エディター/ハブフィルター/グリッドセルにおける
controlConfig.typeの値、兄弟設定ブロックを null のままにするルール、../datex-studio-conventions/file-format.mdへの相互リンクによる宣言型文字列スロットのエンコード、$<container>.fields.<id>.control.<prop>のインターフェースを介したフローコードによる動的変更、詳細なcodeBoxセクション、および textBox、numberBox、dateBox、checkBox、selectBox、button、label、text、image、draw、progressBar、matrix の概要。 - scheduled-jobs.md —
$services.jobsの詳細:送信とスケジュールの API インターフェース(.submit、.schedule.create/update/list/activate/deactivate)、ScheduleConcurrency、スケジュール名の規律、冪等な初期化と有効化/無効化の切り替えによるライフサイクルパターン、同期/非同期ディスパッチャーパターン、バックグラウンドジョブ機能の事前チェックリスト。
スキル作成者向けの注意事項
Datex Studio の作成スキルからここにある内容を参照する場合:
- 相対パスでリンクします:
../datex-studio-runtime/<file>.md。 - 利用側の SKILL.md のフロントマターで依存関係を宣言します:
depends: - datex-studio-runtime
このスキルは、datex-studio-conventions(ファイル形式、命名規則、デフォルト設定を扱います)および datex-studio-shared(Datex Studio CLI の運用コンテキスト — ブランチの選択、Studio のライフサイクル、デザイナーコンテキストのナビゲーション、レポート作成を扱います)と並ぶスキルです。これら 3 つの共有参照スキルは、横断的なプラットフォームの知識を関心領域ごとに分担します。