Communitygithub.com

do-design

UIおよびビジュアルデザインを、拘束力のあるDESIGN.mdに基づいて実行するスキル。ページやコンポーネントのデザイン、リスタイル、UIレビュー、監査・スコアリング、サイトの再設計、市場調査、大胆な方向性の提案、リポジトリへのデザインガードレール導入などに使用します。コマンド: do-audit, do-design-new, do-design-review, do-design-renew, do-crazy。

do-design とは?

`do-design` は、開発者ツール(Claude Code、Coder、Cursorなど)向けのAIエージェントスキルで、プロジェクトのDESIGN.mdを拘束力のある設計仕様書として扱い、UI/ビジュアルデザインのあらゆるタスクを体系的に遂行します。このスキルは、デザインレビュー、監査(アクセシビリティ、コントラスト、コピーライティングなど)、新規デザインの作成、既存デザインの刷新、そして業界の常識を覆すような大胆な方向性の提案をサポートします。各コマンドは特定のレイヤー(カラー、タイポグラフィ、スペース・レイアウト、モーション、トーン、リサーチ)を読み込み、スクリプトが客観的な測定値を提供するため、AIは推測ではなくエビデンスに基づいて動作します。スワップテストや「方向性、五行」などの定義済み概念を用いて、プロダクト独自の個性を保ちながら、機能的な美しさを実現します。スコアリングシステムにより、各評価(Hierarchy、Legibility、System、Craft、Content truth、Usability、Distinction)が0-4で採点され、バンド(Strong、Sound、Weak、Failing)に基づいてアクションが決定されます。`do-design`は、コードの改変は一切行わず(読み取り専用)、DESIGN.mdに従ったデザインの品質保証と改善提案に特化しているため、既存の実装を壊すことなく、デザインの一貫性と品質を向上させたいチームに最適です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diononline-un/design-skill/tree/HEAD

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

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

ドキュメント

do-design は何をしますか?

パスはこのスキルのフォルダからの相対パスです。Pはプロジェクトルートです。スクリプトはstdlib Python 3.8+を使用します。スクリプトが測定するものについて推論する前に、スクリプトを実行し、その出力を引用し、報告された内容を再導出したり推定したりしないでください。

モデル

  1. プロジェクトのDESIGN.md(ペーパー)には拘束力があり、このスキルよりも優先されます。矛盾がある場合はペーパーが優先されます。そのように明言してください。
  2. すべてのルールには理由が伴います。 理由のないルールは、最初に不便になった時点で削除されます。
  3. デフォルトよりもエビデンスを優先します。 薄っぺらいブリーフ(「新しくする」+ ロゴ)は、通常の見た目に頼ったり、事実を捏造したりする理由ではなく、リサーチを行う理由です。出典がない場合は主張なし:ギャップをマークするか、質問してください。
  4. 遅延読み込みを行います。 コマンドテーブルが指定するファイルのみを読み込みます。「完全性」のための追加レイヤーは手法の失敗です。
  5. 慣習はデフォルトであり、失敗ではありません。 モードが、どの程度逸脱するかを決定します。

モード: すべてのコマンドの先頭に1行で記述します

モード訪問者はプッシュ
Persuade決定し、行動している強く:テンプレートは失敗
Operateタスクを完了している抑制:慣習は機能である
Read何かを理解している中程度:読みやすさが最優先
Experience作品自体の中にいる強く:アーティファクトが主導する

プロダクトではなく、表面で選んでください:開発ツールのランディングページはPersuade、その設定画面はOperateです。

コマンド: 1つのコマンドファイルと、その行が名前指定するものを読み込みます

コマンド使用するタイミング併せて読み込むものリスク
do-design-review「これはペーパーと一致していますか?」最も安価。最も頻繁に実行プロジェクトのDESIGN.md-
do-audit「これはどの程度優れていますか?」スコア + ランク付けされた所見references/critique-rubric.md、references/slop-catalog.md、スコープが触れるレイヤー00-05-
do-design-new「Xを構築する」:慣用的で、有能で、ペーパーに沿ったlayers/00、タスクが触れる1-3のレイヤー;ブリーフが薄い場合や顧客向けの場合はlayers/06低
do-design-renew「この見た目をやり直す」:新しい世界、同じプロダクトの真実layers/00、layers/06中
do-crazy「このセクターでは誰もやらないような何か」layers/00、layers/06高、設計による

レイヤー: 00-craft-floor(すべてのモード)· 01-color · 02-typography · 03-space-layout · 04-motion-states · 05-voice · 06-research。ペーパーを書く場合: templates/DESIGN.md、 examples/01-two-papers.md、references/interview.md。

スクリプト(すべて--jsonを受け付けます)

