スキル自身の言葉で
既存のプロダクトを文書化された設計コントラクトに変換します。リポジトリモードでは、ローカルプロダクトのトークン、テーマ、共有プリミティブ、レンダリング済みルートを調査し、そのプロダクトのルートに DESIGN.md を書き出します。URL モードでは、DOM、算出スタイル、読み込まれたスタイルシートからデスクトップ幅とモバイル幅でドラフトを再構築します。
両モードは、role、value、source、scope、recurrence、confidence という1つのエビデンスパイプラインと、css-tailwind、json-tailwind、dtcg のいずれかのエクスポート対象を持つ1つのフラットなトークンスキーマを共有しています。値は、根拠となるソースが名指ししているか、三段階の証明ゲートを通過した場合のみ残り、lint とエクスポートが成功するまで文書はリリースされません。変更されるのは DESIGN.md のみです。
生成されるもの
- URL モードで、現在のワークスペースに書き出される、ドラフトとして明示された再構築版 DESIGN.md ドラフトです。
- モードと調査対象のプロダクトまたは URL、使用した根拠ソース、文書から除外された競合や根拠不十分な領域を列挙したレポートです。
- 文書が返される前に両方成功する必要がある、最終的な lint とエクスポートの結果です。
仕組み
- 01モードを選択する
ローカルのプロダクトリポジトリが利用可能な場合はリポジトリモードを使用し、そのプロダクトのルートに DESIGN.md を書き出します。公開 URL のみが与えられている場合は URL モードを使用し、現在のワークスペースに再構築されたドラフトを生成します。
- 02エビデンスを収集し、出典を記録する
各候補は、正規化される前にソース、スコープ、再現性とともに記録されるため、両モードは同じ記録パイプラインに流れ込みます。
- 03DESIGN.md スキーマへ正規化する
不確実な候補、コントラクトのないローカルな候補、実装に関係のない候補は除外され、残りは正規のフラットなトークンスキーマへマッピングされます。
- 04検証を通過するまでドラフトをゲートする
Markdown は、解析済みの frontmatter が形式チェックに合格した後にのみ書き出されるため、本文が先に書かれてから YAML に後付けされることはありません。
- 05Lint とエクスポート
まず構造的な lint が実行され、次に選択したターゲットで1回の互換性エクスポートが行われます。データが入っているカテゴリはすべて出力に含まれる必要があります。
- 06モード、ソース、ギャップを報告する
レポートには、モードと調査対象のプロダクトまたは URL、使用した根拠ソース、根拠不十分として省略した項目、そして lint とエクスポートの結果が記載されます。