AI-Ready Sites
自己完結型のウェブサイトおよびインターフェーススキルです。このスキルに必要なガイダンスはすべてここに含まれています。他のインストール済みスキルを読み込んだり、外部のデザインエンジンを呼び出したり、このワークフローを実行するためにグローバルな指示を必要としたりしないでください。ホストが提供するツールと、プロジェクトに既に適切な依存関係を使用してください。オプションの外部ツールは検証を強化しますが、それらがなくても設計や実装は妨げられません。
ユーザーの段階から始める
リクエスト、該当するプロジェクトの指示、スタック、既存のコンポーネント、および関連する製品/設計ドキュメントを検査します。変更の場合は、既存の実装と利用可能なレンダリングされたUIを検査します。結果と最も小さな有用なルートを簡潔に特定します。ユーザーのブリーフとプロジェクトのコンベンションが視覚的な選択を決定します。DESIGN.mdがなくても、リデザインを許可するわけではありません。
| リクエスト | 読み取りと実行 |
|---|---|
| 計画または議論 | ブリーフとUX、次に関連する設計ガイダンス。要求されない限り、プロジェクトファイルを変更せずに計画を提供。 |
| 新しいウェブサイトまたは大規模なリデザイン | ブリーフとUX → 設計 → 実装 → ブラウザQA および該当する品質 → 完了 |
| 小規模なコンポーネントまたはUI修正 | 影響を受ける部分を検査。関連する設計/実装ガイダンスのみを使用し、集中的なブラウザチェックと必要なプロジェクトチェックを実行。 |
| 監査/レビューのみ | 関連する設計/品質/ブラウザガイダンス。証拠を収集し、優先順位付けされた所見を報告。監査対象のプロジェクトを編集しない。 |
| モーション | モーション、影響を受けるUI、および動きを減らす設定の検証。 |
| サイトまたはインターフェースのテキスト | サイトとインターフェースのコピー および 編集レビュー。要求された範囲内で作成または編集。 |
| 取扱説明書または技術ドキュメント | テクニカルライティング および編集レビュー。ウェブサイトの構築を必要とせずに関連する手順を検証。 |
| RU/EN編集または翻訳 | 編集レビューに加えて、関連するコピー/ドキュメントガイド。事実、実行可能なテキスト、実際のUIラベルを保持。 |
| 出荷準備完了？ | 完了、現在のブラウザ証拠、および必要なプロジェクトチェック。デプロイメントを暗示しない。 |
必要なときに参照を読み込み、一度にすべてを読み込まないでください。これは機能の選択であり、必須の順序ではありません。有効な証拠を再利用し、異なる名前で同等のレビューを繰り返さないでください。
有用な作業を提供する
- 新しい作業の場合は、製品の事実を一貫した方向性に変え、1つの動作するユーザージャーニーを完成させてから拡張します。改良の場合は、範囲外の既存のアイデンティティと動作を維持します。リデザインの場合は、要求された視覚システムを変更しながら、製品の真実と必要な機能を維持します。
- 実際のコンテンツと動作するコントロールで構築します。デモデータ、ローカルシミュレーション、および利用できない統合にはラベルを付けます。顧客の引用、パフォーマンスの主張、価格、または動作するバックエンドを発明しないでください。
- コピーを作成または編集するときは、関連するテキストガイドを使用します。事実、条件、コマンド、および現在のUIラベルを維持します。明瞭さと有用性を向上させます。作成者検出スコアを最適化しないでください。テキストのみの作業は、要求された主張にそれらが必要でない限り、設計やブラウザの段階をトリガーしません。
- テキスト、フォーム、ナビゲーション、および状態を、キーボードおよび支援技術のセマンティクスとともに、意図された画面で使用可能にします。設計の野心は表面に適合します：表現力豊かなマーケティング、精密なタスクUI、読みやすい編集、または作業自体によって導かれるエクスペリエンス。
- 実際のブラウザで結果を観察して動作を確認します。視覚的な主張についてはスクリーンショットを検査します。ソース、クリックの成功、およびビルドの成功は、レンダリングされた結果を証明しません。
- ツール、認証、アセット、またはランタイムの前提条件が利用できない場合は、独立した作業を終了し、欠落している特定のチェックを述べます。PASSを偽造したり、無関係なツールをインストールしたり、ユーザーのスタックを黙って置き換えたりしないでください。
- 許可された範囲内で作業を維持します。サイトの作成は、公開、実際のフォーム送信、有料サービス、または本番環境の変更を許可しません。承認要求を繰り返さずに、通常の許可された作業を続行します。
ツールと移植性
すべての参照/スクリプトは、このSKILL.mdからの相対パスで解決します。個人のパス、特定のOS、外部スキル名、APIキー、フレームワーク、またはホスティングアカウントは必要ありません。ブラウザQAは、ツールの発見、ブラウザがない場合の動作、およびオプションの含まれているヘルパーをカバーします。Chrome DevToolsとPlaywrightはパッケージ内の指示であり、他のスキルへの依存関係ではありません。
含まれているNodeヘルパーはオプションです。scripts/doctor.mjsは、何もインストールせずに基本的なローカル機能を報告します。scripts/browser-check.mjsは、Playwrightとブラウザが既に存在する場合に限定されたスモークテストを実行します。--helpから始めてください。このスキルをホストツールで読み取り使用するためにNodeランタイムは必要ありません。
証拠を使って完了する
変更された表面または監査結果を最初に報告し、次に実際に実行されたチェック、関連する成果物、および制限事項を報告します。重要な納品物の場合は、プロジェクトのコンベンションに従って簡潔なQA証拠を保存します。小さな修正の場合は、最終的な返信で十分です。チェックを実行できなかった場合はNOT RUNと記載します。リリースPASSは、既知のブロッカーなしで実際に合格した必須チェックのために予約します。完了は、レポートと受け入れの境界を定義します。
帰属記録はTHIRD_PARTY_NOTICES.mdです。これは来歴であり、ランタイムの指示ではありません。アップストリームのCLI、バイナリ、有料サービス、または自動アップデータはバンドルされていません。