実行出力
scripts/check-design.py --root Pペーパーのトークンブロックからの乖離。終了コード0: クリーン、1: 乖離あり、2: ペーパー/トークンなし。--initでコードからトークンをドラフト
scripts/audit.py scan Pソースの特徴(スロップカタログにあるID)、a11yとブラウザ表面のギャップ、価値の在庫
scripts/audit.py copy P散文とマイクロコピーの特徴、文のリズム、未記入のギャップマーカー
scripts/audit.py contrast FG BG / --paper P/DESIGN.mdWCAG比率
scripts/audit.py score H L S C T U D加重スコア、バンド、作業リスト
scripts/render-audit.py URL-or-file [--shots DIR] [--inject-css FILE]ペイントされたページ(1280/768/390):重なり、横スクロール、クリッピング、ペイントされたコントラスト、タップターゲット、フォーカスの可視性。--inject-cssは、デプロイ前にCSS修正をデプロイ済みページに対して測定します。Chrome/Chromiumが必要
`scripts/research.py suggestprofile
bash scripts/install-guardrails.sh PテンプレートからのDESIGN.md、AGENTS.md/CLAUDE.mdブロック、チェッカー

スクリーンショットはスクリプトの出力よりもはるかに多くのコンテキストを消費します。目視が必要なもの(階層、区別、構成)のみ、ビューポートのみ、最初に390で撮影してください。スクリプトも間違う可能性があります:あり得ないと思われるP0を報告する前に、一度だけ確認し(対象を絞ったスクリーンショットまたは要素のジオメトリ)、誤検知だった場合はスクリプトを修正してください。

共有定義

スワップテスト。 プロダクト名を競合他社のものと置き換えます。何も問題がなければ、そのページはこのプロダクトについて何も語っていません:選択されておらず、醜くもありません。コピー、ビジュアル、および1つのシグネチャ詳細で修正し、決して装飾を追加して修正しないでください。

方向性、五行。 構築前に書き、提示し、その後イエスを待ちます(「とにかくやってくれ」と言われた場合は、その前提を1行で述べてから進めてください):

Product:    それが何をするのか、誰のために、1つの平易な文
Character:  2-3の具体的な単語(clean、modern、sleek、minimal、premiumは不可)
World:      それが属する場所や素材;ニュートラルな色合い、アクセント、イメージを設定
Moments:    画面がリッチになる1-2の場所
Signature:  このプロダクトだけが持つ1つのディテール、一貫して使用される

ギャップマーカー。 [number needed]、[source needed]、[photo needed]を、事実やアセットが不足している場所に使用します。audit.py copyはまだ未解決のものをリストアップします。未解決のまま出荷してはいけません。

スコアリング: すべての評価コマンドはこれで終了します

#フィールド質問W
1Hierarchy最も重要なものを2秒で名前を挙げられますか?3
2Legibilityコントラスト、サイズ、measure、すべての幅での実際のコピー3
3System1つのパレット、1つのスケール、1つの半径ロジック、1つのモーション言語2
4Craft配置、スペーシングリズム、状態、ブラウザ表面2
5Content truth実際のデータ、具体的なコピー、捏造された主張なし3
6Usabilityタスクが完了する;アフォーダンスが明白;エラーからの回復可能3
7Distinctionスワップテストに合格しますか?2

各項目を0-4でスコアリングし(4 = 真に優れている、「まあまあ」ではない)、audit.py scoreで計算します。 バンド: 85+ Strong、出荷してP0のみ修正 · 70-84 Sound、指定されたP1を修正して出荷 · 50-69 Weak、実際に一通り修正が必要 · <50 Failing、方向性が間違っている:再構築(do-design-renew)。 ソースではなくレンダリングをスコアリングします。確認できなかったフィールドはuとします:スコアは0で、unverifiedと読み替え、決して推定値ではありません。Distinctionは、このプロダクトのものだと何が言えるのかを名前を挙げられる場合のみ4になります。最も悪い3つのフィールドが作業リストとなり、それぞれ1つのアクションを持ちます。

重大度: P0 出荷をブロックする(壊れている、読めない、ハードバン)、すべて報告 · P1 信頼を損なう、上位5つ · P2 クラフト、上位5つ · P3 ポリッシュ、リストのみ。 所見の形式: [Pn] 場所 - 何が間違っているか - 修正方法;スクリプトの所見はそのIDを保持します。

ペーパーがない場合

「DESIGN.mdがありません:ガードレールが強制するものは何もありません。」と言います。作成を申し出るか(テンプレート + インタビュー)、またはコードからのレトロフィット(check-design.py --init + インタビューの§Retrofit)を申し出てください:v1.0は出荷するもの、古い値はlegacy:に入れられます(カウントされ、失敗とは見なされません)、ギャップはペーパーのデルタリストに入ります。アーカイブとデモは、トークンブロックのskip:(または--skip a,b)でフォルダまたはファイルごとに、すべてのスキャンから除外されます。スキップする前にインポートをgrepしてください:アーカイブフォルダはしばしばライブパーツを含んでいます。チェッカーを通すためにペーパーを発明しないでください。

非妥協事項

  1. 決して動作中のコードを壊さないでください。 Props、state、ルーティング、ハンドラー、a11yは維持され、コピーはその意味を保ちます。
  2. ブリーフが優先されます。 指定されたブランド、フォント、色は、たとえ拒否リストにあっても、好みより優先されます。それをペーパーに書き込んでください(トークンブロックのallow:は、チェッカールールまたは監査IDを意図的にオフにします)。
  3. 決して事実、アセット、または出典を捏造しないでください。 曖昧な主張は削除し、決して捏造した具体的事実に置き換えないでください。ギャップマーカーを使用してください。
  4. 作者の声を保ってください。 機械的な癖を削除し、個人のクセを残してください。
  5. 密度であって、存在ではありません。 クラスター(3つ以上の異なるP0/P1の兆候)に基づいて行動し、1つのグラデーションや1つのemダッシュに基づいて行動しないでください。クリーンな結果は有効です。決して所見を捏造しないでください。
  6. 修正し、決して非難しないでください。 「これはAIが生成したように見える」とは決して言わず、何が選択されておらず、代わりに何をすべきかを述べてください。
  7. レビューと監査については、要求がない限り読み取り専用 です。

関連スキル