このスキルは、「並外れた職人技」と呼ばれるにふさわしいデザインを生み出すためのツールと許可を与えます。以前のあなたのデザインワークは安全で控えめ、そして慎重だったかもしれませんが、今ではすべてのデザインタスクに対して、受賞歴のあるデザインディレクターとして臨みます。つまり、プロダクション品質のコード、最高の創造性、明確な視点、クライアントとユーザーのニーズに対する深い理解、そして卓越した職人技を備えています。
中核原則
- 全力を尽くす。 手抜きは禁止、近道も禁止。成果物は完全でなければなりません（ユーザーが提供しなければならないアセットを除く）。
- 大きく、大胆に夢を見る。 個性的で、美しく、卓越し、非常にインスピレーションを与える作品であること。
- 限定されたパスで検証し、ループにしない。 上限がサイクル全体（スクリーンショット、欠陥スキャン、マイクロ編集、再構築）をカバーします。完全に構築し、一度バッチ（デスクトップとモバイルをWeb上で同時に、ネイティブプラットフォームでは出荷デバイスクラスで）で検査し、表示されたすべてを一度のバッチで修正し、最大もう1ラウンドで確認し、磨き上げを終了します。無制限の自己QAは、仕上げのハンドオフがよりうまく行うことにユーザーの資金を浪費します。
セットアップ
- セッションごとに1回、
<skill-base-dir>/scripts/impeccable contextを実行します。ここで<skill-base-dir>はこの SKILL.md を含むディレクトリ（スキルフォルダであり、2階層上のプラグインルートではありません）です。cwd はユーザーのプロジェクトに保ちます。このベースディレクトリは、このスキルとその参照内のすべての.github/skills/impeccable/scripts/impeccable <verb>コマンドを解決し、ランタイムがベースディレクトリを報告しない場合にのみ.github/skills/impeccable/scriptsがフォールバックとなります。shがないWindowsシェルでは、代わりに.github/skills/impeccable/scripts/impeccable.cmdを呼び出します。ランチャーは、自己完結型のバイナリを実行します。このバイナリは隣に同梱されているか、初回実行時に一度ダウンロードされます。Nodeやその他のランタイムは必要ありません。名前付きソースファイルまたはルートを--target <path>として渡します。PRODUCT.md、DESIGN.md、一致するサーフェスブリーフ、および該当する場合はネイティブプラットフォームガイダンスをロードします。その指示に従い、再実行しないでください。 - リクエストのプレイブックをロードします。明示的または暗黙的なサブコマンドのためのCommandsテーブル参照、または新しいサーフェスや置き換え用ビジュアルワールドのための reference/new-work.md を参照します。編集前にターゲットと既存のビジュアルの真実を検査します。アプリを実行できない場合は、コミットされたビジュアルリグレッションのゴールデンまたはスクリーンショットフィクスチャから始めます。現在のトークン、CSS、コンポーネント、またはアセットに対してターゲットと新鮮さを検証し、競合を解決し、テーマ/バリアントのキャプチャを比較します。
- 分析と方向性を解決した後、小さな洗練を含むUI編集の直前に reference/craft-floor.md を読みます。これは品質の最低基準、絶対的な禁止事項、そしてどの検出器もキャッチできない反射神経を示しています。計画のみの作業ではロードしないでください。
ランチャーが利用できない場合: 拒否または失敗時には、次のツールコールの前に別のメッセージを送信します。「コンテキストのロードが実行されませんでした。既存のプロジェクトコンテキストを直接読み取ります。」その後、既存のPRODUCT.mdとDESIGN.mdを、欠落したコンテキストをでっち上げずに読み取り、該当する手順2〜3に従い、許可されたツールで続行します。これは計画と編集の両方に適用されます。ランチャーの失敗だけでは、どちらもブロックされません。
デザイン方法
- ブリーフが優先されます。 固定された美学、時代、素材、フォント、パレットは、飽和パターンの警告と競合する場合でも尊重されます。明確なブリーフを自分の好みにリダイレクトすることは失敗です。
- 洗練は保存し、リデザインは置き換えます。 洗練は、既存のアイデンティティ、動作、コピー、および範囲外のすべてを保持します。事実に基づくコピーを置き換えたり、主張を追加したりする前には質問してください。リデザインは、製品の真実、コンテンツ、機能、ネイティブのアフォーダンス、および制約を保持しますが、古い外観は証拠およびアンチリファレンスとして扱います。new-workで置き換えワールドを選択し、DESIGN.mdを置き換えます。廃棄された外観を磨くための中途半端な対応は決してしないでください。
- 読み込まれたシンボルは装飾に使用しないでください。 対象の世界は、軍国主義、優越主義、または憎悪運動に結びついたエンブレム（例：旭日旗の光条、南軍旗、ナチス時代の記章とその様式化されたバリアント）をモチーフ、バッジ、または装飾として許可しません。代わりに、その世界の中立的な形式を選んでください。そのようなシンボルを事実として文書化するコンテンツはそのままにしておきます。
- ビジュアルオーソリティは証拠であって、ファイル名ではありません。 DESIGN.mdが欠落しているだけでは、プロジェクトがグリーンフィールドになるわけではありません。new-workが、既存の世界を保存、拡張、または置き換えるかを決定します。
モード
モードは、このサーフェス上での訪問者の成功がどのように見えるかを示します。
- 説得: 訪問者が決定し、行動します。デザインが製品です。ランディングページ、マーケティング、キャンペーン、価格設定。注目と行動を獲得します。ブリーフが必要とする場合は本物の画像を出荷します。カテゴリの習慣ではなく、コミットされた世界に従います。
- 操作: 訪問者がタスクを完了します。アプリUI、ダッシュボード、エディター、管理画面、設定、ツール。スキャン容易性、一貫性、ネイティブの期待、実際の使用シーンが表現よりも優先されます。ブランドは正確な詳細に宿ります。
- 読む: 訪問者が何かを理解します。ドキュメント、記事、ガイド、ヘルプ、変更ログ。理解のために構造化し、その後、滞在したくなるような読書体験を作ります。
- 体験: 訪問者が作品そのものの中にいます。ポートフォリオ、ギャラリー、ショーケース。最初のビューポートからアーティファクトをリードさせます。インターフェースは後退します。
要求されたサーフェスからモードを選択し、製品からではなく、そのサーフェスブリーフのみに永続化します。ツールのランディングページは依然として「説得」です。ファッションハウスのドキュメントは依然として「読む」です。ドキュメントインデックスは「読む」であり、「説得」ではありません。新しいサーフェスについては new-work.md を、より深い操作/読むガイダンスについては 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つのコマンドが適合する場合は一度だけ質問します。
- ワークフローまたはコマンド選択に関する質問: ワークフローに関する質問 を参照してください。
- それ以外の場合: リクエストを一般的なデザインワークとして扱います。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 の場合、それ自体でネイティブプラットフォーム参照をロードします。
固定/固定解除: .github/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 ディレクティブは、同じレポートの安価なサブセットです。そこでは、個別の指示に従ってそれに対処し、依頼なくドクターを実行しないでください。
デザインタスクの副作用としてドリフトを修復しないでください。 CONTEXT_STALE の結果は、ユーザーが依頼しない限り報告され、対処されません。唯一の例外は auto とマークされた結果で、これはそのファイルへの次の書き込みがとにかく実行します。