電子報語音 (Newsletter Voice)

Codex 與 Claude 執行環境

在 Codex 或 Claude 中使用此技能時，請務必確實採用當前任務中實際可用的工具。AskUserQuestion 範例僅描述問題類型，而非強制要求的 API：請在所允許的範圍內使用可用的提問工具，或直接在對話中詢問。已提供的答案和來源資料請重複使用。
在使用者選擇的專案中工作。在進行個人化工作之前，請先讀取該專案的 about-me.md、voice.md 以及相關的品牌檔案。如果檔案之間有衝突，或包含預設的初版內容，請先確認預期的作者身分。對於遺漏的事實，請進行詢問，或執行 voice-builder；切勿繼承維護者的身分、帳號或私人檔案。
相對於此技能資料夾解析捆綁的 references/ 資源。若遇到明確要求重新整理設定檔的情況，請直接讀取並更新 about-me.md、voice.md 或 newsletter-voice.md 等正規檔案，同時保留使用者既有的不相關事實與規則。消費者必須重新讀取這些正規檔案。僅在新建的交付物可能與現有不相關檔案衝突時，才使用新的檔名。單純安裝此技能不會啟動訪談或寫入任何檔案。除非使用者在要求中特別提出，否則不要寫入任何持續性學習內容。
優先使用已提供的證據。必要時，可透過可用的搜尋/來源工具驗證外部主張。如果某個來源或整合功能無法使用，請明確指出缺少的能力，並提供可用的文字或匯入輸入。切勿憑空虛構事實、第一人稱經驗、數據指標或成功執行工具的結果。
僅連線所選路徑所需的服務，並透過使用者現有的帳號進行。切勿印出憑證或覆蓋既有的連線設定。起草、儲存和審閱並不授權發布、發送訊息或變更帳號。

必要條件檢查

此技能一經觸發，請立即檢查專案根目錄中是否存在 voice.md 和 about-me.md。

如果缺少其中任何一個檔案，請告訴使用者：

電子報語音是建立在您的一般語音設定檔之上的。請先執行 voice-builder（上傳此技能或說「建立我的語音」），等到專案中有 about-me.md 和 voice.md 後，再回來繼續。

然後停止。在兩個檔案都存在之前，不得繼續執行。

如果兩個檔案都存在，請完整讀取其內容，然後直接進行步驟 1。

步驟 1. 檢查樣本

在對話中詢問使用者：

您有 2 到 3 期過去的電子報樣本可以讓我學習嗎？

是：請在此貼上（每則訊息貼一期，或一次全部貼上）否：請輸入「原型」，我會根據您的語音從模板建構

等待回覆。

如果使用者貼上 2 期或更多的電子報，請前往步驟 2a。如果使用者輸入「原型」，請前往步驟 2b。如果使用者只貼上 1 期電子報，請要求至少再提供一期。如果他們只有一期，則提供選項：「一份樣本不足以偵測模式。您要切換到原型模式，並以這一期電子報作為參考點嗎？」

步驟 2a. 基於樣本的分析

徹底閱讀每一期電子報。尋找貫穿各期之間的模式，而非個別的特殊風格。提取：

開場公式

前三句在做什麼（具體成果、文化觀察、宣稱、場景、提問）
第一個結構性分隔之前的開場段落長度
可信度建立方式（作者如何及早建立權威感）
價值承諾（讀者被告知會獲得什麼）

章節結構

問題或對比設定
命名框架或自由敘述
編號步驟、方法或連續論證
範例與證據的模式
加分或延伸章節
結尾公式與簽名檔

數據思維

每期具體數字（計算數量）
來源歸屬風格（連結、指名、無標註）
範例與抽象概念的比例
限制或失敗的承認方式

格式

標題使用方式（頻率、階層）
列表使用方式（編號、項目符號、箭頭）
粗體和斜體的使用
提示、程式碼區塊或引用區塊的格式
視覺標記（箭頭、勾勾、表情符號，如果有的話）

長度

各樣本的總字數範圍
各章節的字數

電子報特有的語氣標記

專業提示或特別標註（頻率、格式）
展望未來的結尾
結尾簽名句（如果在多個樣本中一致出現）
後設反思（作者是否反思寫作過程或尋求回饋）

缺席訊號

在所有樣本中從未出現的詞彙、結構或句型
作者從未使用的結尾方式
作者從未觸及的主題

然後前往步驟 3。

步驟 2b. 原型選擇

呼叫 AskUserQuestion 工具，提出單一問題：

