Communitygithub.com

Gyschuaner/from-idea-to-personal-site

使用此技能對已生成的靜態網站、個人部落格、作品集、數位花園或風格重現進行專注、小範圍的編輯調整。

from-idea-to-personal-site 是什麼?

此技能專為對現有靜態網站進行局部、精準的修改而設計,非常適合用於調整單一頁面區塊、元件、視覺細節、文案區塊、響應式問題或輕量互動效果,而無需重建整個網站。典型的使用情境包括修改英雄區塊、卡片佈局、側邊欄、頁尾、按鈕、行動選單、間距、顏色、排版、動畫強度或一小段頁面文案。該技能支援多種平台(如 Claude Code、Cursor、Codex 等)並採用結構化的工作流程:首先確認目標區域,接著編輯相關的 HTML/CSS/JS 檔案,然後進行驗證。其核心原則在於保持編輯的局部性,避免引入全域變更、新依賴或建置步驟,並維護現有的設計語言。若變更影響範圍超出單一區域,則會建議使用更廣泛的「review-static-site」技能。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Gyschuaner/from-idea-to-personal-site/tree/HEAD/.agents/skills/edit-site-part

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

編輯網站局部區域

目標

針對現有靜態網站的某個部分進行精準改善,同時保留網站其餘內容。

此技能適用於網站已存在後的迭代打磨。它應像仔細的局部編輯,而非重新生成的過程。

約定

輸入:

  • 現有靜態網站資料夾、目標頁面、螢幕截圖/本機 URL,或目標區域的自然語言描述。
  • EDITING.md 及相關的 HTML/CSS/JS 檔案。
  • 期望的前後對比文字、樣式、響應式行為或小型互動變更。

輸出:

  • 對受影響的頁面區塊、元件、文案區塊、樣式規則或輕量互動進行的專注編輯。
  • 僅在未來的編輯指示需要變更時,更新 EDITING.md。
  • 簡要報告變更位置、變更的檔案以及執行的驗證。

邊界:

  • 不要重建整個網站、變更主題方向、匯入文章、個人化多個欄位或發佈。
  • 不要觸碰無關的頁面/資產。
  • 不要引入相依性、建置步驟或根目錄絕對路徑的網站本地路徑。

成功門檻:

  • 所請求的局部變更應顯示在編輯前確認過的相同瀏覽器區域中。
  • 桌面/行動裝置或互動檢查應通過受影響的表面區域。
  • 不應引入無關的版面或導覽變更。

若未通過門檻:

  • 重新將瀏覽器區域對應到原始碼,並進行最小容錯編輯。
  • 當問題影響共用導覽、多個頁面、資產、編碼或發佈準備狀態時,執行或建議使用「review-static-site」。

使用時機

當使用者要求以下事項時使用此技能:

  • 變更一個區塊、卡片、區塊、元件或頁面區域。
  • 將視覺細節變得更小、更平靜、更緊湊、更乾淨、更有趣、更技術性或更不分散注意力。
  • 修正行動版面的問題、文字溢出、間距問題或尷尬的對齊。
  • 調整小型互動,例如懸停效果、主題切換、選單行為、複製按鈕、篩選器、分頁或動畫。
  • 重寫或縮短特定的可見文字。
  • 針對局部區域比對螢幕截圖或使用者評論。

不要將此技能用於全站生成、主題搜尋、精確複刻新的參考網站、大規模個人內容替換、文章遷移、部署或框架轉換。

輸入

使用使用者提供的任何內容:

  • 網站根目錄和目標頁面。
  • 螢幕截圖、瀏覽器檢視、本機 URL 或問題的自然語言描述。
  • 要變更的確切文字、區塊名稱、類別名稱或視覺區域。
  • EDITING.md(如果存在)。
  • 現有的 HTML/CSS/JS 檔案。
  • 任何期望的前後對比文字或樣式方向。

如果目標區域不明確,請檢查網站並做出最合理的狹義解釋。僅當多種可行編輯方案會產生截然不同的結果時,才提出簡短的澄清問題。

工作流程

  1. 編輯前,使用瀏覽器確認目標頁面和目標區域。
  2. 讀取 EDITING.md(如果存在),然後檢查相關的 HTML/CSS/JS。
  3. 使用搜尋功能尋找相符的可見文字、ID、類別、資料區塊或類似元件的標記。
  4. 將已確認的瀏覽器區域對應到相關的原始檔、選擇器、資料區塊或事件處理常式。
  5. 進行最小且連貫的編輯以滿足請求。
  6. 除非使用者明確要求變更,否則維持現有的設計語言。
  7. 編輯後,返回瀏覽器中的相同頁面和區域,驗證變更。
  8. 報告變更了什麼,並提及任何需要進行的後續驗證。

範圍控制

保持編輯的局部性。

  • 偏向編輯現有的區塊、類別或資料物件,而非建立平行的副本。
  • 避免在區塊層級的變更就足夠時重寫整個頁面。
  • 除非使用者希望進行全站樣式變更,否則避免變更共用的 CSS 變數。
  • 避免觸碰無關的頁面、資產或內容。
  • 保留導覽、頁面地圖、佔位策略和 EDITING.md 的慣例。
  • 保留網站的路徑策略;在局部編輯期間,不要引入根目錄絕對路徑的網站本地路徑,例如 /assets/...、/posts/...、/images/... 或 /data/...。
  • 如果一個小請求暴露了更大的結構性問題,在進行廣泛變更前解釋其取捨。

