SKILL.md
唯讀
名稱
openseo-review-web-content
描述
為 OpenSEO 網站 (web/) 撰寫與審查內容 — 部落格文章、指南、功能頁面、常見問題。濃縮品牌調性，確保內容符合品牌、實用且準確。每當在 web/content 或 web/src 中新增或編輯面向使用者的文字時使用。
OpenSEO 網站內容
我們發布的所有內容都必須能追溯到產品的實際功能與價格，並且讀起來要像實務工作者寫的。讀者的利益優先：教他們可以實際運用的 SEO 知識，並直接回答問題 — 包括當誠實的答案是「沒有」或「這要花錢」時。
原則
- 可追溯的真實性。 每一項功能宣稱、價格和截圖都必須能對應到程式碼、事實清單 (
src/server/features/onboarding/openseo-fact-sheet.md) 或實際產品。如果你無法指出哪裡是真的，就不該發布。 - 先給真正的答案。 「沒有」、「不是無限」和「這要花錢」都是完整的答案。含糊其辭讓讀者推斷出比事實更美好的情況，就是一種誤導。
- 誠實的定價，並說明理由。 優質的 SEO 數據到處都貴 — 這就是為什麼大型套裝軟體每月要價 100 美元以上。OpenSEO 是經濟實惠的選擇：每月 10 美元，免費開始。絕不能只說「免費」。
- 聽起來像真人。 修正 AI 痕跡的方法是平實地重新陳述背後的說法，而不是修飾華麗的詞藻。deslop 技能 是尋找與修正的參考。
- 讀者優先的高度。 指南要教導可獨立運用的實用 SEO，而不是產品文件或泛泛的填充內容。將免費資源歸功於真正的擁有者（Google 的自動完成、讀者自己的 Search Console）。
- 一致的標準，全面套用。 當標準提升時，要全面套用 — 所有常見問題、所有頁面 — 而不只是被注意到的實例。
- Playbook 術語。 將任何 OpenSEO playbook 中的每個方法稱為「strategy」，絕不要稱為「play」。使用「workflow」來指讀者執行的步驟；「playbook」只用於完整的集合。
審查時要問的問題
- 如果讀者相信每一項宣稱和截圖，然後立刻打開 OpenSEO，現實哪裡會不符合？
- 每個答案是否以真正的答案開頭，還是悄悄導向更美好的推論？
- 大聲讀出最尖銳的句子：真人會這樣說嗎？
- 是否有任何東西被稱為免費，但實際上需要花費點數？
- 這是否教導讀者獨立有用的東西，還是偏離成產品文件或填充內容？
- 頁面上的每個連結、圖片和範例是否都值得佔據讀者的注意力？
要驗證的事實，不要憑記憶
在重複這些內容之前，請先對照程式碼檢查 — 它們會變動：定價與點數 (src/shared/billing.ts、定價頁面)、免費方案限制 (src/shared/audit-limits.ts)、MCP 能力 (src/server/mcp/tools/ — 每個工具一個檔案)，以及任何告訴讀者使用的 UI 操作說明（欄位、排序或篩選必須存在於客戶端程式碼中）。
流程
產生子代理來執行審查（語氣/deslop、宣稱準確性、直接性），並要求它們回傳精確的舊 → 新建議，而不是直接編輯。不要盲目接受它們的建議：套用前，請對照實際檔案驗證每一項，並對照程式碼驗證每一項事實宣稱 — 子代理的改寫可能引入它們自己的彆扭或錯誤，而與檔案不符的建議表示它審查的是過時的文字。套用後，自己全面檢查變更的範圍（模式會聚集 — 一個 em dash 或含糊用語通常有鄰居），然後在受影響的 TS/TSX 上執行 npm --prefix web run types:check 和 prettier。
