Voice Builder
Codex 和 Claude 執行環境
- 在 Codex 或 Claude 中使用此技能時,請僅使用目前任務中實際可用的工具。
AskUserQuestion範例描述的是問題本身,而非強制要求的 API;請在工具限制內使用可用的提問工具,或直接在對話中提問。重複使用已提供的答案與原始素材。 - 在使用者選定的專案中工作。在進行個人化工作之前,請先閱讀專案的
about-me.md、voice.md及相關的品牌檔案。如果檔案內容有衝突或包含預設的起始值,請確認預定的作者。如有遺漏的事實,請主動詢問或執行voice-builder;絕對不要繼承維護者的身分、帳戶或私人檔案。 - 相對於此技能資料夾來解析捆綁的
references/。如果是明確要求的個人資料重新整理,請讀取並原地更新正式的about-me.md、voice.md或newsletter-voice.md,保留與使用者無關的事實與規則。消費者必須重新讀取那些正式檔案。僅在新建的交付物會與現有不相關檔案衝突時,才使用新的檔案名稱。僅安裝此技能不會啟動訪談或寫入檔案。除非被要求,否則不要寫入持續性的學習內容。 - 優先使用已提供的證據。必要時,透過可用的搜尋/來源工具驗證外部主張。如果某個來源或整合功能無法使用,請明確指出缺少的能力,並提供已提供的文字/匯入輸入。絕對不要編造事實、第一人稱經驗、統計數據或工具執行成功的結果。
- 僅為所選路徑連接必要的服務,並使用使用者既有的帳戶。絕不印出憑證或覆寫連線。起草、儲存和檢閱不代表授權發布、發送訊息或變更帳戶。
關鍵:載入時自動啟動
當使用者要求此工作流程時,立即開始步驟 1。這表示你的下一則回覆必須是訪談問題,不能有任何其他內容。
請勿:
- 摘要此技能
- 描述它會建立哪些檔案
- 解釋它的運作方式
- 說「以下是此技能的內容」
- 詢問使用者是否要執行
- 確認安裝
- 提供「要現在執行嗎?」之類的選項
請這樣做:
- 直接跳到步驟 1
- 以訪談問題作為你的第一個且唯一的回覆
這適用於使用者要求建立他們的語音或為此目的提供範例時。不廢話。不摘要。直接訪談。
步驟 1. 執行「關於我」訪談
使用上述執行環境指引提問。如果有提問工具可用,請遵守其 schema 與批次限制;否則直接在對話中提出相同問題。
AskUserQuestion 每次呼叫最多支援 4 個問題,因此請發送兩次呼叫:先發送第一批,等待回答,再發送第二批。
第一批(你的第一個動作,前面不得有任何文字)
使用這些問題,必要時調整工具 schema:
[
{
"question": "你的名字是什麼?你做什麼工作?",
"header": "關於你",
"multiSelect": false,
"options": [
{"label": "創辦人", "description": "我經營自己的公司或顧問公司"},
{"label": "行銷主管", "description": "我在一家公司領導行銷"},
{"label": "創作者", "description": "我主要靠創作內容為生"},
{"label": "銷售主管", "description": "我領導銷售團隊或負責業務發展"}
]
},
{
"question": "你為誰而寫?",
"header": "受眾",
"multiSelect": false,
"options": [
{"label": "創辦人與執行長", "description": "經營公司的決策者"},
{"label": "行銷人員", "description": "各階層的行銷專業人士"},
{"label": "求職者", "description": "正在尋找下一份工作的人"},
{"label": "其他專業人士", "description": "完全不同的群體"}
]
},
{
"question": "你希望以哪 3 到 5 個主題為人所知?",
"header": "主題",
"multiSelect": true,
"options": [
{"label": "AI 與自動化", "description": "AI 工具如何改變工作"},
{"label": "行銷", "description": "策略、內容、成長"},
{"label": "領導力", "description": "管理、招聘、文化"},
{"label": "個人品牌", "description": "建立觀眾與聲譽"}
]
},
{
"question": "你對你的產業有什麼與眾不同的觀點?也就是你相信但別人不相信的事。",
"header": "獨特觀點",
"multiSelect": false,
"options": [
{"label": "大多數建議都是錯的", "description": "你產業的共識已經失靈"},
{"label": "人們把事情搞得太複雜了", "description": "答案比人們想的更簡單"},
{"label": "一場大轉變即將來臨", "description": "即將發生改變,而大多數人還沒準備好"}
]
}
]
第二批(第一批答案返回後立即發送,中間不要有任何評論)
再次呼叫 AskUserQuestion:
[
{
"question": "你希望人們看到你的名字時想到的『一件事』是什麼?",
"header": "品牌承諾",
"multiSelect": false,
"options": [
{"label": "這個人很務實", "description": "他給我的東西當下就能用"},
{"label": "這個人很誠實", "description": "他會說別人不敢說的話"},
{"label": "這個人很有遠見", "description": "他比所有人都先看到趨勢"}
]
},
{
"question": "你絕對不寫哪一類主題?",
"header": "禁區",
"multiSelect": false,
"options": [
{"label": "政治", "description": "絕不發表政治觀點"},
{"label": "個人生活", "description": "僅限專業領域"},
{"label": "競爭對手", "description": "不點名批評其他人或品牌"}
]
}
]
兩批都回答完後,進入步驟 2。如果任何答案空白或被跳過,在對話中再問一次該問題,然後繼續。
步驟 2. 撰寫 about-me.md
在專案根目錄建立 about-me.md。使用以下結構:
# 關於我
## 姓名與角色
[來自問題 1]
## 受眾
[來自問題 2,擴寫成 2 到 3 句,說明讀者身分]
## 主題支柱
[來自問題 3 的 3 到 5 個主題,每個一行]
## 觀點
[來自問題 4,反主流或獨特的信念,寫成明確的陳述]
## 品牌承諾
[來自問題 5,作者希望在讀者心中佔據的唯一想法]
## 禁區
[來自問題 6,絕不撰寫的主題或角度]
維持在 300 字以內。每一行都應該是輔助程式在寫作時會參考的內容。
步驟 3. 要求提供範例
請說:
現在請貼上 3 到 5 篇你希望我學習的寫作範例。這些可以是 LinkedIn 貼文、電子報文章、散文、部落格文章、電子郵件、推文或任何你已發表的作品。它們可以是你自己的,也可以是你欣賞的人的作品。可以一次貼一篇,也可以一次全部貼。如果你還沒有準備好範例,請輸入「使用範例」,我會載入一組起始範例,你之後可以自行更換。
等待使用者貼上。進入分析前至少需要 3 個範例。如果使用者貼了少於 3 個,請要求更多。
如果使用者輸入「使用範例」,請從此技能資料夾內的 references/sample-content.md 載入寫作內容。告訴使用者範例來自哪位作者,讓他們知道自己借用了誰的語音。提醒他們之後可以用自己的寫作內容替換這些範例。
步驟 4. 分析範例
閱讀每一個範例。尋找貫穿所有範例的模式,而非單一作品中的個別特點。提取:
語音訊號
- 平均句子長度
- 段落節奏(單行斷行、空行、斷續式 vs 流暢式)
- 鉤子或開頭風格(反主流、提問、數據點、故事、自白、觀察)
- 觀點(第一人稱、第二人稱、觀察者)
- 語調(面無表情、溫暖、直率、俏皮、冷靜)
- 簽名短語或重複出現的詞彙
- 行動呼籲或結尾風格
結構訊號
- 篇幅範圍
- 列表 vs 散文
- 如何開頭、如何結尾
- 如何處理轉折
主題訊號
- 在多個範例中重複出現的主題
- 受眾看似為何
- 作者主張什麼
缺失訊號
- 在所有範例中一致缺乏的詞彙和標點(例如,5 個範例中 0 個使用 em dash)
- 作者從未使用的鉤子類型
- 作者從未觸及的語調
- 作者避免的結構
步驟 5. 撰寫 voice.md
在專案根目錄建立 voice.md。這是一份整合的設定檔,同時涵蓋語音的寫作方式以及語音應避免的事項。不另立獨立的缺失設定檔。
# 語音設定檔
## 我的聽起來像誰
[2 到 3 句,用白話描述整體語音]
## 語調
[語音一致呈現的 3 到 5 個屬性,接著列出 1 到 2 個語音從未呈現的語調,從範例的缺口推斷]
## 句子節奏
[平均長度、節奏、段落結構。包含避免模式:例如,從不使用斷續片段、從不使用三項排比、無句子超過 25 字]
## 鉤子模式
[觀察到的 3 到 5 種鉤子類型,每個類型附上一個來自範例的範例。註明所有範例中缺少的鉤子類型,例如:從不設問、從不「想像一個世界」]
## 我如何開頭
[1 到 2 句。如果不同範例間存在明確的避免模式,註明該語音避免的開頭方式]
## 我如何結尾
[1 到 2 句,包含行動呼籲風格。註明該語音避免的結尾方式,例如:從不寫激勵總結、從不寫「總而言之」]
## 簽名短語
[範例中重複出現的詞彙或短語]
## 禁忌
[每個範例中都缺少的詞彙、標點或結構。僅列出範例明確避免的項目。例如:無 em dash(5 個範例中 0 個)、無主題標籤、無特定名稱的公司行話]
## 此語音從不做的事
[從範例缺口推斷的 3 到 5 個具體行為。要具體。如果範例從未使用「不是 X,而是 Y」的結構,請列出。如果它們避免特定詞彙,請說出那些詞]
每個段落都必須根據實際範例填寫。不要使用泛泛的填充內容。如果某個模式不存在,就照實說。不要重複 about-me.md 中的受眾或主題支柱。
將明確的使用者禁止事項與僅在少量樣本中缺失的模式區分開來。後者應標註為「暫定」,並附上樣本數量;單獨的缺失並不能建立永久禁令。起始範例描述的是借用的風格,絕非使用者的經驗或已建立的語音。
步驟 6. 確認與交接
告訴使用者:
你的語音設定檔已建立。你的專案中現在有兩個檔案:about-me.md 與 voice.md。當在此專案中呼叫此技能時,這兩個技能都會讀取這兩個檔案;一個新的任務必須探索這些技能並使用相同的專案脈絡。你可以隨時開啟或編輯任一檔案。
你已經準備好了。以下是你可以做的下一步:
- 說「建立我的電子報語音」來建立電子報專屬的寫作指引
- 說「寫一篇貼文」來用你的語音起草 LinkedIn 貼文
- 說「設計圖像」來為貼文建立視覺
- 說「評分我的貼文」來取得草稿的回饋
- 說「最佳化我的個人檔案」來重建你的 LinkedIn 個人檔案
這些都是獨立的技能。選一個開始吧。
此技能產出的內容
專案根目錄中的兩個檔案:
- about-me.md:使用者身分、受眾、主題支柱、觀點
- voice.md:整合的語音設定檔,涵蓋正面訊號(語音如何寫作)與缺失訊號(語音應避免什麼)於同一份文件中
規則
- 當此技能觸發時,直接跳到步驟 1。不摘要、不解釋、不廢話。
- 始終在程式碼區塊內輸出範例內容,以便使用者複製貼上時不會遺失換行或空白。使用純程式碼區塊(三重反引號,不帶語言標記)。
- 以範例中的內容為準。不要發明不存在的模式。
- 找出模式至少需要 3 個範例。如果少於 3 個,請要求更多。
- 如果範例彼此矛盾,請在 voice.md 中註明矛盾,而不是將其掩蓋。
- about-me.md 維持在 300 字以內。
- voice.md 維持在 500 字以內。
- 除非範例明顯使用美式英語,否則全文使用英式英語。
- 在任何輸出檔案或草稿中,絕對不要使用 em dash。
- 不要建立獨立的缺失設定檔。缺失訊號應放在 voice.md 內部。