Communitygithub.com

craft-setup

プロジェクトにDESIGN.mdがなく、デザインやスタイル、ブランド、ガイドラインの設定を求められた場合や、/craft-setup(Claude Codeプラグインでは/craft:craft-setup)が実行された場合に使用します。

craft-setup とは?

craft-setupは、AIエージェントが新しいプロジェクトのデザイン基盤を設定するためのスキルです。プロジェクトのルートにDESIGN.mdがない場合、製品の定義、対象ユーザー、トーン、ブランドを確立するために使用します。このスキルは、まず既存のドキュメントやコードを読み、1メッセージにつき1質問ずつユーザーにインタビューし、その回答を元にDESIGN.mdを生成します。デザインシステムがコード内に存在する場合はcraft-syncで取り込み、ない場合はcraft-systemでトークンやタイポグラフィなどの基礎を作成します。最終的にDESIGN.mdの承認と基盤の確定をもって完了し、「スキップ」された場合でも最小限の仮定付きドキュメントを作成し、必須ステップは省略しません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diego3g/craft/tree/HEAD/skills/craft-setup

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

デザイン設定

概要

最初の画面の前に、製品は何か、誰のためのものか、どのように感じさせるべきか、決してどのような見た目にしてはいけないかを合意します。それを DESIGN.md に書き留めます。これは、以降のすべてのデザイン判断が最初に読むブリーフです。尋ねる、発明しない:エージェントがでっち上げたブランドは、ユーザーが後でやり直さなければならない推測です。既存のものを読み、1質問ずつユーザーにインタビューし、ブリーフを書き、承認を止めてから基盤を構築します。

使用するタイミング

  • デザインタスクがあり、プロジェクトルートに DESIGN.md がない場合。
  • 「デザインを設定する」「スタイル/ブランド/ガイドラインを定義する」、/craft-setup(Claude Codeプラグインでは /craft:craft-setup)が実行された場合。

使用してはいけないタイミング

  • DESIGN.md が存在し、タスクがデザインの場合:craft を使用します。
  • 1つのトークンや1つのガイドラインを変更する場合:craft-system を使用します。

手順

  1. 最初に読む。 README、ドキュメント、既存のCSSやトークン、デザインファイル、ブランドフォルダ、古い DESIGN.md の下書き。既に答えていることを書き留めます。コードにすでにデザインシステムがある場合(UIパッケージ、トークンファイル、コンポーネントライブラリ)、その旨を数とともに述べ、「デザインシステムのソース: <パス>」をブリーフのブランドセクションに書き込みます。ステップ6では、基盤を作成する代わりにデザインツールにインポートするオプションを提供します。回答済みのブランド質問はスキップされます。2つのUIパッケージがある場合 → ブランド質問をスキップする前に、どちらがソースかを尋ねます。ファイルが答えている質問は決してしないでください。 代わりに1行で確認します(「READMEによると、pt-BRのみでメンバーは60歳以上とのことなので、18pxのテキストと48pxのタップ領域でデザインします」)。
  2. インタビュー、1メッセージにつき1質問。 インタビュー の順序に従います:製品、オーディエンスとトーン、ムード、ブランド、参考、制約。
    • 可能な場合は3~5のオプションと「その他」を提供します。
    • 既に回答済みの質問はスキップします。
    • 最初の画面をデザインするのに十分な回答が得られたら停止します。良い回答6つは、15の回答よりも優れています。
  3. 参考は必須。 好きな製品、サイト、画像を2~5つ尋ねます。それぞれについて、「何を取り入れ、何を避けるか」を尋ねます。リンクや画像を開ける場合は、質問する前にそれを見て、何が見えるかを述べます。
  4. DESIGN.md を書く プロジェクトルートに、テンプレート から、8つのセクションすべて(製品、オーディエンスとトーン、ムード、ブランド、参考、制約、決定ログ、未解決質問)を記述します。
    • 可能な限りユーザーの言葉を使用します。
    • 推測したがユーザーが確認していないことは、ブリーフに事実として書かず、未解決質問に記述します。
  5. 停止し、ユーザーに DESIGN.md を見せる。 承認されるまで変更します。
  6. 基盤。
    • コードにすでにデザインシステムがある場合: インポートオプションを提供します。「はい」の場合、必須サブスキル: craft-sync(インポート)。在庫を表示し、どのコンポーネントを描画するかを尋ねます。「いいえ」の場合、「<日付> — <ツール>へのインポートを拒否」と決定ログに記録します。「スキップ」後でも提供します。ブリーフではなくデザインツールに関するものです。
    • コードにシステムがない場合: 必須サブスキル: craft-system を作成モードで使用し、基盤(トークン、タイポグラフィ、スペーシング、インタラクションルール)を作成します。これには独自の承認停止があります。
    • 既存のトークンとスタイルが出発点です。それらを拡張し、尋ねずに名前変更や移動はしないでください。

