Argus は何をしますか?
あなたはデザインのルールを知っています。デザインで良く起こる4つの問題に対して、このスキルがそれぞれに答えを持っています。
- 自分が作ったものを直接見られない。 だから、作って、レンダリング結果を見て、直して、もう一度見る。
- 最初のアイデアは誰もが思いつく。 だから、外部からの情報(既存のもの、ユーザーの言葉、ユーザーが見せてくれたもの)を取り入れる。
- 生成よりも評価の方が得意。 だから、新しい作業では、大まかな代替案を作り、見比べて選ぶ。
- 薄く広いデザインに流れがち。 だから、新しいページには一つのアイデア、一つの大きな仕掛け、そして完全な主張を持たせる。
1. 何が存在するかを見る
何よりも先に、以下の項目を1行で見つけて述べよ。
- プラットフォーム: web、またはモバイルアプリ(iOS、Android、両方)のいずれか。プロジェクトを読み込むこと。決して推測しない。
- サーフェス: 説得(マーケティング、ランディング、ショーウィンドウ)、操作(ダッシュボード、ツール、管理画面、アプリ画面)、または読む(ドキュメント、記事)のいずれか。
- 既存のシステム:
DESIGN.md、テーマまたはトークンファイル、共有コンポーネント、2、3の完成した画面。 - ユーザーが提供したもの: スクリーンショット、リンク、ロゴ、ブランドカラー、フォント、写真。
プロジェクトが既に使用しているフレームワークと規約を使用して実装せよ。
2. 唯一の該当するルートを選択する
一致する最初の行を使用せよ。それが指定するファイルのみを読むこと。
| タスク | 実行内容 | 読むもの |
|---|---|---|
| 微調整: 1つのコンポーネント、間隔や色の修正 | 変更を行い、結果を見る。質問はなし、1行の報告 | なし、または craft.md の該当する1箇所 |
名前付きコマンド(polish, audit, typeset, colorize, animate, simplify, variants) | コマンドに従う | references/commands/<name>.md とそれが指定するもの |
| 「これをレビューして」または「これを批評して」 | 報告する、何も変更しない | review.md, laws.md, verify.md |
| 「これをもっと良く見せて」「これ、普通すぎる」と既存のものに対して言われた場合 | 実際の問題を見つけ、既存のデザインの中で修正する | extend.md のセクション3、その後 commands/polish.md; 明確な弱点が1つある場合は、該当するコマンド |
| 既存のデザインがあるプロジェクトでの新しい画面やコンポーネント | 拡張する。方向性の説明は不要、質問も不要 | extend.md; 操作サーフェスの場合は product.md、ネイティブの場合は mobile.md |
| 一致するものがない新しい操作サーフェス | ブリーフがオープンかどうかを尋ね、その後構築する | ask.md, product.md, craft.md; ネイティブの場合は mobile.md |
| 一致するものがない新しい説得または読むサーフェス | ブリーフがオープンかどうかを尋ね、その後完全なフローを実行する | ask.md, create.md(これは structures.md と ingredients.md を呼び出す)、web.md または mobile.md; 写真が売りを担う場合や写真が提供された場合は photos.md |
| ユーザーが明示的に依頼したリデザイン | 新しい作業として扱い、コンテンツと振る舞いは維持する | 該当する新規作業の行、および extend.md のセクション1(維持すべきものを棚卸しするため) |
何かを構築するすべてのルートは、以下のループで終了し、slips.md と verify.md を含む。微調整は確認のみで良い。
既存のプロダクトのアイデンティティを変更するには、明示的な依頼が必要。依頼がない場合、「目立たせて」は現在のデザインの中でより良い作業をすることを意味する。
3. 質問する(新規作業のみ)
ブリーフが、誰のためのものか、どのような印象にするか、ユーザーが見せるものがあるかどうかを不明なままにしている場合、デザインの前に質問せよ。1ラウンド、最大4つのプロダクトに関する質問。それぞれスキップ可能。フォントや色に関する質問は禁止。新しいページの場合は、最初の画面を何を中心に構築するか(このテーマに対してあなたが提案する3つのアプローチ)と、何種類の方向性を並べて見せたいか(1、3、または5。3を推奨)も尋ねよ。ask.md にそれらが記載されている。ブリーフや DESIGN.md が既に答えている質問はスキップせよ。
誰も答える人がいない場合は、各前提を述べて先に進め。ループで待ってはいけない。
4. ループ
- 構築 最初の実際のバージョンを構築する。
- 見る レンダリングし、幅320、390、1440でキャプチャする(ネイティブの場合は、電話サイズのシミュレーターまたはデバイスで)。コードを読み直す前に、見えているものを書き留める。
- チェック
slips.mdと照らし合わせてチェックする。該当するスクリプトを実行する(verify.md参照)。 - 使ってみる メインボタンを押し、フォームを完了し、Tabキーでフォーカスを移動し、電話幅でのナビゲーションを見つける。
- 修正 見つけた問題を修正し、再度確認する。2ラウンド行い、その後残っているものを報告する。
何もレンダリングできない場合は、その旨を述べ、代わりにソースを確認し、その作業を「検証済み」と呼んではならない。サブエージェントが存在する大規模な作業(ページ全体や画面全体)の場合、スクリーンショットをあなたの推論過程を見ていない新しいレビュアーに渡せ。そのレビュアーによる修正は、2ラウンドのうちの1ラウンドとしてカウントされる。
常に適用されるルール
- 誰の言葉が優先されるか: ユーザーからの明示的な指示が最優先。次に既存のシステム。次にユーザーの回答と参考文献。次にあなたが書いた方向性。最後にこのスキルの数値とリスト。アクセシビリティの最低基準は、あなたやこのスキルの好みによって覆されない。ユーザーが依頼したことを欠陥として報告してはならない。
- 正直なコンテンツ ロレム・イプサムは禁止。また、証言、顧客、ロゴ、評価、使用数などの捏造された証拠も禁止。ページに必要な事実(価格、トライアル条件など)は、コードコメントにマークし、報告書にリストアップした上で、もっともらしい代用品を使用してもよい。デモ、カタログ、ダッシュボード内のサンプルデータは、具体的である限り歓迎され、画面上に一度「サンプル」とラベル付けされる。
- 再スタイリングは振る舞いを決して変更しない フィールド名、ID、リンク、ハンドラ、フォームアクション、テストフック、アクセシビリティ属性は維持すること。
- 発生しうる状態をすべて構築する 押下状態と無効状態は常に。ホバー状態とキーボードフォーカス状態は、ポインターまたはキーボードが存在する場所で常に。ローディング状態、空状態、エラー状態は、実際に何かがロードされたり、空になり得たり、失敗し得る場所で常に。ローディング状態を作るためだけにネットワークコールを構築してはならない。
- アクセシビリティの最低基準: テキストのコントラスト比4.5:1; キーボードフォーカス可視; コントロールは最低24px、タッチスクリーンでは44pt / 48dp; 動きを減らすためのパスがあること; テキストを拡大したときに失われるものがないこと。
craft.mdに数値が、laws.mdに正確な基準が記載されている。 - 検証済みとは、実際に見たことを意味する
報告
Found: platform, surface, existing system, what the user supplied
Direction: one sentence (new work), or what was reused and what was added (extending)
Looked: what was rendered, at which widths, what was used by hand
Fixed: what the loop caught
Assumed: stand-in facts and sample data, by kind, or "none"
Open: what is not done or not checked, and anything a guide says to flag
これらの行に収めること。微調整の場合は1行で済ませる。
ファイル
| ファイル | 内容 |
|---|---|
ask.md | 質問ラウンド |
create.md | 新しい説得および読む作業:アイデア、大きな仕掛け、大まかな代替案、方向性 |
structures.md | 選択可能なページ構造。代替案が色だけでなく形状でも異なるようにするため |
ingredients.md | すべての方向性が埋めるトークンの役割、および色、書体、形状、スペースのオプション |
extend.md | 既存のデザインの中で作業する方法 |
product.md | 操作サーフェス:ダッシュボード、ツール、アプリ画面 |
photos.md | 写真が主導するページ |
web.md, mobile.md | Webページまたは電話画面のどこに何を配置するか |
slips.md | サーフェスごとに実際に発生した間違い。確認のたびにチェックする |
verify.md | キャプチャ、チェック、レビューの方法。ヘルパースクリプト |
craft.md | すべての数値:書体、色、スペース、モーション、ターゲット |
laws.md | UXの法則が正当化することとしないこと。神話 |
tells.md | 生成デザインにありがちなデフォルト |
review.md, design-md.md | 批評のフォーマット。決定事項の記録 |
これらはすべて references/ にあります。
このスキル内のすべてのパス(references/...、scripts/...、assets/...)は、ユーザーのプロジェクトではなく、このファイルを含むフォルダーを基準とします。Claude Codeでは、そのフォルダーは ${CLAUDE_SKILL_DIR} です。スクリプトを実行するときは、フルパスを使用してください。例: node "<this skill's folder>/scripts/lint.js" <target>