zaDojo
所有文件

SEO 報告技能：可分享的 HTML 報告

zaDojo 技能如何交付成果：一份獨立的 HTML 報告存到你的專案中，可閱讀、列印或透過連結分享。報告不消耗點數。

SEO Report 是其他 zaDojo 技能用來交付成果的技能。當你的代理完成稽核、關鍵字研究或競爭對手分析時，這項技能會告訴它如何把發現寫成一個 HTML 頁面，並存到你的 zaDojo 專案中。頁面會出現在專案的 Reports 頁面，你的團隊可以在應用程式中、手機上或紙本上閱讀。

重點是讓完成的工作不會淹沒在對話紀錄裡。報告有標題、日期、固定版面，以及在專案中的固定位置，下個月你和下一個代理都找得到。

使用方式

大多數時候你不需要呼叫它。只要要求你想要的工作流程，報告就會隨之產生：

/zadojo:keyword-research 為我們的價格頁找關鍵字。

當你想要一份其他技能都沒涵蓋的書面整理時，可以直接呼叫它，例如本月工作的簡短進度回報，或依照你儲存的範本撰寫的報告：

用 seo-report 為客戶寫一頁本月排名變化的摘要。

代理儲存報告時會做什麼

  1. 它會先呼叫 list_reports。如果已有相同主題與期間的報告，代表代理是在修正自己的成果，所以會取代那份報告，而不是再加一份幾乎相同的副本。新的月份、新的競爭對手或不同的技能，則會產生新報告。
  2. 它會寫簡短的筆記。結論與對業務的意義放在最前面。每項建議都會說明問題是什麼（附證據）、要改什麼，以及可能帶來什麼改善，包括代理的把握程度。數字會註明是來自工具，還是經過人工確認。
  3. 它會建立一個獨立完整的頁面。所有樣式都在檔案內，不載入網頁字型、腳本或其他網站的圖片，所以頁面在任何地方顯示都一樣，列印也很乾淨。圖表使用內嵌 SVG 或簡單長條，並一律在旁邊標出數字。
  4. 最後一節「這份報告是如何製作的」會列出產生報告的技能、連到本文件中該技能的頁面，並說明哪些數字來自哪些工具、哪些由代理自行驗證。
  5. 除了頁面之外，save_report 還會儲存一段簡短摘要，由 list_reports 回傳，讓之後的工作階段不必打開完整 HTML 也能接手。
  6. 對話中的回覆保持簡短：最多三個重點（結論、首要建議，以及任何需要你處理的事項），後面附上連結。

在哪裡找到你的報告

從專案側邊欄打開 Reports 頁面。報告標題會寫出報告類型或主題，加上撰寫的完整日期。標題不會寫你自己的網站；如果報告是關於別人的網站，則會寫出對方的網域。打開報告後，你可以全螢幕檢視、在新分頁開啟，或列印成 PDF。

已儲存的報告沒有版本紀錄。代理修正報告時，新版本會取代舊版本。

每份報告一開始都只對你的組織開放。若要分享，可以：

  • 告訴你的代理：「把這份報告設為公開，並給我分享連結」，或
  • 打開報告，點 Share 並開啟 Public link。

任何持有連結的人都能閱讀報告，不需要 zaDojo 帳號。連結永遠顯示最新儲存的版本，分享頁面也會告訴搜尋引擎不要收錄。關閉開關後連結就會失效（已經打開頁面的人，最多還能再載入一分鐘）。之後重新開啟分享，會產生新的連結。

只有在你明確要求時，代理才會公開報告。要求一份「可以交給客戶」的報告，並不會讓它變成公開。

報告範本

範本是針對某類報告儲存的撰寫指引：讀者是誰、包含哪些段落與順序、語氣，以及結尾署名。你可以在 Templates 頁面管理範本，從 Reports 頁面即可進入。範本屬於單一專案。若要在其他地方重複使用，請代理在第一個專案中列出範本，再把副本存到第二個專案。

當你指名某個範本，或要求它所描述的那類報告時，代理就會依照範本撰寫，例如「為 example.com 撰寫每月客戶更新」。單純說「稽核這個網站」仍會使用技能的標準格式。範本會改變段落、受眾與語氣，但無法改變頁面的建構方式，所以套用範本的報告仍然可以列印、在手機上正常顯示。你專案的寫作偏好會疊加在上面，只有在兩者衝突時才以範本為準。

費用

不收費。撰寫、儲存、列出與分享報告都不消耗點數。報告背後的研究，由執行研究的技能計費。

小技巧

  • 要求工作，而不是格式。說「稽核 example.com」，就會自動產生報告。
  • 說明報告是給誰看的。代理會撰寫署名，並依該讀者調整用語。
  • 報告需要修正時，請代理修改。它會更新同一份報告，而不是另外建立第二份。
  • 代理會根據已儲存的摘要修訂報告，因為長篇報告的完整 HTML 可能大到無法讀回。要大幅修改舊報告時，重新執行技能通常比較簡單。

閱讀原始碼

SKILL.md，包含每份報告所依據的 HTML 起始範本：

透過它產生報告的技能