AgentKit SEO Web Portfolio
概述
使用此技能來改善個人網站被搜尋引擎與 AI 系統爬取、渲染、摘要及信任的方式。
參考文件選用
- 可爬取性、Sitemap、Robots、上線、URL 結構:references/indexing-and-architecture.md
- 標題、Canonical、Schema、JavaScript 渲染:references/metadata-structured-data-and-js.md
- 首頁、關於、專案頁面、中繼資料、
llms.txt文案:references/section-recipes.md - 案例分析、效能、AI 檢索慣例:references/content-performance-and-aeo.md
- 現有網站審計或維護:references/portfolio-audit-and-maintenance.md
Wiki 上下文
- 當任務詢問關於
llms.txt、AI 檢索、證據標籤、來源可信度、平台限制或已知的代理失敗模式時,請閱讀 wiki/index.md。 - 只有在 wiki/index.md 將當前任務導向那裡之後,才閱讀 wiki/knowledge.md。
- 如果某個 wiki 檔案在舊版安裝中不可用,請繼續使用相關的
references/檔案,並在影響可信度時標記 wiki 特定指引為不可用。
Token 使用紀律
- 對於 URL 審計,首先檢查首頁、robots、sitemap 以及僅優先頁面。
- 對於本地原始碼工作,在開啟大量檔案之前,先搜尋中繼資料、路由、佈局和結構化資料。
- 不要為了技術性的可爬取性修復而載入內容寫作參考文件。
- 在閱讀廣泛的內容檔案之前,優先處理渲染後的/公開 HTML、路由中繼資料、sitemap、robots 和頁面模板。
- 保持來源記錄簡潔:列出輸入群組,而非每一個資產或路由。
- 如果範圍有限,請命名下一次檢查項目。
深度契約
使用最小且誠實的審計深度:
快速掃描:首頁、robots、sitemap、標題/meta/canonical 基本設定、主要導覽及可見定位。預設審計:快速掃描加上最多 2 個使用者指定或明顯重要的頁面、結構化資料、Open Graph、內部連結,以及(當可用時)主要專案頁面。深度審計:完整路由盤點、建構後的 HTML/來源模板、效能/行動端檢查、重新導向/狀態碼、Schema 驗證、損壞連結及程式碼編輯。
對於廣泛的作品集審計,預設採用 預設審計。當當前答案可從更多證據中受益時,提供 深度審計 作為可選的下一步驟。除非使用者要求完整的網站審計、確切的程式碼變更、上線驗證或檢查每個重要路由,否則不要靜默地選擇 深度審計。
輸入工作流程
- 如果使用者提供公開的作品集 URL,則在工具允許的情況下,擷取並檢查首頁、重要頁面、中繼資料、Canonicals、Sitemap、Robots、結構化資料以及可見文案。
- 如果作品集原始碼可在本地取得,且使用者要求實作,則檢查原始碼並優先進行中繼資料、結構化資料、語義 HTML、連結和內容的直接程式碼編輯。對於僅審計的請求,除非使用者要求編輯,否則回傳補丁就緒的建議。
- 如果公開爬取被阻擋或網站尚未部署,請要求提供本地原始碼路徑、建構後的 HTML、螢幕截圖、頁面清單或貼上的頁面文案。
- 如果網站文案依賴於自傳、專案聲明或職業經歷,則建議在改寫前使用代理上下文檔案。
- 不要為了填充作品集頁面而虛構專案、推薦信、指標、雇主或憑證。
規則
- 將已記錄的標準與新興慣例(如
llms.txt)區分開來。 - 區分來自公開頁面或本地原始碼的事實、使用者上下文材料提供的事實,以及從這些事實推論出的建議。
- 優先選擇那些能改善可爬取性、資訊氣息和摘要品質,而不增加誇大成分的變更。
- 不要將非官方的 AI 或 SEO 提案呈現為通用標準。
- 保持中繼資料、結構化資料和可見文案一致。
- 對於同一個頁面,保持標題、描述、Canonical URL、Open Graph、X/Twitter card、JSON-LD URL、JSON-LD 名稱或標題、JSON-LD 描述以及代表性圖片的一致性。
- 使結構化資料與頁面用途相匹配。僅對具有受支援的作者、日期和正文內容的可見文章類頁面使用文章類 Schema。
- 將排名、豐富結果、圖片縮圖、摘要和索引速度視為合格結果,而非保證。
- 保持頁面用途、URL 結構、內部連結和證明資產一致,使每個重要聲明都能對應到一個可爬取的頁面。
- 當事實缺失時,在虛構作品集文案或結構化資料之前,先詢問 Canonical URL、頁面清單或原始內容。
- 在編輯作品集程式碼時,除非使用者明確要求重新設計,否則保留現有的樣式和應用程式邏輯。優先進行中繼資料、結構化資料、語義 HTML、可爬取性和內容的變更,然後再進行佈局變更。
- 對於直接的程式碼編輯,在專案提供時執行可用的建置、lint、測試或預覽指令,並回報任何無法執行的驗證。
回應格式
回傳:
- 檢查過的 URL 或本地檔案
- 可爬取性、中繼資料、結構化資料和內容的問題
- 直接的程式碼編輯或頁面就緒文案
- 已執行的驗證或仍需要的檢查
- 影響公開聲明的上下文檔案缺口
對於審計,當某個聲明可能產生歧義時,使用簡潔的標籤,例如已驗證、來自來源、來自上下文、推論和無法存取。將不支援的責任、指標、資深程度、客戶、推薦信或成果標記為缺口,而不是將它們轉化為中繼資料、Schema 或文案。當審計有意識地被限制時,請包含一行深度註記,說明未檢查的內容以及更深入的檢查會帶來什麼。
人類操作手冊:hub/web-portfolio/README.md。