Communitygithub.com

yumaitau/skills

為客戶導向的網站文案提供定位、結構、佐證與 SEO 優化。適合在撰寫、改寫、擴充或評析作品集、行銷、登陸頁、代理商、顧問或服務型企業網站的文案時使用,涵蓋英雄區塊、關於我們、服務頁面、專案摘要、案例研究、行動呼籲、標題、標語、SEO 標題、中繼描述與 URL 短網址。即使是縮短標題或審閱單一專案簡介等小工作,也可觸發此技能。若有 `.product/` 知識檔案(來自 dot-product 技能),則會讀取;並與 human-copy-style 技能搭配,作為基準語調。不適用於行銷電子郵件、電子報、公告、社群貼文或廣告文案(由 campaign-copywriter 負責),也不適用於無頁面層級 SEO 需求的部落格文章或 UI 微文案(僅由 human-copy-style 處理)。

skills 是什麼?

此技能專為網站文案的定位、結構、佐證與 SEO 優化而設計,適用於作品集、行銷、登陸頁、代理商、顧問或服務型企業網站。支援改寫、擴充或從頭起草文案,並可處理英雄區塊、關於我們、服務頁面、專案摘要、案例研究、行動呼籲、標題、標語、SEO 標題、中繼描述與 URL 短網址。技能會自動讀取 `.product/` 目錄下的知識檔案(來自 dot-product 技能)以取得基於程式碼的佐證材料,並與 human-copy-style 技能搭配管理語調。其核心工作流程包含:建立工作模式、收集素材(優先使用真實來源)、識別頁面目標與搜尋意圖、建立層級式文案草稿、執行改寫檢查,以及產出 SEO 元件(如標題、中繼描述與 H1 標題)。此技能也嚴格禁止編造客戶、專案、案例研究、數據或推薦信,若缺乏佐證則傾向簡化文案。搭配平台包含 Claude Code、Cursor、Codex 等支援 skills 的 AI 代理工具。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yumaitau/skills/tree/HEAD/portfolio-copywriter

在你喜歡的 AI 中提問

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

說明文件

作品集文案撰寫師

像一位熟悉工作、尊重讀者時間的經驗者來寫作。建立信任、清楚說明價值,讓作品本身來銷售。預設採用克制的行銷文案:有能力、夠溫暖,絕不浮誇。

此技能負責定位、結構、佐證、SEO 與頁面層級的模式。基準語調與避免 AI 痕跡則屬於 human-copy-style 技能。若未安裝該技能,請自行把握其核心原則:使用樸實動詞而非流行術語,避免 em dash 與 emoji,不使用泛泛的誇大宣傳,變化句子節奏。全文使用澳洲英語;拼寫細節請遵循 australian-english 技能。

素材來源

真實素材勝於虛構,因此在起草前請先收集:

  1. 若倉庫根目錄存在 .product/(dot-product 技能的產出),請先閱讀 OVERVIEW.md、FEATURES.md、DIFFERENTIATORS.md 與 USE_CASES.md。這些是預先挖掘、基於程式碼的佐證材料,正是此技能所需。product-profile.json 則包含結構化的事實。若文案工作範圍較大且 .product/ 缺失,建議先執行 dot-product 技能。
  2. 閱讀現有頁面與網站周圍的文案。語調一致性很重要,且頁面上已有的主張你不能與之矛盾。
  3. 對於兩者都未提供的關鍵資訊,請向使用者提問。

當你計劃提出的每一項主張都能追溯到來源或你已提出的問題時,即代表收集完成。

絕不虛構

文案寫作是幻覺造成最大損害的地方,因為使用者通常無法從草稿中判斷何為真實。規則:

  • 絕不虛構客戶、專案、案例研究、服務產業、獎項、推薦信、員工人數、成立年數、地點或合作夥伴。
  • 絕不虛構數據。若不確定數字,"更快的結帳" 優於 "43% 更快的結帳"。
  • 絕不將引言歸屬於任何人。
  • 若某個有力的句子依賴於你沒有的資訊,請詢問使用者,或撰寫一個較弱但屬實的句子。
  • 若素材薄弱,請簡化文案。切勿誇大。

