編輯網站局部區域
目標
針對現有靜態網站的某個部分進行精準改善,同時保留網站其餘內容。
此技能適用於網站已存在後的迭代打磨。它應像仔細的局部編輯,而非重新生成的過程。
約定
輸入:
- 現有靜態網站資料夾、目標頁面、螢幕截圖/本機 URL,或目標區域的自然語言描述。
EDITING.md及相關的 HTML/CSS/JS 檔案。- 期望的前後對比文字、樣式、響應式行為或小型互動變更。
輸出:
- 對受影響的頁面區塊、元件、文案區塊、樣式規則或輕量互動進行的專注編輯。
- 僅在未來的編輯指示需要變更時,更新
EDITING.md。 - 簡要報告變更位置、變更的檔案以及執行的驗證。
邊界:
- 不要重建整個網站、變更主題方向、匯入文章、個人化多個欄位或發佈。
- 不要觸碰無關的頁面/資產。
- 不要引入相依性、建置步驟或根目錄絕對路徑的網站本地路徑。
成功門檻:
- 所請求的局部變更應顯示在編輯前確認過的相同瀏覽器區域中。
- 桌面/行動裝置或互動檢查應通過受影響的表面區域。
- 不應引入無關的版面或導覽變更。
若未通過門檻:
- 重新將瀏覽器區域對應到原始碼,並進行最小容錯編輯。
- 當問題影響共用導覽、多個頁面、資產、編碼或發佈準備狀態時,執行或建議使用「review-static-site」。
使用時機
當使用者要求以下事項時使用此技能:
- 變更一個區塊、卡片、區塊、元件或頁面區域。
- 將視覺細節變得更小、更平靜、更緊湊、更乾淨、更有趣、更技術性或更不分散注意力。
- 修正行動版面的問題、文字溢出、間距問題或尷尬的對齊。
- 調整小型互動,例如懸停效果、主題切換、選單行為、複製按鈕、篩選器、分頁或動畫。
- 重寫或縮短特定的可見文字。
- 針對局部區域比對螢幕截圖或使用者評論。
不要將此技能用於全站生成、主題搜尋、精確複刻新的參考網站、大規模個人內容替換、文章遷移、部署或框架轉換。
輸入
使用使用者提供的任何內容:
- 網站根目錄和目標頁面。
- 螢幕截圖、瀏覽器檢視、本機 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 中,這可能是 routed 到回合中的 Browser/in-app browser 插件;在其他代理中,它可能是等效的可見瀏覽器、browser-use 工具或基於開發工具後端的瀏覽器。編輯後,在互動式瀏覽器中返回相同的頁面和區域以驗證結果。
如果沒有可呼叫的互動式瀏覽器工具,請不要假設已發生編輯前後的瀏覽器確認。如果編輯依賴於視覺區域對應,請要求使用者啟用或呼叫瀏覽器工具;對於 Codex,這可能意味著發送一個明確提及 @browser 的請求。如果使用者未重新路由或用戶端沒有此類工具,則回退到 Playwright、螢幕截圖或原始碼檢查,並說明限制。
當互動式瀏覽器工具實際可呼叫時,不要預設使用 Playwright、僅依賴螢幕截圖的驗證或僅原始碼檢查。僅在沒有互動式瀏覽器工具可呼叫、使用者明確要求,或特別需要可重複的腳本回歸測試時,才將 Playwright 作為備用方案。
對於視覺、響應式或互動式編輯,請在相關的桌面/行動裝置視口中檢查變更區域,並測試變更後的互動。
僅當編輯影響共用導覽、全域版面、多個頁面、資產路徑、原始碼編碼或發佈準備狀態時,才執行或建議使用「review-static-site」。
如果編輯觸及 href、src、CSS url(...)、圖片、字型、favicon、資料檔案或 JavaScript 生成的 URL,請驗證受影響的頁面仍能使用頁面相對路徑正常運作,且直接開啟靜態檔案不會遺失 CSS、JS 或圖片。
輸出
對於局部編輯,僅報告:
- 變更的位置。
- 哪些檔案被變更。
- 執行了哪些驗證。
僅在實際建議執行時,才提及更廣泛的「review-static-site」驗證。不要重複報告或過度解釋整個程式碼庫。