datex-studio-shared

Datex Studio — 共有リファレンス

このスキルはワークフローではなく、ライブラリです。他の datex-studio-* スキルは、相対パス（例：../datex-studio-shared/branch-setup.md）を使って、ここにあるファイルを参照します。npx skills / skills.sh で依存スキルと一緒にインストールできるよう、独立したスキルとして存在します。兄弟ディレクトリにあるスキルではないディレクトリ（旧 shared/）は、これらのツールではコピーされません。

このスキルが関連する場合

別の Datex Studio スキルに従っていて、そのスキルからここを参照するよう指示された場合です。親スキルで指定された特定のリファレンスファイルだけを読み、ディレクトリ全体を事前に読み込まないでください。

特定のスキルの対象範囲が決まっていない Datex Studio に関する質問（例：「dxs コマンド間でブランチ ID はどのように扱われますか？」「OData のページネーションパターンは何ですか？」）をユーザーから受けた場合は、以下のインデックスから該当するファイルを探してください。

リファレンスインデックス

スキル横断の運用コンテキスト

• configuration-roundtrip.md — すべてのコンポーネント作成／編集スキルで使う、dxs configuration get → 内側の .json を抽出 → 編集 → upsert という標準的な往復手順と、抽出手順によって防げるサイレント消去のバグ。信頼できる情報源はブランチです。JSON ファイルは一時的な作業用です。
• branch-setup.md — アクティブな組織、リポジトリ、機能ブランチ、API 接続の選択。明示的なセッション選択があれば再利用し、なければ確認し、決して推測しないという「ブランチ ID ポリシー」はここにあります。
• studio-management.md — Studio のライフサイクル：ステータス確認、準備完了の検証を伴うバックグラウンドでの起動、クリーンアップ。
• context-navigation.md — dxs -O json … context のレスポンスの取得と読み取り方法（バックエンドとフロントエンドのシンボルのフィルタリング）、およびカスタム型や列挙型メンバーを見つけるための nomenclature レジストリ（$types.<Package>.*）。
• flow-code-patterns.md — $utils.isDefined()、日付のデフォルト値設定、$shell.Reports.open{ref}()、OData のページネーション／5000 レコード上限パターン。

コンポーネントタイプ別リファレンス（専用の作成スキルがまだないもの）

• cards.md — カードコンポーネント（-card.json、cti 11）：リスト項目のリピーター基盤、$card の命令型インターフェース、フロー間呼び出し禁止の落とし穴とウィンドウヘルパーによる回避策、変更→イベント発行→更新のループ、インライン編集パターン、事前チェックリスト。
• lists.md — リストコンポーネント（-list.json、cti 14）：グリッドに対応するカードベースのコンポーネント。datasourceConfig／itemConfig の接続契約、$list インターフェース、レポートカードの更新、全文検索のプッシュダウン、事前チェックリスト。
• frontend-flows.md — フロントエンドフロー（-frontendFlow.json、cti 27）：関数に対応するブラウザー層のコンポーネント。誤った cti による失敗、$frontendFlows での静的ディスパッチのみというルール、参照渡しのオブジェクト inParams、ブラウザーのキーボード処理ルール（zone.js の __zone_symbol__ エスケープハッチ、KeyboardEvent.code と .key の違い、予約済みキーの組み合わせのブロックリスト）。

Datex アプリのデザインシステム（design-system/）

手書きの UI 向け Fluent 2 UI デザインシステムです。特に重要なのは、Datex のスタイルが自動で適用されないカスタム Angular コンポーネント（custom-angular-component-creator を参照）です。Claude Design の「Datex Studio App」システムをそのままミラーしたものです。由来と更新方法については、フォルダーの README を参照してください。

• design-system/README.md — ここにある内容、由来、更新手順。
• design-system/02-tokens.md — テーマトークン（16 進数カラーではなく var(--…) を使用）、ステータスカラー、タイポグラフィ、間隔、アイコンフォント。
• design-system/03-components.md — 組み合わせに使う実際の datex-* クラス名（ボタン、フィールド／フォーム、グリッド、カード、ウィジェット、ツールバー、タブ）。
• design-system/06-traps.md — 直感に反するコンパイル済み CSS の注意点。01-principles、04-patterns、05-voice-and-copy も参照してください。

RDLX-JSON レポート作成（report-authoring/）

report-creator と report-editor で使用します。

• report-authoring/design-standards.md — Datex のデザイン言語：カラーパレット、タイポグラフィ、テーブルのスタイル、フィールドのラベルと値のパターン、グリッドの配置、レポートのカテゴリ。
• report-authoring/json-structure.md — ドキュメントテンプレート、要素の JSON 形式、式のクイックリファレンス。
• report-authoring/design-patterns.md — 座標系、レイアウトパターン、要素のサイズ設定。
• report-authoring/cli-commands.md — 詳細な dxs report CLI 構文：一括操作、tablix、画像、データセット、設定／移動／削除、検証。
• report-authoring/sample-data.md — ライブプレビュー用の対応する .data.json ファイル。
• report-authoring/dataset-rules.md — DataSet 管理：CommandText のルール、コレクションの処理、日付の注釈、機密性プロパティ。
• report-authoring/deploy-patterns.md — アップロード、プレビュー、検証のパターン。
• report-authoring/troubleshooting.md — よくある RDLX-JSON と CLI のミスとその修正方法。

スキル作成者向けの注意事項

datex-studio-* スキルでこのコンテンツを参照する必要がある場合：

1. 相対パスでリンクします：../datex-studio-shared/<file>.md。
2. 利用側の SKILL.md の frontmatter で依存関係を宣言します：

   depends:
     - datex-studio-shared
   

   depends フィールドは vercel-labs/skills#860 に向けた先行的な目印です。この機能が提供されるまでは、利用側のスキルの README／インストール手順に依存関係を記載し、ユーザーに npx skills add … --all を実行するよう案内するか、両方の名前を明示的に列挙してください。