當使用者要求在跨多個頁面進行廣泛的視覺轉變時,建議使用更大規模的生成或重新設計技能,而不是擴展此技能。

定位正確位置

使用分層查找:

  1. 搜尋可見文字或附近的標籤。
  2. 搜尋 EDITING.md 中的區塊/頁面對應。
  3. 檢查導覽連結和頁面檔名。
  4. 檢查語意標籤,例如 header、main、section、article、aside 和 footer。
  5. 檢查 CSS 選擇器和 JavaScript 事件掛鉤。
  6. 當原始碼位置不明顯時,使用瀏覽器開發工具或螢幕截圖。

如果重複內容是從資料渲染的,請編輯原始資料,而不僅僅是看起來像生成的標記。

設計保留

使編輯融入當前網站。

  • 重複使用現有的間距、排版、顏色、邊框、陰影、圖示和動畫模式。
  • 確保文字在桌面和行動裝置上都能容納在其容器內。
  • 避免裝飾效果干擾閱讀。
  • 在變更動畫時,尊重 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」驗證。不要重複報告或過度解釋整個程式碼庫。

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

Gyschuaner/from-idea-to-personal-site

Use this skill to add, import, or migrate one or more blog posts, notes, essays, articles, Markdown files, Word documents, or rich-content writing folders into an existing static personal website or blog while preserving the site's current article style, content structure, navigation, indexes, archives, tags, assets, math, links, tables, code blocks, embeds, and homepage entry points. Use it for pasted posts, local Markdown files, Obsidian notes, .docx drafts, old static HTML posts, exported blog content, or small-to-medium batches of posts after a site has already been created.

Gyschuaner/from-idea-to-personal-site

Route and coordinate the personal website skill suite for creating, recreating, personalizing, adding content to, validating, editing, or preparing a static personal website or blog. Use when the agent needs to choose between theme search, style reference research, original build, website style recreation, personalization, post import, review, local edits, or publishing preparation, or when the user asks what step comes next in an existing site-building workflow.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to recreate, copy, clone, remix, or closely match the look, layout, motion, or interaction feel of a specific website, URL, screenshot, or template using plain HTML, CSS, and JavaScript. Use it to inspect public source as research, rewrite original code, avoid direct reuse of protected assets, and validate the result in a browser.

Gyschuaner/from-idea-to-personal-site

Use this skill after a personal website or blog style direction is roughly known and before building an original site. It searches for real websites, templates, portfolios, blogs, screenshots, or design examples that match the chosen direction, inspects them with browser or screenshot tools when available, and turns the findings into a practical design reference brief for make-personal-site. Use it for requests like finding references for a natural technical blog, cozy research homepage, brutalist portfolio, digital garden, minimal notes site, or any named visual direction that still needs concrete examples.

Gyschuaner/from-idea-to-personal-site

Run the complete idea-to-personal-website or blog workflow. Use when the user wants a one-click or end-to-end pipeline from a vague idea, reference URL, template, personal materials, style direction, or writing drafts to concrete style references, a validated static personal site, and optionally a live deployment on GitHub Pages, Cloudflare Pages, Netlify, or Vercel.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to create, implement, redesign, or update a zero-dependency personal website, personal blog, homepage, portfolio, research homepage, or digital garden using plain HTML, CSS, and JavaScript. Use it after a theme direction has been chosen, or when the user wants a no-framework site that can be opened directly in the browser and deployed as static files.

Gyschuaner/from-idea-to-personal-site

Use this skill to turn a generated static personal website, blog, portfolio, digital garden, or style recreation into the user's own site by replacing placeholder identity, profile copy, links, projects, featured items, contact details, metadata, and demo page content. Use it after make-personal-site or copy-website-style, or when a user provides an existing static site folder and personal materials such as a bio, resume, README, GitHub profile, old homepage, Markdown notes, or social links.

Gyschuaner/from-idea-to-personal-site

Publish, deploy, or prepare a finished static personal website, blog, portfolio, or style recreation for hosting on GitHub Pages, Cloudflare Pages, Netlify, or Vercel. Use when the user asks to publish a static site, configure deployment settings, add GitHub Pages workflows, choose a static hosting platform, prepare a repo for Pages/Cloudflare/Netlify/Vercel, verify a deployed URL, or explain how to deploy a site folder such as site/, dist/, out/, public/, or docs/.

Gyschuaner/from-idea-to-personal-site

Use this skill to inspect, validate, QA, or sanity-check a generated static website, personal blog, portfolio, digital garden, or style recreation before handoff or publishing. Use it for local folders such as site/, dist/, out/, or public/ to check broken links, missing page types, browser rendering, console errors, desktop/mobile screenshots, UTF-8 source readability, mojibake, relative asset paths, direct-open/file compatibility, placeholder content, and leftover copied source-specific text.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to find, compare, choose, or adapt a visual theme for a personal blog, personal homepage, portfolio, research homepage, digital garden, or static website. Use it to turn references from v0, Figma, GitHub themes, existing websites, screenshots, keywords, or natural-language taste preferences into natural, practical theme recommendations.

相關技能