[
  {
    "question": "哪一種電子報原型最符合您想要寫作的風格？",
    "header": "原型",
    "multiSelect": false,
    "options": [
      {"label": "數據教學", "description": "數字、框架、附帶提示的逐步方法"},
      {"label": "逆向思考文章", "description": "採取立場、捍衛立場、點名反對者"},
      {"label": "案例拆解", "description": "每期一個主題，深入剖析"},
      {"label": "策展摘要", "description": "每週 5 到 7 個連結，附上您的評論"},
      {"label": "個人散文", "description": "以故事為主，圍繞一個主題反思"},
      {"label": "訪談或側寫", "description": "每期一個人，以問答或敘事呈現"}
    ]
  }
]

使用者選好原型後，從此技能資料夾內的 references/archetypes.md 載入對應的預設值。在撰寫 newsletter-voice.md 之前，先使用 voice.md 和 about-me.md 調整每個欄位。在輸出檔案中標註使用了原型預設值，並建議在發布 5 期後重新審視此檔案。

步驟 3. 撰寫 newsletter-voice.md

在專案根目錄中建立 newsletter-voice.md。單一檔案，目標字數 800 至 1,200 字。使用以下結構：

# 電子報語音 (Newsletter Voice)

## 來源
[基於樣本：分析了 X 期電子報] 或 [基於原型：[原型名稱] 根據 voice.md 調整。請在發布 5 期後重新審視。]

## 讀者與目的
[誰在閱讀這份電子報，以及他們會從中獲得什麼。根據 about-me.md 和 voice.md 撰寫。2 到 3 句話。]

## 語音原則
[3 到 5 個寫作時始終遵循的核心原則。每個原則為一個簡短的陳述句。根據使用者的 voice.md 調整。]

## 開場公式
[電子報如何開始。包含 2 個具體的模板，並使用括號佔位符，例如：「[帶有數字的具體成果]。[可信度標記]。[本期價值承諾]。」開場段落目標字數。]

## 章節流程
[電子報的標準結構，從一個章節到另一個章節，最多 5 到 8 個章節。簡短說明每個章節的作用及其長度。]

## 數據與證據
[如何使用數字和範例。具體規則，例如：「每個主張都需要一個數字」、「來源以內嵌連結方式標註」、「範例與抽象概念的比率約為 3:1」]

## 格式化規則
[標題、列表、粗體、斜體、程式碼區塊、視覺標記。哪些該用、哪些該避免。根據樣本或原型預設值整理。]

## 結尾與簽名
[電子報如何結束。展望未來的陳述相對於摘要。如果樣本之間有一致的簽名句（請勿自行發明），則使用該簽名句。]

## 這份電子報從不做的事
[1 個簡短段落或 3 到 5 個項目。根據樣本中缺席模式或原型預設值整理。僅限行為，非禁用詞列表。]

## 長度
[標準電子報的目標字數。如果使用者同時撰寫兩種格式，則分別寫出較長綜合指南的目標字數。]

根據樣本（或根據 voice.md 調整的原型預設值）填寫每個章節。避免填入通用內容。如果樣本中沒有涵蓋某個項目，請直接寫「樣本之間無明顯模式」，切勿猜測。

步驟 4. 確認與交接

告訴使用者：

您的電子報語音已經建立。newsletter-voice.md 位於您的專案根目錄，與 about-me.md 和 voice.md 放在一起。當您要撰寫一期電子報時，請說「寫一份電子報」，我會同時使用這三個檔案。

[如果使用原型模式：請記住此檔案是根據原型預設值建立的。發布大約 5 期之後，請使用您的真實樣本重新執行此技能，以獲得更精確的設定檔。]

此技能產出的內容

一個檔案在專案根目錄中：

newsletter-voice.md：電子報專用的寫作說明，涵蓋讀者、語音原則、開場公式、章節流程、數據思維、格式化、結尾、缺席模式和長度目標

規則

執行前，必須在專案根目錄中存在 voice.md 和 about-me.md。如果缺少任何一個，請停止並引導使用者前往 voice-builder。
如果使用者選擇樣本模式，至少需要 2 期電子報樣本。如果少於 2 期，則提供原型模式選項。
將 newsletter-voice.md 保持在 1,200 字以下。簡潔勝於詳盡。
請勿憑空發明語音訊號。僅根據樣本或根據 voice.md 調整的原型預設值進行工作。
請勿重複 voice.md 的內容。在相關處引用它即可。newsletter-voice.md 僅新增電子報專用的規則。
除非使用者的特定名稱、URL 或結尾簽名句在 2 個或更多樣本中一致出現，否則不要將其納入。
請勿產出獨立的語音或禁用詞檔案。缺席模式應內含於 newsletter-voice.md 中的一個章節。
除非樣本明顯是美式英語，否則全文使用英式英語。
在輸出的任何檔案或任何草稿中，一律不得使用破折號（em dash）。

newsletter-voice