サイトの一部を編集 は何をしますか?
目標
既存の静的サイトの特定部分に対して、影響範囲を限定した改善を行い、サイトの他の部分はそのまま維持します。
このスキルは、サイトがすでに存在した後の反復的な調整のためのものです。新しい生成パスではなく、注意深いローカル編集のように機能します。
契約
入力:
- 既存の静的サイトフォルダ、ターゲットページ、スクリーンショット/ローカルURL、またはターゲット領域の自然言語による説明。
EDITING.mdおよび関連するHTML/CSS/JSファイル。- 望ましい変更前/変更後のテキスト、スタイル、レスポンシブ動作、または小さなインタラクションの変更。
出力:
- 影響を受けるページセクション、コンポーネント、コピーブロック、スタイルルール、または軽量インタラクションへの限定された編集。
- 将来の編集指示を変更する必要がある場合にのみ
EDITING.mdを更新。 - 変更が行われた場所、変更されたファイル、実行された検証の簡単なレポート。
境界:
- サイト全体を再構築したり、テーマの方向性を変更したり、投稿をインポートしたり、複数のフィールドを個人化したり、公開したりしないでください。
- 無関係なページ/アセットには触れないでください。
- 依存関係、ビルドステップ、またはルート絶対パスのサイトローカルパスを導入しないでください。
成功条件:
- リクエストされたローカル変更が、編集前に確認されたと同じブラウザ領域で表示されること。
- 影響を受ける面に対して、デスクトップ/モバイルまたはインタラクションチェックに合格すること。
- 無関係なレイアウトやナビゲーションの変更が導入されていないこと。
条件失敗時:
- ブラウザ領域をソースに再マッピングし、最小限の修正編集を行います。
- 問題が共有ナビゲーション、多数のページ、アセット、エンコーディング、または公開準備に影響する場合は、
review-static-siteを実行または提案します。
使用する場合
ユーザーが次のことを依頼した場合にこのスキルを使用します:
- 1つのセクション、カード、ブロック、コンポーネント、またはページ領域を変更する。
- ビジュアル詳細をより小さく、落ち着いた、密度の高い、クリーンな、遊び心のある、より技術的な、または邪魔にならないようにする。
- モバイルレイアウトの問題、テキストオーバーフロー、スペーシングの問題、または不自然な配置を修正する。
- ホバー、テーマトグル、メニュー動作、コピーボタン、フィルター、タブ、アニメーションなどの小さなインタラクションを調整する。
- 特定の可視テキストを書き換えたり短くしたりする。
- 局所的な領域について、スクリーンショットやユーザーのコメントに一致させる。
このスキルは、全サイト生成、テーマ検索、新しいリファレンスサイトのクローズ再現、大規模なパーソナルコンテンツ置換、記事移行、デプロイ、またはフレームワーク変換には使用しないでください。
入力
ユーザーが提供するものを使用します:
- サイトルートフォルダとターゲットページ。
- 問題のスクリーンショット、ブラウザビュー、ローカルURL、または自然言語による説明。
- 変更する正確なテキスト、セクション名、クラス名、またはビジュアル領域。
- 存在する場合は
EDITING.md。 - 既存のHTML/CSS/JSファイル。
- 変更前/変更後の文言やスタイルの方向性の希望。
ターゲット領域が不明瞭な場合は、サイトを検査し、最も小さな合理的な解釈を行います。複数の可能性のある編集が非常に異なる結果を生む場合にのみ、短い確認を求めます。
ワークフロー
- 編集前に、ブラウザを使用してターゲットページとターゲット領域を確認します。
EDITING.mdが存在する場合はそれを読み、関連するHTML/CSS/JSを検査します。- 検索を使用して、一致する可視テキスト、ID、クラス、データブロック、またはコンポーネントのようなマークアップを見つけます。
- 確認されたブラウザ領域を関連するソースファイル、セレクタ、データブロック、またはイベントハンドラにマッピングします。
- リクエストを満たす最小の一貫性のある編集を行います。
- ユーザーが明示的に変更を依頼しない限り、既存のデザイン言語を維持します。
- 編集後、ブラウザで同じページと領域に戻り、変更をそこで確認します。
- 何が変更されたかを報告し、必要なフォローアップ検証があれば言及します。
スコープ制御
編集を局所的に保ちます。
- パラレルな重複を作成するのではなく、既存のセクション、クラス、またはデータオブジェクトを編集することを優先します。
- セクションレベルの変更で十分な場合は、ページ全体の書き換えを避けます。
- ユーザーがサイト全体のスタイル変更を望まない限り、共有CSS変数の変更を避けます。
- 無関係なページ、アセット、またはコンテンツに触れないでください。
- ナビゲーション、ページマップ、プレースホルダー戦略、および
EDITING.mdの規則を維持します。 - サイトのパス戦略を維持します。ローカル編集時に、
/assets/...、/posts/...、/images/...、/data/...などのルート絶対パスのサイトローカルパスを導入しないでください。 - 小さなリクエストがより大きな構造的問題を明らかにした場合は、広範な変更を行う前にトレードオフを説明します。
ユーザーが複数ページにわたる広範なビジュアルシフトを要求した場合は、このスキルを拡張するのではなく、より大規模な生成または再デザインのスキルを提案します。
正しい場所の特定
階層的なルックアップを使用します:
- 可視テキストまたは近くのラベルを検索します。
EDITING.mdでセクション/ページマップを検索します。- ナビゲーションリンクとページファイル名を検査します。
header、main、section、article、aside、footerなどのセマンティックタグを検査します。- CSSセレクタとJavaScriptイベントフックを検査します。
- ソースの場所が明らかでない場合は、ブラウザの開発ツールまたはスクリーンショットを使用します。
繰り返しコンテンツがデータからレンダリングされている場合は、生成されたように見えるマークアップだけではなく、ソースデータを編集します。
デザインの保存
編集を現在のサイトに適合させます。
- 既存のスペーシング、タイポグラフィ、色、境界線、影、アイコン、およびモーションパターンを再利用します。
- テキストをデスクトップとモバイルの両方でコンテナ内に収めます。
- 装飾効果が読書の妨げにならないようにします。
- アニメーションを変更する場合は、
prefers-reduced-motionを尊重します。 - ユーザーが別の要望をしない限り、記事/詳細ページは高度にスタイル設定されたホームページよりも落ち着いたものにします。
- 個人のウェブサイトやブログに、マーケティングスタイルのヒーローや無関係な装飾セクションを追加しないでください。
コピーを変更する場合は、既存の声とユーザーの言語に一致させます。
インタラクション編集
JavaScriptまたはインタラクション変更の場合:
- 新しいイベントリスナーを追加する前に、既存のイベントリスナーと状態の規則を見つけます。
- サイトがプレーンな静的サイトの場合は、バニラJavaScriptを維持します。
- 依存関係やビルドステップの導入を避けます。
- JavaScriptでリンク、検索結果、画像URL、またはナビゲーション項目を生成する場合は、影響を受けるページの深さから機能するページ相対パスを使用します。
- 関連する場合は、クリック、キーボード、モバイル、および繰り返し使用の状態をテストします。
- フォーカス、ラベル、およびモーション軽減動作などのアクセシビリティの基本を維持します。
レスポンシブ修正
レイアウトまたはモバイルの問題の場合:
- デスクトップとモバイルの両方の幅を確認します。
- デスクトップレイアウトを維持しながら狭い画面を修正するCSS変更を優先します。
- 安定したサイズ、ラッピング、最小/最大幅、グリッド/フレックス調整、およびオーバーフロー制御を使用します。
- レイアウトを収めるためだけに、モバイルで重要なコンテンツを非表示にしないでください。
編集ガイド
変更が将来の編集方法に影響を与える場合は、EDITING.md を更新します。
次の場合に更新します:
- 新しいセクション、クラス、データフィールド、またはインタラクションパターンが導入された場合。
- コンテンツストレージが新しいファイルまたはデータオブジェクトに移動した場合。
- ユーザーが将来のエージェントが保持する必要がある変更をリクエストした場合。
小さなコピーやスペーシングの変更については、ガイドが誤解を招く場合を除き、EDITING.md を更新しないでください。
検証
影響を受ける面を検証します。サイト全体を検証する必要は必ずしもありません。
編集前に、実際に利用可能なインタラクティブブラウザツールを使用してターゲットページと領域を確認します。「利用可能」とは、現在のターンで呼び出し可能なツールリストに公開されていることを意味します。Codexでは、これがターンにルーティングされた場合のブラウザ/アプリ内ブラウザプラグインである可能性があります。他のエージェントでは、同等の可視ブラウザ、ブラウザ使用ツール、または開発ツールバックのブラウザである可能性があります。編集後、インタラクティブブラウザで同じページと領域に戻り、結果を確認します。
インタラクティブブラウザツールが呼び出し可能でない場合は、変更前/変更後のブラウザ確認が行われたふりをしないでください。編集がビジュアル領域のマッピングに依存する場合は、ユーザーにブラウザツールの有効化または呼び出しを依頼します。Codexの場合、それは @browser を明示的に言及するリクエストを送信することを意味する場合があります。ユーザーが再ルーティングしない場合、またはクライアントにそのようなツールがない場合は、Playwright、スクリーンショット、またはソース検査にフォールバックし、その制限を明記します。
インタラクティブブラウザツールが実際に呼び出し可能な場合でも、Playwright、スクリーンショットのみの検証、またはソース検査だけにデフォルトでフォールバックしないでください。Playwrightは、インタラクティブブラウザツールが呼び出し可能でない場合、ユーザーが明示的に要求した場合、またはスクリプト化された再現可能な回帰テストが特に必要な場合にのみ、フォールバックとして使用します。
ビジュアル、レスポンシブ、またはインタラクティブな編集の場合は、関連するデスクトップ/モバイルビューポートで変更された領域を確認し、変更されたインタラクションを実行します。
影響が共有ナビゲーション、グローバルレイアウト、多数のページ、アセットパス、ソースエンコーディング、または公開準備に及ぶ場合にのみ、review-static-site を実行または提案します。
編集が href、src、CSS url(...)、画像、フォント、ファビコン、データファイル、またはJavaScriptで生成されたURLに触れる場合は、影響を受けるページがページ相対パスで引き続き機能し、静的ファイルを直接開いてもCSS、JS、または画像が失われないことを確認します。
出力
ローカル編集の場合、以下だけを報告します:
- 変更が行われた場所。
- どのファイルが変更されたか。
- どのような検証が行われたか。
review-static-site によるより広範な検証は、実際に推奨される場合にのみ言及します。レポートを繰り返したり、コードベース全体を過剰に説明したりしないでください。