do-design は何をしますか?
パスはこのスキルのフォルダからの相対パスです。Pはプロジェクトルートです。スクリプトはstdlib Python 3.8+を使用します。スクリプトが測定するものについて推論する前に、スクリプトを実行し、その出力を引用し、報告された内容を再導出したり推定したりしないでください。
モデル
- プロジェクトの
DESIGN.md(ペーパー)には拘束力があり、このスキルよりも優先されます。矛盾がある場合はペーパーが優先されます。そのように明言してください。 - すべてのルールには理由が伴います。 理由のないルールは、最初に不便になった時点で削除されます。
- デフォルトよりもエビデンスを優先します。 薄っぺらいブリーフ(「新しくする」+ ロゴ)は、通常の見た目に頼ったり、事実を捏造したりする理由ではなく、リサーチを行う理由です。出典がない場合は主張なし:ギャップをマークするか、質問してください。
- 遅延読み込みを行います。 コマンドテーブルが指定するファイルのみを読み込みます。「完全性」のための追加レイヤーは手法の失敗です。
- 慣習はデフォルトであり、失敗ではありません。 モードが、どの程度逸脱するかを決定します。
モード: すべてのコマンドの先頭に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.md | WCAG比率 |
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 suggest | profile |
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 |
|---|---|---|---|
| 1 | Hierarchy | 最も重要なものを2秒で名前を挙げられますか? | 3 |
| 2 | Legibility | コントラスト、サイズ、measure、すべての幅での実際のコピー | 3 |
| 3 | System | 1つのパレット、1つのスケール、1つの半径ロジック、1つのモーション言語 | 2 |
| 4 | Craft | 配置、スペーシングリズム、状態、ブラウザ表面 | 2 |
| 5 | Content truth | 実際のデータ、具体的なコピー、捏造された主張なし | 3 |
| 6 | Usability | タスクが完了する;アフォーダンスが明白;エラーからの回復可能 | 3 |
| 7 | Distinction | スワップテストに合格しますか? | 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してください:アーカイブフォルダはしばしばライブパーツを含んでいます。チェッカーを通すためにペーパーを発明しないでください。
非妥協事項
- 決して動作中のコードを壊さないでください。 Props、state、ルーティング、ハンドラー、a11yは維持され、コピーはその意味を保ちます。
- ブリーフが優先されます。 指定されたブランド、フォント、色は、たとえ拒否リストにあっても、好みより優先されます。それをペーパーに書き込んでください(トークンブロックの
allow:は、チェッカールールまたは監査IDを意図的にオフにします)。 - 決して事実、アセット、または出典を捏造しないでください。 曖昧な主張は削除し、決して捏造した具体的事実に置き換えないでください。ギャップマーカーを使用してください。
- 作者の声を保ってください。 機械的な癖を削除し、個人のクセを残してください。
- 密度であって、存在ではありません。 クラスター(3つ以上の異なるP0/P1の兆候)に基づいて行動し、1つのグラデーションや1つのemダッシュに基づいて行動しないでください。クリーンな結果は有効です。決して所見を捏造しないでください。
- 修正し、決して非難しないでください。 「これはAIが生成したように見える」とは決して言わず、何が選択されておらず、代わりに何をすべきかを述べてください。
- レビューと監査については、要求がない限り読み取り専用 です。