dtcg-tokens について
dtcg-tokensは、確認可能なマルチモーダルの根拠から、ソース固有のDTCG 2025.10トークンファイルと証明成果物を作るデザインスキルです。決定的なMiseタスクと視覚判断を組み合わせ、必要な根拠や目視確認が欠ける場合は受け入れを止めます。
主な機能
- 01トークン、根拠、証明、実行記録の生成
- 02構造、値、参照、循環の検証
- 03単独で使えるHTML証明の作成
- 04視覚判断によるデザイン実験の比較
- 05ワークフローのゲートと根拠記録の追跡
活用シーン
- 01確認した視覚情報などの根拠からデザイントークンを作成
- 02DTCGファイルの構造や参照エラーを検査
- 03受け入れ前にソース固有のトークン証明を確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ srinitude/ skills --skill dtcg-tokensインストール後、Claude Code で/dtcg-tokensを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
.github/workflows/ci.ymlassets/creative-source-frontier.jsoncurrent-date-policy.jsondecision-records.jsondtcg-format-2025.10.schema.jsonevidence-template.jsonexecution-io-map.jsonexecution-step-contract.jsonexperiment-contract.jsonexploration-strategy-catalog.jsonfile-trigger-policy.jsongoogle-font-policy.jsonimprovement-contract.jsoninvocation-receipt-template.jsonjudgment-review-catalog.jsonmise-primitives-catalog.jsonmise-primitives.jsonmultimodal-input-catalog.jsonoriginality-analysis-contract.jsonassets/exploration-corpus/concepts.jsonconstraints.jsonmanifest.jsonmechanisms.jsonnegative-patterns.jsonoperators.jsonprimitives.jsonquestions.jsonsynthesis-contract.jsontechnology.jsonthemes.json詳細
dtcg-tokens
成果
検査可能なマルチモーダルのソース証拠を、ソース固有の DTCG 2025.10 JSON、証拠 JSON、単体で動作する HTML の証明アーティファクト、実行記録に変換します。まずトークンの可能性を広く洗い出し、位置を特定した証拠と素材の実験によって絞り込み、現在のレンダリングピクセルを人の目で判断した後にのみトークン値を採用します。ソース、対象者、製品に関する事実、ブランドの前提、比較対象コーパス、証明の主張を決して捏造しません。
動機
構造的に有効なトークンファイルでも、汎用的で、誤解を招き、アクセシビリティに欠け、凡庸で、視覚的に劣る可能性があります。再現可能な仕組みは決定論的な Mise タスクに任せ、優れたネイティブの視覚能力は、ソースの解釈、トークン間の関係、創造的な実験、人間の目・脳・触覚による判断、最終的な視覚的受け入れに集中させます。
コマンド
| コマンド | 結果 | 担当タスク |
|---|---|---|
help | 入力、意図、出力、視覚要件、主張の制限を表示します。 | mise run token-help |
generate <inputs> | <name>.tokens.json、<name>.evidence.json、<name>.proof.html、<name>.run.json を生成します。 | mise run token-run -- <args> |
validate <tokens> | DTCG 2025.10 の構造、値、名前、参照、型の整合性、循環参照を検証します。 | mise run token-validate -- <tokens> |
prove <tokens> <evidence> [sources] | ソース固有の単体で動作する証明を組み立て、検査し、読み戻します。 | mise run token-prove -- <args> |
examples/help.md、examples/generate.md、examples/validate.md、examples/prove.md は、それぞれ対応する mise run token-help、mise run token-run、mise run token-validate、mise run token-prove の操作を通じてのみ読み込みます。examples/failure-global-claim.md は、絶対的な唯一性を求められた場合に限り、mise run evals を通じて読み込みます。
パッケージの保守では、references/generation-contract.md を mise run validate を通じて読み込みます。references/resource-and-experiment-design.md と assets/improvement-contract.json は mise run improvement-policy を通じて、references/use-case-specificity.md と assets/use-case-contract.json は mise run use-case-policy を通じて、assets/invocation-receipt-template.json は mise run invocation-policy -- <receipt> を通じて読み込みます。Mise を利用できない場合は BLOCKED を返します。非公開の実装ファイルを直接呼び出してはいけません。
パッケージ構成
| パス | 内容 | 読み込みまたは実行するタイミング |
|---|---|---|
references/ | 条件付きトークン手順、判断、視覚的レビュー方法。 | mise run token-packet -- <args> が返す正確な相対パスを読み込みます。 |
assets/ | DTCG スキーマ、カタログ、ポリシー、契約、マニフェスト、フィクスチャ。 | mise run token-packet -- <args> または担当するポリシータスクから返される正確なパスを読み込みます。 |
assets/exploration-corpus/ | 範囲を限定した探索用語彙と統合制約。 | mise run validate-exploration またはそのパケットを通じて読み込みます。 |
evals/ | トリガー、動作、失敗、復旧、系譜、評価基準の記録。 | mise run evals または Step 24 のパケットを通じて読み込みます。 |
evals/files/ | 実際のトークン、証拠、ブリーフ、マニフェストのフィクスチャ。 | mise run evals または担当する検証・証明タスクを通じてのみ読み込みます。 |
examples/ | 検証済みのコマンド例と、範囲を限定した失敗例。 | 対応する公開コマンドタスクまたは mise run evals を通じて読み込みます。 |
mise.toml | 唯一のタスクグラフ、キャッシュポリシー、依存関係の担当箇所。 | 公開操作またはパッケージゲートを実行します。 |
.github/workflows/ | リモート CI の経路。 | リモート CI は mise run ci のみを呼び出します。 |
ディレクトリ名を指定しただけでは、ファイルは読み込まれません。担当する Mise タスクが返す正確な相対パスを使い、現在の判断に必要な場合に限って読み込んでください。
ファクトリーの統制
パッケージを変更するたびに、最新の skill-factory 更新モードを使用してください。書き込みを始める前に、その mise run plan-standardize -- /absolute/path/to/dtcg-tokens を実行し、ベースラインのダイジェストをパッケージの外に保存して、REDを確認してください。その後、DTCGチェックに加え、ファクトリーの mise run validate-target -- /absolute/path/to/dtcg-tokens、mise run eval-target -- /absolute/path/to/dtcg-tokens、mise run invocation-policy -- <receipt> を実行してください。最後にメンテナンスを実行してください。レシートが不足している場合、更新は無効になります。
Mise のライフサイクル契約
受け入れ前に、mise run domain-research-policy、mise run use-case-policy、mise run mise-primitives-policy、mise run primitive-lifecycle-policy、mise run task-graph-policy、mise run decision-policy を実行してください。すべてのドメインのアクター、オブジェクト、アクション、状態、ルール、バリアント、インターフェース、権限、障害、復旧、証拠、時間、リソース、品質、用語、除外事項を対応付けてください。発見から廃止まで、すべてのスキル本文、リファレンス、アセット、実装、テスト、Miseタスク、例、評価、ポリシー、スキーマ、記録を対応付けてください。
すべてのタスクを、1つのデフォルトパス上で処理してください。適用されないタスクにはそれぞれ、現行トークン固有の証明を用意し、mise run invocation-policy -- <receipt> で検証してください。成果物の作業中はMiseを固定してください。受け入れ後に mise run mise-primitives-update を実行し、mise run ci を再実行して、バージョンとカタログのダイジェストを記録してください。
トークン設計契約
順序、証拠、状態、ゲート、主張の上限は決定論的に保ってください。ソース、意図、トークンの内容、ビジュアル言語、見本、インタラクション、レンズ、素材の実験はオープンに保ってください。入力タイプが省略されている場合は、mise run token-packet -- <args> を通じて references/extension-protocol.md を読み込んでください。mise run font-prepare -- <args> を通じて references/google-font-selection.md を読み込んでください。各フォントファミリーは、同じ日付のGoogle Fontsカタログで人気上位50%の外にランクされ、ビジョンレビューに合格する必要があります。
正しさ、ソースの網羅性、創造性の幅、証明が確定した後で、経過時間を最適化してください。進捗として認められるには、担当者の変更と読み戻しの両方が必要です。計画、キューに入れた作業、実行中のコマンド、未確認の出力は進捗に数えません。独立した作業はまとめてください。書き込みとビジョンに関する判断は直列化してください。
トークンまたは関係性が合格する前に、mise run token-packet -- <args> を通じて references/controlled-comparisons.md を読み込んでください。実質的に異なる実験は、目視する前に登録してください。条件、仮説、帰無仮説、測定方法、反証条件、判断ルールを固定してください。依頼された場合、または欠陥や必須のしきい値に関連する場合を除き、微調整は却下してください。最新の視覚、認知、触覚の判断を用いて、正規の作成に進む前に採用案を確定してください。
保持するすべてのプリミティブと関係性について、user_task、focus_target、focus_location、focus_timing、focus_mechanism、focus_reason、attention_sequence、competing_signals、defocus_and_recovery、failure_evidence を含むフォーカス意図の記録を作成してください。注意の順序がピクセルに表れている必要があります。トークンが担うのは顕著性の容量であり、プロダクトのフォーカスではありません。プロダクトレベルでフォーカスが成功したことを証明するものではありません。
ポートレートとランドスケープは、モバイルとタブレットの別々のコンテキストとして扱ってください。両方を証明するか、使用しない理由を説明してください。回転によって到達範囲、安全領域、折り返し、密度、間隔、顕著性のいずれかが変わる場合に限り、向きに関する関係性を追加してください。変更があれば、両方とも無効になります。
複数ページにわたるデザイン成果物では、正規の配置先とネイティブの系譜を記録してください。誤ったページへの配置、重複、孤立、古い配置、または視覚的に却下された配置は BLOCKED です。スタンドアロンの生成にデザインアプリは不要です。Figmaの所有権は、そのライフサイクルを担うスキルに留めてください。
測定済みのゲートを通過した後は、直接的な視覚証明を最も権威ある視覚的根拠としてください。同じ強力なビジョン対応エグゼキューターが、変更や無効化の前後に、現在の全体ビューと詳細を、すべての状態、ビューポート、入力経路にわたって検査します。構造、メタデータ、測定値、ハッシュ、未確認のキャプチャ、他者の判定によって、視覚的な PASS を与えることはできません。目視できない場合は BLOCKED です。
デザインアプリケーションのコンピューター操作監査では、項目を判断する前に、最優先の視覚的証明ルールを適用します。同じ呼び出し元の、強力な視覚機能を備えた実行者が、利用可能な該当するすべての視覚機能と、プラットフォームに依存しないローカルのアプリケーション制御機能を使い、Figma を含むアクティブなデザインアプリケーションを操作し、各変更の前後に直接確認する必要があります。Figma のライフサイクル監査では、Figma スキルの最新の合格レシートと、項目単位のソース判定も必要です。必要な視覚確認、状態確認、または制御経路が利用できない場合、その項目は BLOCKED です。この監査以外では、このトークンスキルだけで動作し、アプリケーション制御や特定製品専用のプロバイダーを必要としません。
変更作業中は、各トークンキャンバスを常に整理された状態に保ちます。作成を始める前に、mise run token-packet -- <args> を使って references/qualitative-judgment.md を読み込みます。キャンバス全体とアクティブ領域を確認し、正規、探索中、却下済み、過去の作業を分けます。重なり、切り抜き、積み重ね、残留物、順序の不備、到達できない対象、古くなった証拠を明らかにします。クリーンアップでは移動、ラベル付け、隔離のみを行い、権限なく証拠を消去してはいけません。変更前後のレシートを必須とします。
ゼロトラストから始めます。継承されたトークン、主張、証拠、標本、判定は、最新の証明によって PASS を得るまで STALE とします。まず確認し、合格しているものは維持し、新しさを求めて正しい作業を変更してはいけません。結果は測定値または直接の判断に結び付けます。完璧だと主張してはいけません。
機械的な操作はすべて Mise 管理のタスクに委ねます。Mise タスクは判断を補助しますが、判断そのものを行いません。mise run token-run -- <args> は 25 件のレコードを作成します。mise run token-packet -- <args>、mise run token-start -- <args>、mise run token-pass -- <args>、mise run token-block -- <args> は状態遷移を管理します。定性的な判断は、強力な視覚機能を備えたモデルが担います。強力な視覚機能がない場合は、すべての判断を委任し、その経路に合格するまでトークンや証拠を生成してはいけません。
順序付きワークフロー
- トークンの結果を確定します。 Mise:
mise run token-run -- <args>を実行します。モデル:ソース、意図、対象者、成果物、対象外項目、証明の限界を定めます。分岐:依頼に応じて、ヘルプ、検証、生成、証明のいずれかを選びます。 - 準備状況とソースの権威性を証明します。 Mise:
mise run token-packet -- <args>を実行します。モデル:現在のソース証拠を調べ、すべての記述を分類します。条件:必要なソース、権威性、またはビジョンへの経路が不足している場合は、mise run token-block -- <args>を実行し、その主張を中止します。 - 絞り込む前に展開します。 Mise:
mise run token-explore -- <args>を実行します。モデル:ソースに即した実質的に異なる方向性を作成し、有力な仮説に反証を試みます。各項目について:該当するすべてのトークンファミリー、コンテキスト、除外事項、反例をそれぞれ一度記録します。 - 重要な実験を実施します。 Mise:
mise run validate-explorationを実行します。モデル:条件を固定し、目、脳、触覚による直接的な判断で、大きく異なる案を比較します。繰り返し:未解決の要素は、いずれかの方向性が確定するか、現実のブロッカーによってループが停止するまで実験に戻します。 - 上位で使用する前に下位の所有者を確定します。 Mise:実験の記録によって問題が解決した後に限り、
mise run token-pass -- <args>を実行します。モデル:依存するアトム、分子、オーガニズム、テンプレート、画面を作成する前に、承認済みのトークンプリミティブと関係性を確定します。条件:下位の所有者が変わった場合は、依存するすべての証明を無効にし、最初に影響を受けるステップに戻ります。 - トークンを作成し、検証します。 Mise:
mise run token-validate -- <tokens>を実行します。モデル:ソースに裏付けられた値のみを作成し、すべての省略、エイリアス、関係性、例外を説明します。条件:適合性検証に失敗した場合は、最下位のトークン所有者を修正して検証を再実行します。 - 証明を組み立て、調査します。 Mise:
mise run token-prove -- <args>を実行します。モデル:必要な状態、モード、入力、ビューポート、向きについて、現在の全体表示と判読可能な詳細のピクセルを調査します。各項目について:位置を特定できる証拠を用いて、視覚的な主張すべてを承認、却下、または保留します。 - 修正して統合します。 Mise:
mise run ciを実行します。モデル:構造、ソース、視覚、インタラクションに関する失敗を区別し、最下位の所有者を修正します。繰り返し:両方が成功するか、正確なブロッカーが記録されるまで、影響を受けるタスクと統合ゲートを再実行します。 - 返却または復元します。 Mise:
mise run token-status -- <args>とmise run invocation-policy -- <receipt>を実行します。モデル:成果物、証明、不確実性、限界を報告します。オプションの改善を保持する場合は、非回帰の契約に従います。停止:最初に完全に承認された状態で完了し、回帰が発生した場合は、最後に承認されたダイジェストを復元します。
実行
generate と prove は、25 のステップすべてを順番に実行します。help は何も作成せず、validate は適合性の証明のみを行います。mise run token-packet -- <args> は、正確な入力、出力、担当者、状態、再実行ルールを assets/execution-io-map.json、assets/execution-step-contract.json、references/deterministic-execution.md 経由でルーティングします。Step 01 から 08 は references/execution-intake.md 経由で、Step 09 から 17 は references/execution-build.md 経由で、Step 18 から 25 は references/execution-review.md 経由でルーティングします。mise run token-start -- <args> で開始し、mise run token-pass -- <args> または mise run token-block -- <args> で完了します。Step 12 では mise run token-validate -- <tokens>、Step 17 では mise run token-prove -- <args>、Step 24 では mise run ci、Step 25 では mise run token-status -- <args> を使用します。成果物だけでは、このスキルは完了しません。
| # | ステップ | 用途 | 生成物 |
|---|---|---|---|
| 01 | 凍結 | mise run token-run | 実行 |
| 02 | 棚卸し | mise run token-packet | 棚卸し |
| 03 | ビジョン | mise run token-packet | ビジョン |
| 04 | 観察 | mise run token-packet | 観察結果 |
| 05 | 分類 | mise run token-packet | 主張 |
| 06 | 反証 | mise run token-packet | 仮説 |
| 07 | 拡張 | mise run token-packet | ユニバース |
| 08 | 実験 | mise run token-packet | 試行 |
| 09 | コンテキスト | mise run token-packet | マトリクス |
| 10 | シグネチャ | mise run token-packet | シグネチャ |
| 11 | 作成 | mise run token-packet | トークン |
| 12 | 検証 | mise run token-validate | レポート |
| 13 | エビデンス | mise run token-packet | エビデンス |
| 14 | 証明 | mise run token-packet | 候補 |
| 15 | 独自性 | mise run token-packet | レビュー |
| 16 | カバレッジ | mise run token-packet | カバレッジ |
| 17 | 組み立て | mise run token-prove | 証明 |
| 18 | 検査 | mise run token-packet | ビジュアル |
| 19 | 不具合 | mise run token-packet | 不具合 |
| 20 | 不変条件 | mise run token-packet | 不変条件 |
| 21 | 判定 | mise run token-packet | 判定 |
| 22 | 修復 | mise run token-packet | 修復 |
| 23 | 読み戻し | mise run token-packet | バイト列 |
| 24 | パッケージ化 | mise run ci | 検証 |
| 25 | 返却 | mise run token-status | ステータス |
境界
- トークン数は品質の証拠ではありません。根拠のないトークンは評価を下げます。
- 準拠性、ソースへの具体性、センス、独自性、コーパス内での一意性、AI らしい粗雑さのなさ、不変条件、証明の完全性は、それぞれ別個の主張として扱います。
- トークン JSON ではレンダリング品質を証明できません。機械によるチェックではピクセルを認定できません。ビジョンによって計測された不具合を覆すことはできません。
- 実験的なトークンは、合格した使用主張がなくても残せます。証明では合格と同じくらい明確に、失敗や限界も明らかにする必要があります。
- センス、独自性、コーパス内での一意性、AI らしい粗雑さのなさを評価するには、
mise run token-packet -- <args>を通じてreferences/qualitative-judgment.mdを読み込みます。 mise run token-packet -- <args>を通じてassets/judgment-review-catalog.jsonを適用し、他の項目で補えないトークン単位のゲートとして使用します。ソースへの忠実性、意味上の役割、アクセシブルな範囲、間隔の関係、レスポンシブな動作、親しみやすさ、標準、一意性、レンダリングの証明は、それぞれすべて合格する必要があります。- 関連項目、インセット、グループ、セクション、シェル、広い開口部の間隔は、意味的な関係として扱います。規則的なスケール、珍しい値、ソースとの類似だけでは、適切なグループ化やリズムを証明できません。
- 再利用可能な証明構造はトークン証明スキャフォールドと呼びます。再利用可能な画面構造には
UI composition template、リポジトリのマッピング成果物にはCode Connect mapping templateを使用します。 - グローバルな一意性は、このスキルで正当に主張できる範囲外です。
完了条件
| ゲート | 完了とみなす条件 | 確認方法 |
|---|---|---|
| パイプライン | 現在の25件のレコードと所有者がすべて解決されている。 | mise run token-status -- <args> |
| 成果物 | .tokens.json、.evidence.json、.proof.html、.run.json の内容が一致している。 | mise run token-prove -- <args> |
| 準拠性 | 現在の DTCG バイト列が終了コード0で合格する。 | mise run token-validate -- <tokens> |
| 計上 | すべてのソース、意図、トークン、コンテキスト、拡張、除外がそれぞれ一度ずつ記載されている。 | mise run artifact-contract |
| 探索 | 3つ以上の実験を行い、重要な比較すべてに合格のロックが付いている。 | mise run validate-exploration |
| 具体性 | ソースに基づく5つの判断と、対象となるタイポグラフィがピクセルまで追跡できる。 | mise run font-prepare -- <args> |
| 視覚的な評価 | 現在のカバレッジ、読み取り結果、不具合、不変条件が合格し、未解決の拒否が0件である。globally_unique は false のままにする。 | mise run token-packet -- <args> |
| パッケージ | すべてのファイルにルートがあり、ファクトリーのレシートと mise run ci が合格する。 | mise run audit-files |
いずれかのゲートに失敗した場合、または証拠が不足している場合は、mise run token-block -- <args> を実行して BLOCKED を返し、失敗したゲートと正確な復旧要件をそれぞれ示します。また、AI らしい粗雑さのなさ、独自性、コーパス内での一意性、完了に関する主張は控えてください。
任意の最終ステップ
必須ゲートがすべて合格した後にのみ実行します。最後に受け入れられたパッケージ、評価器、フィクスチャ、環境、時間予算、反復回数、該当するリソース指標を固定します。名前を付けた1つの要素だけを、最小限の範囲で変更します。固定した入力に対して mise run improvement-policy、担当する DTCG タスク、mise run ci を実行します。その要素が大幅に改善し、正確性、経過時間、決定論的なカバレッジ、トークン効率、創造性の幅、実験の幅、直接的な視覚的評価、単純さ、移植性、安全性、現在の DTCG 契約が後退しない場合に限り、候補を採用します。それ以外の場合は、最後に受け入れられたバージョンとそのダイジェストに戻し、そのバージョンに対する限定的な証明を再実行します。採用、破棄、クラッシュのいずれかを編集可能なパッケージの外に記録します。