Craft は何をしますか?
概要
ビジュアルなものを作るための玄関口です。「料金ページをデザインして」を、完成されレビューされたデザインに変えます。プロジェクトのブリーフから作業を始め、すべての状態をカバーし、方向性が未確定の場合にのみオプションを提供し、デザインシステムの部品のみを使用し、結果を表示する前に自身の作業をチェックします。他のデザインスキルを決められたタイミングで呼び出しますが、それらを置き換えるものではありません。
使用するタイミング
- 「<ページ、画面、フロー、要素>をデザイン/作成/モックアップ/再デザインして」、
/craft(Claude Codeプラグインでは/craft:craft)。 - 複数のページを一度に(「オンボーディングをデザインして:ウェルカム、サインアップ、確認」)。
使用してはいけないタイミング
- ユーザーが正確に指定した小さな編集(値、ラベル、サイズが一つ):直接実行します。
- レビューのみ(「これの何が問題?」):
craft-critiqueを使用します。オプションのみ:craft-exploreを使用します。
開始前の準備
references/adapters/にあなたのツールにマッチするアダプターがない場合、あなたのツールで同じ動詞を実行し、手動でマッピングしたことを伝えてください。デザインツールがまったくない場合は、HTML(html.md)で構築します。画像しかない場合は、画像から読み取った値は概算であることを伝えてください。
ストップは現実のものです
ストップとは:あなたのターンを質問で終了し、待つことを意味します。これは常に可能であり、ワンショットやヘッドレスセッションでも、あなたの最後のメッセージが質問になります。セッションが「待てない」または「ラウンドトリップを節約するため」という理由で、ユーザーに代わってストップを決定しないでください。 自分で決定すると、5秒の回答が数時間のやり直しに変わります。
手順
- コンテキスト。
- プロジェクトルートの
DESIGN.mdを読みます。これが存在しない、またはProductセクションがない場合(同期のみのレコード)→ 必須サブスキル:craft-setupを実行し、その後ここに戻ります。 - デザインシステム(トークン、コンポーネント、ガイド)と、これに関連する画面を読みます。
- ブリーフとコードが矛盾する場合(ブリーフがティールと言い、トークンが青と言う場合):コードに従い、その旨を1行で伝え、矛盾を
DESIGN.md› Open questionsに追加し、どちらが間違っているかを更新する提案をします。ページ自身のCSS内でトークンを上書きしないでください。 - デザインツールのガイドとコードが異なり、
design-sync.jsonが存在する場合、ガイドを古いと見なさないでください。それを使って分類します:コードが変更された → 描画する前にガイドを更新する提案をします;ガイドが変更された → ユーザーの変更がエクスポートを待っている状態なので、ガイドを使用して描画し、保留中のエクスポートについて言及します。
- プロジェクトルートの
- 言葉でスコープを定義します。 作成する各ページまたは要素を、それぞれの役割と次のアクションとともにリストアップします。
- 曖昧な言葉は、一つの解釈を明確に述べます(「料金ページ = パン屋の価格リストであって、サブスクリプションプランではない」)。
- 複数のアイテムがある場合、またはリクエストが曖昧な場合は、リストを確認してストップします。 明確なアイテムが一つなら、そのまま進みます。
- 各アイテムについて、順番に:
- 必須サブスキル:
craft-states。 記述された状態リストとそのストップが最初に来ます。 - 方向性が未確定? ユーザーがアイデアを求めた場合、またはブリーフもシステムも選択しない構造的に異なる二つのレイアウトが考えられる場合にのみ → 状態を描画する前に必須サブスキル:
craft-exploreを実行します。複数ページの場合、スコープのストップで、どのページ(もしあれば)にオプションを与えるかを尋ねます;デフォルトでページごとにオプションのラウンドを実行しないでください。その後、選択された方向性で状態が描画されます。既存のパターンに従う画面は、直接描画に進みます。 - システムの部品とトークンのみを使用して、主要な状態を描画し、その後他の状態を描画します。新しいもの(コンポーネント、色、スケールにないサイズ)→ それを使用する前に必須サブスキル:
craft-system(追加モード)を実行します。コードには存在するがツールに描画されていないコンポーネント(インデックスで「コードのみ」)→ 必須サブスキル:craft-sync(1コンポーネントのインポート)を実行し、そのコンポーネントのみを最初に描画します。ユーザーがインポートを拒否した場合(DESIGN.mdを参照)、インポート前に一度尋ねます;それでも拒否する場合は、コードの値を使用してボード上に直接構築し、その旨をメモします。類似品を描画したり、ページ内に新しい値をハードコードしたりしないでください。 - 自己チェックモードでの必須サブスキル:
craft-critiqueをすべてのボードに対して実行します:レンダリングし、このタスクのスコープ内で見つかった問題を修正し、再度レンダリングします。
- 必須サブスキル:
- クローズ。
- 以下のサマリーとともに結果を表示します。
- 決定事項を
DESIGN.md› Decisions logに追加します(日付、決定、理由)。 - 回答が得られた質問は、Open questionsから削除します。
クロージングサマリー(最終メッセージの形式)
作成したもの: <ページ/要素> — <場所: ファイルまたはボード>
決定事項: <各決定、理由とともに1行>(DESIGN.md › Decisions logにも同様)
システム変更: <追加または変更された部品/トークン> — 影響範囲: <画面>
自己チェックで修正: <craft-critiqueがあなたが見る前に変更した内容>
未解決の質問: <ユーザーがまだ決定すべきこと>
ルール
| ルール | 理由 |
|---|---|
毎回、まずDESIGN.mdを確認 | ブリーフなしでは、すべての画面が独自のスタイルを発明する |
| 複数アイテムの場合、作業前にスコープを確認 | 誤った解釈で3ページ構築するのは3ページの無駄 |
描画前に状態リストを取得(craft-states経由) | ハッピーパスは多くの状態のうちの一つ |
| 方向性が未確定の場合のみオプションを提供 | 解決済みのパターンにオプションを出すのはユーザーの注意を無駄にする |
システムの部品とトークンのみを使用;新しいものはcraft-system経由 | ページ内のハードコードされた値が、ドリフトの始まり |
| コードは古いブリーフに勝つ;それをメモし、上書きしない | トークンが出荷されるもの;ブリーフは決定によって更新され、黙っては更新されない |
| 表示前に自己チェック | ユーザーはデザインをレビューすべきであり、ミスを探すべきではない |
決定事項はDESIGN.mdに記録 | 次のセッションのデザインは、記憶ではなくそれらから始まる |
完了条件
確認されたスコープ内のすべてのアイテムの状態が描画され自己チェックされ、システム変更がcraft-systemを経由し、クロージングサマリーが提供され、DESIGN.mdのDecisions logが更新されたとき。
よくある間違い
| 考え | 現実 |
|---|---|
| 「3ページは十分明確だから、そのまま作ってしまおう」 | まずリストを確認してください。1メッセージの手間です。 |
| 「ここではボタンを52pxにしよう。トークンは44だけど、このオーディエンスはもっと大きく必要だ」 | それはシステムの決定です。craft-systemを通じて提案し、その後、すべての場所でそれを使用してください。 |
| 「ブリーフがティールと言っているから、このページのCSSで青を上書きしよう」 | コードが優先です。矛盾を報告して尋ねてください;トークンをローカルでパッチしないでください。 |
| 「表示して、彼らに何が問題か教えてもらおう」 | まずcraft-critiqueを自己チェックモードで実行し、何を修正したかを伝えてください。 |
| 「決定事項は私のメッセージに書いてあるから、それで十分だ」 | メッセージはスクロールして見えなくなります。DESIGN.mdに追加してください。 |
| 「このセッションは答えを待てないから、自分で判断してリストアップしよう」 | ターンを質問で終了することがストップです。そうしてください;最初の未解決のストップを超えて何も構築しないでください。 |
| 「ラウンドトリップを節約するために、両方のストップを1つのメッセージに入れよう」 | 問題ありません、その後ストップすれば。両方を尋ね、何も構築せず、待ってください。 |