當你不確定某個細節是否真實時,請以內聯方式標記,如 [確認: 15+ 年?],以便使用者在發布前驗證。

三種工作模式

在起草前,明確當前處於何種模式。

  • 改寫:保留相同資訊,使其更精煉。不改變頁面主張的內容,只改變其表達方式。
  • 擴充:頁面內容過於單薄。加入真實細節,而非填充。若無法增加資訊量,則不要擴充。
  • 從頭起草:無現有文案。在起草前訪談使用者。最低需求:網站服務對象與訪客應採取的一項行動;提供的服務或產品,以及他們希望增加哪些;可驗證的事實(產業、地點、成立年數、團隊規模、成果、可公開提及的客戶);他們與下一個搜尋結果有何不同;地理範圍與任何已知的關鍵字目標。切勿偽造品牌尚未建立的語調。

工作方法

  1. 建立模式:改寫、擴充或從頭起草。
  2. 如上所述收集素材。
  3. 識別頁面的任務(吸引、說明、佐證或轉換)及其搜尋意圖與關鍵字主題。
  4. 以清晰的層級起草:標題、支援行、佐證、行動呼籲。
  5. 執行以下改寫檢查。
  6. 產出以下 SEO 輸出。當 SEO 標題、中繼描述與 H1 都反映最終文案(而非草稿)時,即完成。

有意義的擴充

擴充時,加入:

  • 更清晰的定位
  • 更有力的佐證點
  • 對服務、目標受眾或使用案例更好的說明
  • 具體的交付背景:產業、平台、環境、限制
  • 標題、正文與行動呼籲之間更明確的過渡

以更長的篇幅重複相同觀點是一種失敗模式,而非風格。若新句子未增加資訊,請刪除。

SEO 護欄

  • 以人類為優先,但保持主要關鍵字主題可見。
  • 除非使用者要求重新定位,否則保留頁面的主題與意圖。
  • 在自然的情況下,將主要關鍵字或相近變體放入 H1、頁面標題與正文開頭。
  • 在副標題與正文中使用支援性變體,但不要強迫完全比對重複。
  • 保持中繼資料針對特定頁面,而非整體品牌。
  • 絕不以可讀性換取關鍵字密度。

SEO 輸出

改寫或擴充頁面時,預設提供:

  • 修訂後的頁面文案
  • SEO 標題(目標 55 到 60 個字元)
  • 中繼描述(目標 150 到 160 個字元)
  • 建議的 H1(若頁面需要)
  • 建議的支援性標題(若結構較弱)

若相關,也可建議:

  • 內部連結機會
  • 更簡潔的 URL 短網址
  • 能強化主題深度的遺漏佐證點或常見問題

頁面模式

英雄區塊

  • 一條清晰的定位行。
  • 一條包含範圍、受眾或差異化因素的支援句。
  • 一個明確的行動呼籲。
  • 主要主題明顯,但不顯得生硬塞入。

改寫範例:

改寫前:

歡迎來到 Rivercroft Digital,您值得信賴的合作夥伴,提供在當今快速變化的數位環境中驅動真實成果的尖端客製化解決方案。

改寫後:

Rivercroft 為維多利亞州的市政委員會與公用事業機構建立網站與內部工具。 小團隊,長期合作,程式碼比我們更持久。 [開始專案]

"改寫後"告訴您他們服務對象、建構內容以及工作方式。"改寫前"則可以屬於任何國家的任何代理商。

關於我們

  • 說明公司是誰。
  • 加入可信的背景或觀點。
  • 說明公司存在的原因,但不要顯得太自以為是。

服務

  • 從成果或解決的問題開始。
  • 說明交付的工作類型。
  • 加入佐證:產業、系統、環境、平台、限制。
  • 僅在能增加可信度時使用術語。

改寫範例:

改寫前:

我們提供穩健、端到端的網頁開發解決方案,量身打造以滿足您的業務需求。