「スキップ」または「とにかくデザインして」と言われた場合

尋ね続けないでください。読んだ内容とユーザーの発言から最小限の DESIGN.md を書きます:

  • すべてのギャップは未解決質問になります。
  • すべての仮定には「(仮定)」とマークします。

最も重要な仮定を1行で述べます。「スキップ」はインタビューとブリーフの承認停止を免除しますが、ステップ6は決して免除しません:

  • コードにデザインシステムがある場合 → 1つのインポート質問のみ行います(「今 <ツール> にインポートしますか?中身を表示して、コンポーネントを選んでもらいます」)、その後続行します。
  • トークンがまだない場合 → 基盤のステップとその停止は依然として実行されます。craft はシステムの部品を使ってしか描画できないためです。

その後、依頼されたタスクを続行します。

開始前に

  • ツールに一致するアダプターが references/adapters/ にない場合、同じ動詞をツールで実行し、手動でマッピングしたことを述べてください。デザインツールがまったくない場合は、HTML(html.md)で構築します。画像だけがある場合は、画像から読み取った値は推定値であると述べてください。
  • DESIGN.md は、すべてのツールでリポジトリ内のプレーンなMarkdownファイルです。オプションの参考ボードのみがデザインツール内に存在します。

ルール

ルール理由
1メッセージにつき1質問、オプション付き質問の壁は読み飛ばされ、半分しか回答されない
尋ねる前に読む。ファイルに書いてあることを尋ねないREADMEにあることを尋ねると、見ていないことがバレる
ブランドを発明しない。色、フォント、ムードはユーザーから得るか、「(仮定)」とマークする発明されたブランドは、画面ごとにやり直さなければならない推測である
参考には常に「取り入れ/避ける」を付ける「Stripeが好き」は役に立たない。「落ち着いたスペーシングを取り入れ、グラデーションは避ける」はルールになる
「絶対に嫌い」を明示的に尋ねる避けるべきものが、目指すべきものよりも早くデザインを絞り込む
設定中に既存ファイルを再デザインしない設定は決定を記録する。CSSの変更は、まだ依頼されていないデザインタスクである
設定中に画面を作らない画面は craft から来る。ブリーフと基盤が承認された後である

完了条件

DESIGN.md が8つのセクションとともに承認され、基盤が確定していること:craft-system を通じて作成・承認されるか、(コードにシステムがある場合)craft-sync を通じてインポートされるか、インポートが拒否されログに記録されていること。「スキップ」後の場合:DESIGN.md が仮定とともに書かれ、基盤が存在し(承認済み、またはプロジェクトに既に存在)、元のタスクが続行されていること。

よくある間違い

考え現実
「良いパレットとフォントを選んで、後で変更してもらおう」決定されたことに気づいていないものを変更することはできない。尋ねるか、「(仮定)」とマークする。
「ついでにメイン画面もモックしよう」それは承認後の craft の仕事。設定はブリーフと基盤で終了する。
「時間を節約するために6つの質問を一度にしよう」1メッセージにつき1質問、オプション付き。回答する方がユーザーにとって速い。
「トークンが乱雑だから再構成しよう」拡張する。再構成は別の承認された変更である。
「参考が与えられなかったからそのセクションをスキップしよう」尋ねる。もし与えられなければ、ムードに合う3つを提案し、それぞれから何を取り入れ、何を避けるかを尋ねる。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル