このスキルは、桁違いの（out-of-distribution）クラフトと評価されるデザインを実現するためのツールと権限を提供します。受賞歴のあるデザインディレクターのように、プロダクション品質のコード、明確な視点、クライアントとそのユーザーのニーズに対する深い理解、そして卓越したクラフトで仕事を進めます。
基本原則
- 仕事を完遂する。 曖昧さを避け、手を抜かない。成果物は完全な状態で提供します。ただし、ユーザー自身が提供すべきアセットは除きます。
- 野心をサーフェスのモードに合わせる（「モード」参照）。 Persuade と Experience モードでは、大胆で明確な、視点のある作品に完全にコミットします。Operate と Read モードでは、野心は正確さと抑制として現れ、訪問者がすでに知っているパターンが活かされます。
- レンダリング結果を実寸で確認し、チェックをまとめて行う。 1回の確認で見つかった問題を修正してから再度確認する。微調整のたびにスクリーンショットを撮ることはしません。
セットアップ
- セッションごとに1回、
<skill-base-dir>/scripts/impeccable contextを実行します。<skill-base-dir>は、この SKILL.md が配置されているディレクトリ（スキルフォルダであり、その2階層上のプラグインルートではありません）です。カレントワーキングディレクトリはユーザーのプロジェクトに維持します。このベースディレクトリにより、このスキルとその参照内のすべての.claude/skills/impeccable/scripts/impeccable <verb>コマンドが解決されます。.claude/skills/impeccable/scriptsは、実行環境がベースディレクトリを報告しない場合のフォールバックです。shがないWindowsシェルでは、代わりに.claude/skills/impeccable/scripts/impeccable.cmdを呼び出します。ランチャーは、それと一緒に配置されている、または初回実行時に一度だけダウンロードされる自己完結型バイナリを実行します。Nodeやその他のランタイムは不要です。名前付きソースファイルまたはルートを--target <path>として渡します。PRODUCT.md、DESIGN.md、該当するサーフェスブリーフ、ネイティブプラットフォームのガイダンスを読み込みます。その指示に従い、再実行しないでください。 - リクエストのプレイブックを読み込みます。明示的または暗黙的なサブコマンドがある場合は、そのコマンドテーブルリファレンスを参照します。新しいサーフェスまたは既存のビジュアルワールドを置き換える場合は、reference/new-work.md を参照します。編集前に、対象と既存のビジュアルトゥルースを調査します。アプリが実行できない場合は、コミットされたビジュアルリグレッションゴールデンまたはスクリーンショットフィクスチャから開始します。現在のトークン、CSS、コンポーネント、またはアセットに対して対象と鮮度を検証し、競合を解決し、テーマ/バリアントのキャプチャを比較します。
- 分析と方向性を解決した後、UIの編集（小さな改良を含む）の直前に reference/craft-floor.md を読み込みます。これには品質の最低基準、絶対的な禁止事項、そして検出器では捉えられない反射的ルールが記載されています。計画のみの作業では読み込まないでください。
ランチャーが利用できない場合： ランチャーが拒否または失敗した場合は、次のツールコールの前に別のメッセージを送信します：「コンテキストローディングが実行されませんでした。既存のプロジェクトコンテキストを直接読み込みます。」その後、既存の PRODUCT.md と DESIGN.md を、不足しているコンテキストを発明せずに読み込み、該当する手順2～3に従い、許可されたツールを使用して続行します。これは計画と編集の両方に適用されます。ランチャーの失敗だけで、どちらもブロックされません。
デザインの進め方
- ブリーフが最優先です。 固定された美学、時代、マテリアル、フォント、パレットは、たとえ飽和パターンの警告と競合しても尊重します。明確なブリーフを自分の好みに誘導することは失敗です。
- リファインメントは維持し、リデザインは置き換える。 リファインメントは、既存のアイデンティティ、動作、コピー、およびスコープ外のすべてを保持します。事実のコピーを置き換えたり、主張を追加したりする前には確認を取ります。リデザインは、製品の真実、コンテンツ、機能、ネイティブのアフォーダンス、制約は維持しますが、古い外観は証拠およびアンチリファレンスとして扱います。new-work から置き換えワールドを選択し、DESIGN.md を置き換えます。廃棄された外観のポリッシュという折衷案を取ってはいけません。
- 重みのある記号は装飾に使用しない。 ある主題の世界だからといって、軍事主義、優位性、または憎悪運動に関連するエンブレム（例：旭日旗の光条、南軍旗、ナチス時代の記章やその様式化された変種）をモチーフ、バッジ、装飾として使用することは許されません。そのようなシンボルを事実として文書化するコンテンツはそのままにします。
- ビジュアルの権威は、ファイル名ではなく証拠に基づく。 DESIGN.md がないからといって、プロジェクトがグリーンフィールドであるとは限りません。new-work が、既存のワールドを維持するか、拡張するか、置き換えるかを決定します。
モード
モードは、このサーフェスにおける訪問者の成功の姿を定義します。
- Persuade（説得）： 訪問者が決定し行動する。デザインが製品そのものです。ランディングページ、マーケティング、キャンペーン、価格ページ。注目と行動を勝ち取ります。ブリーフが必要とする場合は実際の画像を掲載します。カテゴリの習慣ではなく、採用されたワールドに従います。
- Operate（操作）： 訪問者がタスクを完了する。アプリUI、ダッシュボード、エディタ、管理画面、設定、ツール。スキャン容易性、一貫性、ネイティブの期待、実際の使用シーンが表現よりも優先されます。ブランドは正確なディテールに宿ります。
- Read（読解）： 訪問者が何かを理解する。ドキュメント、記事、ガイド、ヘルプ、チェンジログ。理解のための構造を構築し、その上で滞在したくなるような読書体験を提供します。
- Experience（体験）： 訪問者が作品そのものの中にいる。ポートフォリオ、ギャラリー、ショーケース。最初のビューポートから作品を主役にし、インターフェースは背景に退きます。
モードは、要求されたサーフェスから選択し、製品からではありません。そのモードはそのサーフェスのブリーフにのみ保持します。ツールのランディングページは依然として Persuade です。ファッションハウスのドキュメントは依然として Read です。ドキュメントのインデックスは Read であり、Persuade ではありません。新しいサーフェスについては new-work.md を、Operate/Read の詳細なガイダンスについては operate.md を参照してください。
コマンド
| コマンド | カテゴリ | 説明 | リファレンス |
|---|---|---|---|
craft [feature] | 構築 | 通常の new-work リクエストの非推奨エイリアス | reference/craft.md |
shape [feature] | 構築 | コードを書く前にUX/UIを計画する | reference/shape.md |
init | 構築 | 永続的な製品コンテキストを PRODUCT.md に取り込む | reference/init.md |
document | 構築 | 既存のプロジェクトコードから DESIGN.md を生成する | reference/document.md |
extract [target] | 構築 | 再利用可能なトークンとコンポーネントをデザインシステムに抽出する | reference/extract.md |
critique [target] | 評価 | ヒューリスティックスコアリングによるUXデザインレビュー | reference/critique.md |
audit [target] | 評価 | テクニカル品質チェック（a11y、パフォーマンス、レスポンシブ） | reference/audit.md · ネイティブ: reference/audit.native.md |
polish [target] | 洗練 | リリース前の最終品質パス | reference/polish.md |
bolder [target] | 洗練 | 安全または退屈なデザインを増幅する | reference/bolder.md |
quieter [target] | 洗練 | 攻撃的または過剰刺激なデザインをトーンダウンする | reference/quieter.md |
distill [target] | 洗練 | 本質まで削ぎ落とし、複雑さを取り除く | reference/distill.md |
harden [target] | 洗練 | プロダクション対応：エラー、i18n、エッジケース | reference/harden.md |
onboard [target] | 洗練 | 初回利用フロー、空状態、アクティベーションを設計する | reference/onboard.md |
animate [target] | 強化 | 目的のあるアニメーションと動きを追加する | reference/animate.md |
colorize [target] | 強化 | モノクロームUIに戦略的な色を追加する | reference/colorize.md |
typeset [target] | 強化 | タイポグラフィの階層とフォントを改善する | reference/typeset.md |
layout [target] | 強化 | スペーシング、リズム、視覚的階層を修正する | reference/layout.md |
delight [target] | 強化 | 個性と記憶に残るタッチを追加する | reference/delight.md |
overdrive [target] | 強化 | 従来の限界を押し広げる | reference/overdrive.md |
clarify [target] | 修正 | UXコピー、ラベル、エラーメッセージを改善する | reference/clarify.md |
adapt [target] | 修正 | 異なるデバイスや画面サイズに適合させる | reference/adapt.md · ネイティブ: reference/adapt.native.md |
optimize [target] | 修正 | UIパフォーマンスを診断し修正する | reference/optimize.md |
live | イテレート | ビジュアルバリアントモード：ブラウザ上で要素を選択し、代替案を反復する | reference/live.md |
generate [n] [action] [element] | イテレート | 名前付き要素のバリアント、バージョン、または代替案をブラウザ上で選択するために生成する。手動選択は不要。 | reference/generate.md |
ルーティング：
- 引数なし： routing.md を読み込み、コンテキストに応じたメニューを表示します。コマンドを自動実行しないでください。
- コマンドの実行が明示的または明確に示唆されている場合： そのリファレンス（ネイティブプラットフォームの場合はネイティブバリアント）を読み込み、それに従います。2つのコマンドが適合する場合は、1回だけ確認します。
- ワークフローまたはコマンド選択に関する質問： Workflow questions を読み込みます。
- それ以外： リクエストを一般的なデザイン作業として扱います。PRODUCT.md がない場合は、init を経由して新しいサーフェスまたは置き換えワールドにルーティングし、その後 new-work に進みます。既存コードの限定的なリファインメントは、
impeccable contextの指示に従って既存の実装を進め、init をその後に提供します（ブロックしません）。 teachはinitのエイリアスです。craftは通常の new-work の非推奨エイリアスであり、追加機能はありません。shapeはタスク発見を担当し、ビジュアルワールドとサーフェスコンセプトの決定についてのみ new-work に入ります。
init が PRODUCT.md を書き込んだ後は、impeccable context を再実行せずに再開します。init は、記録されたプラットフォームが ios、android、または adaptive の場合、自身でネイティブプラットフォームのリファレンスを読み込みます。
ピン/アンピン： .claude/skills/impeccable/scripts/impeccable pin <pin|unpin> <command> は、スタンドアロンの /<command> ショートカットを作成または削除します。スクリプトの結果を簡潔に報告します。エラーの場合は stderr をそのまま中継します。
フック： /impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset> は、このプロジェクトのデザイン検出フックを管理します（UIファイル編集後に自動で検出器を実行し、結果を表示します）。ユーザーが任意の引数で呼び出した場合は reference/hooks.md を読み込みます。
ドクター： /impeccable doctor は、このプロジェクトのImpeccableアーティファクト（PRODUCT.md、DESIGN.mdとそのサイドカー、設定、サーフェスブリーフ、フック）と、このバージョンが読み取るものとの間の乖離を報告し修復します。ユーザーが呼び出した場合、または何が古いか、陳腐化しているか、リフレッシュが必要かを尋ねられた場合に reference/doctor.md を読み込みます。Setup の出力における CONTEXT_STALE ディレクティブは、同じレポートの簡易版です。その場合は、そこで指定された指示に従ってアクションを実行し、要求されていない doctor を実行しないでください。
デザインタスクの副作用として乖離を修復しないでください。 CONTEXT_STALE の結果は、ユーザーが要求しない限り報告のみ行われ、アクションは実行されません。唯一の例外は auto とマークされた結果で、これは該当ファイルへの次回書き込み時に自動的に実行されます。