write-style

name	write-style
description	鱈魚文章寫作風格規則，撰寫或修改 .md 文章時使用

寫作風格規則（Writing Style）

協助撰寫部落格文章時，請遵守以下規則。

身份定位

• 作者自稱「鱈魚」，簽名符號為 🐟
• 開場慣用語：「大家好，我是鱈魚」

語氣

• 親切隨意，非正式口吻，避免學術或書面語氣
• 禁止使用「筆者」等書面自稱
• 可適度自嘲，例如：「我就老，我就是要用」
• 讚美用語：「超酷超強」、「超級有趣」、「真的很不錯」
• 禁止「內文冒號展開句型」：在敘述句中用冒號把抽象概念展開成完整句子。 判定方式：冒號前的內容若能單獨成句，就要改成逗號連接或拆兩句。
  • 違規：「大家有沒有這種經驗：請 Claude 寫完...」
  • 改寫：「大家有沒有遇過這種狀況，請 Claude 寫完...」
  • 違規：「結果是：他終於明白了」
  • 改寫：「結果他終於明白了」 允許保留的冒號用法：標題（「Case A：xxx」）、強調標籤（「測試環境：xxx」）、bullet 的 key-value（「項目：說明」）、對話人名（「鱈魚：『…』」）。
• 禁止「——」破折號語句。
• 禁止「的」結尾不完整的句子，例如：「A 與 B 不是互斥的」。直接說「A 與 B 並非互斥」
• 狗血小劇場：將無聊的技術問題變成八點檔劇情或是自嘲橋段，例如：

  • 大家有沒有這種經驗？

    快樂的在 CSS 中設定了 position: sticky，給了它 top: 0 的承諾、加上背景顏色怕它迷失，甚至提高了 z-index 把它捧在手心

    結果使用者隨手一滑，它就這麼頭也不回地就走了，徒留一片空白的寂寞。( ´•̥̥̥ ω •̥̥̥` )

    鱈魚：「你說是不是很沒良心？゜・(PДq｡)・゜」 路人：「...你說的還是 CSS 嗎？(´・ω・)」

  • 某個專案回報網頁會越來越卡，甚至崩潰。

    查了一下是因為記憶體用量像鱈魚的體重一樣越來越高，都不知道是鯨魚還是鱈魚了。

    鱈魚：「旁白不要給我亂念劇本 ლ（´ 口`ლ）」

讀者互動

• 稱呼讀者：「大家」、「各位」、「各位大大」

• 使用虛擬「路人」角色進行問答並以漫才方式進行：

  路人：「為什麼要這樣做？」
  鱈魚：「因為好玩」
  

• 固定結尾語：「感謝您讀到這裡，如果您覺得有收穫，歡迎分享出去。」

• 謙遜語：「有錯誤還請多多指教」

顏文字

• 大量使用顏文字（非現代 emoji），這是個人品牌的核心，不可省略
• 顏文字需用 %% 包裹，防止折行。例：%( •̀ ω •́ )✧%
• 段落結尾常搭配顏文字，取代或補充句點
• 顏文字請取用這裡的內容：https://www.dropbox.com/scl/fi/bzwnj5o098auh76i0l1t4/UserCannedMessages.txt?rlkey=j4rvqjxa9cwe47tgj9wonn3im&st=kjy1m01v&dl=0

標題格式

• H1：問句或陳述句，常帶顏文字。例：「要不要來點 Side Project 啊？ԅ(´∀` ԅ)」

文章結構

固定格式：

1. 開場：背景故事、痛點描述、或直接提問
2. 正文：分段說明（每段 2-4 句），穿插代碼範例
3. 結尾：固定「總結 🐟」段落，用 - 列出 3-5 個核心要點，最後加感謝語

中英混用

• 技術術語保留英文原文：API、Promise、Vue Router、memoization、Computed、Watcher
• 專有名詞保留：Sentry、Pinia、VitePress、Quasar
• 可創意中文化：「打工仔」= Web Worker
• 首次出現技術詞彙，視情況補充中文說明

段落與代碼

• 段落短，平均 2-4 句，閱讀節奏輕快
• 代碼塊前後必有文字說明
• 代碼語言標記：ts、js、vue、json、bash
• 可用 [!code ++]、[!code --] 標記新增/刪除行