改寫後:

我們為受監管產業建立公開網站:水務管理局、市政委員會、健康網路。無障礙、長期維護與內容治理是預設範圍的一部分,而非附加選項。

專案與作品集

  • 用白話文說明專案內容。
  • 提及服務對象或其重要性。
  • 只有在真實的情況下才強調規模、複雜性或獨特性。
  • 避免將每個專案都寫得像新聞稿。
  • 加入可搜尋的背景資訊:產業、平台、交付環境、系統類型。

範例簡介:

為一個服務 14 萬名病患、涵蓋六個院區的區域醫院網路重建了預約系統。將其從舊有的 PHP 單體架構遷移到型別化的 Node.js 技術棧,保留了現有的約診資料,並在一次夜間窗口期內完成轉換。

讀者從中了解專案內容、服務對象以及困難之處,完全不需要形容詞。

行動呼籲與聯絡

  • 保持請求簡單明瞭。
  • 避免虛假的急迫感。
  • 讓行動呼籲符合買家意圖。

範例:

較弱:"立即將您的業務推向新高度!"

較強:"開始專案"、"預約 20 分鐘通話"、"查看定價"、"聯絡我們洽談新南威爾斯州業務"。

較強的版本確切告訴讀者點擊後會發生什麼事。

改寫檢查

語調層級的編輯(填充詞、流行術語、節奏)屬於 human-copy-style 的改寫檢查。此處的檢查關乎佐證與搜尋:

  • 用素材中的事實取代模糊的形容詞。
  • 縮短標題直到感覺精煉。
  • 檢查關鍵字主題是否在編輯過程中存活下來。若沒有,則自然地將其恢復。
  • 確保 SEO 標題與中繼描述反映頁面最有力的版本。
  • 將文案大聲朗讀一遍。如果聽起來仍像行銷文案,再次簡化它。

有用的動詞傾向

動詞列表是起點,而非規則。請根據產業調整。

  • 軟體與技術工作:建立、推出、執行、支援、現代化、連接、部署、維護、設計、交付。
  • 設計、內容與顧問:設計、研究、建議、記錄、促進、撰寫、結構化、規劃、審閱。
  • 貿易與服務業務:安裝、裝配、維修、修理、供應、報價、排程。

偏好使用此類片語:"在實地使用"、"跨平台運作"、"位於"、"支援"。

若品牌具有使命或身分背景

以樸實與尊重的方式處理。不要將身分、社群或宗旨變成裝飾性文案。陳述事實,說明其重要性,然後繼續。

在倉庫中定位文案

在編輯前,找到文案實際所在位置。行銷與作品集文案通常位於:

  • Next.js / React:src/app/**/page.tsx、app/**/page.tsx、src/content/*、content/*
  • Astro / MDX:src/content/*.md(x)、src/pages/*.astro
  • 純 React / Vite:src/pages/*、src/components/*
  • Eleventy / Hugo / Jekyll:content/、src/site/、_posts/

若找不到原始檔,請從動態頁面中 grep 一個獨特的片語。對於 SEO 中繼資料,也請檢查頁面層級的 metadata 匯出、Head 元件或 frontmatter,以確保標題與描述與改寫後的正文保持一致。

若使用者在先前的對話或倉庫筆記中設置了特定路徑,請優先採用這些路徑,而非上述預設路徑。

何時「不要」使用

  • 行銷電子郵件、電子報、公告、社群貼文與廣告文案:這些由 campaign-copywriter 負責結構與行動呼籲,並由 human-copy-style 負責語調。
  • 無頁面層級 SEO 需求的部落格文章與 UI 微文案:僅由 human-copy-style 處理。
  • 行銷活動規劃、受眾選擇或渠道規劃:這是 marketing-strategist 的範疇。
  • 從程式碼庫提取產品知識:這是 dot-product 的範疇。先執行它,然後再回到此處處理文案。
  • 為開發者撰寫的文件(README、API 文件、變更日誌):不屬於行銷文案。

相關技能