a2ngerer/claude_onboarding_agent

內容語調設定

此技能可設定 Claude 在您選擇的平台上，以您的品牌語調進行寫作。它會生成一個簡短的 CLAUDE.md 指標，以及每個選定平台專屬的 .claude/rules/content-voice-<platform>.md 檔案。此技能不會設定發佈工具、分析工具、媒體流程或排程功能——這些明確不在其範圍內。

交接上下文： 請閱讀 skills/_shared/consume-handoff.md，並使用交接區塊（如果有的話）執行它。該輔助程式保證提供下列本地變數：detected_language、existing_claude_md、inferred_use_case、repo_signals、graphify_candidate。所有面向使用者的文字請使用 detected_language；生成的檔案內容則保持為英文。

現有的 CLAUDE.md： 如果 existing_claude_md: true，請不要覆寫它。請在檔案結尾處附加一個新的分隔區塊：

<!-- 入職代理：開始 setup=content-voice skill=content-voice-setup section=claude-md -->
## Claude 入職代理 — 內容語調設定
...生成的內容...
<!-- 入職代理：結束 -->

如果該分隔區塊已存在於先前的執行中，請僅替換標記之間的內容；其餘部分保持不變。將生成的 .gitignore 條目包裹在 # 入職代理：content-voice — 開始 / — 結束 標記中，以便 /upgrade-setup 能以非破壞性方式重新整理它們。

輔助檔案

請在需要時才於相應步驟中讀取這些檔案。請勿預先讀取。

• skills/_shared/consume-handoff.md — 協調器交接解析 + 內嵌備用方案（前導說明，在步驟 1 之前）
• skills/_shared/offer-superpowers.md — 標準 Superpowers 選擇加入（步驟 1）

步驟 1：安裝相依套件

請閱讀 skills/_shared/offer-superpowers.md 並以 skill_slug: content-voice-setup、mandatory: false、capability_line: "一個廣泛使用的免費 Claude Code 技能庫。腦力激盪技能在您為某篇內容確定語調前，對於探索不同切入點很有幫助。" 參數執行它。該輔助程式會詢問使用者，若回答「是」則委託給 skills/_shared/installation-protocol.md，並設定 superpowers_installed、superpowers_scope、superpowers_method 等變數。

步驟 2：情境問題

請逐一詢問：

1. 「您為哪些平台創作以語調為導向的內容？（多選——以逗號分隔字母，至少選一個） A) YouTube（長片/腳本） B) 短影音（Instagram Reels / TikTok / Shorts） C) 電子報/部落格（長文書寫） D) Podcast（對話式音訊）」

   將答案解析為字母列表。至少需要選擇一個——若輸入為空，請重新詢問一次。儲存為 selected_platforms。對應到代號：

   • A → youtube
   • B → shortform
   • C → newsletter
   • D → podcast

2. 「您會如何描述您的品牌語調？請儘可能具體——細節越多，Claude 就越能符合您的風格。 範例：「教育性但隨興，就像對一位聰明的朋友解釋事情」、「金融科技領域的專業意見領袖」、「幽默且不敬的科技評論」、「溫暖且個人化的健康內容」」

   將答案原封不動儲存為 brand_voice。各平台的規則檔案會將其注入至檔案標題。

3. 「您的目標受眾是誰？（例如：「25–40 歲、對 AI 工具有興趣的開發者」、「沒有技術背景的小企業主」、「尋找快速鍛鍊方式的健身愛好者」）」

   儲存為 target_audience。

步驟 3：輸出各平台語調規則

對於 selected_platforms 中的每個代號，在 .claude/rules/content-voice-<slug>.md 撰寫一個規則檔案。如果檔案已存在，則跳過寫入並記錄 已跳過 .claude/rules/content-voice-<slug>.md（已存在）——不要覆寫使用者的編輯。

每個規則檔案應獨立完整（≤ 40 行），並將 brand_voice 和 target_audience 替換至檔案標題。使用下列模板，將 [brand_voice] 和 [target_audience] 替換為取得的答案。

content-voice-youtube.md

# Content Voice — YouTube（長片）

語調設定檔：[品牌語調]
目標受眾：[目標受眾]

## 格式規則
- 每個腳本開頭 30 秒內必須有鉤子：向觀眾承諾一個具體的觀看回報。
- 結構：鉤子 → 鋪陳（問題/挑戰） → 回報（答案、故事或展示） → 行動呼籲。
- 行動呼籲只能指定一個動作。不要列出「按讚、訂閱、留言、加入」等一長串。
- 句子要朗朗上口，預設每句口語台詞不超過 20 個字。

## 語氣規則
- 每一版草稿都必須符合上述語調設定檔。如果某個草稿讀起來像普通的 AI 評論，請重寫開頭，直到它聽起來像[品牌語調]。
- 直接對目標受眾說話。依賴他們既有的知識水準；不要解釋他們已經知道的事。

## 禁止事項
- 不要撰寫標題釣魚但內文無法兌現的內容——鉤子必須是對回報內容的真實鋪陳。

content-voice-shortform.md

# Content Voice — 短影音（Reels / TikTok / Shorts）

語調設定檔：[品牌語調]
目標受眾：[目標受眾]

## 格式規則
- 第一行就是鉤子。在前兩秒內就要抓住觀眾視線。
- 每則貼文只傳達一個想法。如果第二個想法很重要，請另外發布一則貼文。
- 以一個問題、行動呼籲或具體的收穫作為結尾——永遠不要虎頭蛇尾。
- 控制總字數（30 秒短片大約 30–60 個口語單詞）。

## 語氣規則
- 語調設定檔必須完全符合[品牌語調]——短影音會放大語調，因此平淡的語氣是預設的失敗模式。
- 瞄準[目標受眾]；不要為了迎合更廣泛的受眾而軟化語氣。

## 禁止事項
- 不要將鉤子埋在第一行之後。不要以「那麼，今天我想談談……」這種暖場開頭。

content-voice-newsletter.md

# Content Voice — 電子報/部落格（長文書寫）

語調設定檔：[品牌語調]
目標受眾：[目標受眾]

## 格式規則
- 主旨行要具體而非賣弄聰明——直接指出讀者能獲得的收穫或解答的問題。
- 開頭要個人化或以故事為基礎（1–3 句）；然後是一個核心概念；再來是清楚的收穫；最後是一個簡單的行動呼籲。
- 允許使用分段，但非必要——寧可寫一個緊湊的論點，也不要寫列表式文章。
- 結尾要有一句讀者可以轉發給同事的話。

## 語氣規則
- 語調設定檔必須在整篇文章中保持一致——沒有任何段落應該像出自不同作者之手。
- 根據[目標受眾]的實際情況來稱呼他們，而不是用角色標籤。

## 禁止事項
- 不要發送沒有具體收穫（讀者可以採取行動或記住）的刊物。

content-voice-podcast.md

# Content Voice — Podcast（對話式音訊）

語調設定檔：[品牌語調]
目標受眾：[目標受眾]

## 格式規則
- 開場直接以鉤子開始——一個場景、一個問題或該集的一個具體時刻。片頭音樂放在鉤子之後。
- 轉場要用口語，而不是跳接：說出轉折點（「我們先擱置一下——首先……」）。
- 事先準備問題，但要為追問留出空間；照稿唸的腳本聽起來就是照稿唸。
- 結尾先放來賓的行動呼籲（如果有的話），然後放主持人的行動呼籲。

## 語氣規則
- 語調設定檔[品牌語調]適用於主持人的台詞；配合來賓的節奏，而非強迫他們配合你的節奏。
- 行話程度要符合[目標受眾]的水準；首次使用時請解釋。

## 禁止事項
- 不要說教——保持對話感。如果某個段落讀起來像獨白，就刪掉它或改寫成問題的形式。

收集實際寫入的檔案列表（減去因檔案已存在而跳過的），作為 emitted_voice_files，供完成摘要使用。

步驟 4：生成產出物

CLAUDE.md

# Claude 指示 — 內容語調

## 品牌
平台：[selected_platforms 的逗號分隔列表]
品牌語調：[brand_voice]
目標受眾：[target_audience]

## 範圍
此設定僅涵蓋語調——不包括發佈、分析或媒體流程。如需更長的內容工作流程，請在此基礎上疊加其他技能或工具。

## 語調規則（各平台）
[對於 selected_platforms 中的每個代號，輸出一條指向規則檔案的項目符號：]
- YouTube：`.claude/rules/content-voice-youtube.md`
- 短影音：`.claude/rules/content-voice-shortform.md`
- 電子報/部落格：`.claude/rules/content-voice-newsletter.md`
- Podcast：`.claude/rules/content-voice-podcast.md`

## 指導原則
- 始終使用上述定義的品牌語調寫作——永遠不要聽起來像普通的 AI。
- 起草前，請查閱目標平台對應的 `.claude/rules/content-voice-<platform>.md` 檔案。
- 當被要求進行跨平台改寫時，請分別套用各平台的規則檔案——不要在格式之間複製貼上。

[僅當 superpowers_installed 為 true 時包含以下內容]
## Superpowers
Superpowers 已安裝。對於腦力激盪會議和規劃內容系列，請使用 `superpowers:brainstorming` 在確定方向前探索各種切入點。

.gitignore

# 大型媒體檔案
*.mp4
*.mov
*.avi
*.psd
*.ai
*.sketch
*.fig

# 作業系統
.DS_Store
Thumbs.db

# Claude 本地設定
.claude/settings.local.json

步驟 5：寫入升級中繼資料

設定 setup_slug: content-voice、skill_slug: content-voice-setup。從外掛程式本身的 plugin.json 中解析 plugin_version。然後按照 skills/_shared/write-meta.md 的指示，建立或合併 ./.claude/onboarding-meta.json。

步驟 6：渲染錨點區段

閱讀 skills/_shared/anchor-mapping.md。找到 setup_type: content-voice 對應的資料列。對於該列中的每個錨點代號：

1. 使用下列參數呼叫 skills/_shared/render-anchor-section.md：
   • setup_type: content-voice
   • skill_slug: content-voice-setup
   • anchor_slug: <slug>
   • target_file: ./CLAUDE.md
   • fallback_content: <來自 skills/anchors/SKILL.md 中該 slug 的內嵌備用內容>
2. 如果此技能先前已生成 ./AGENTS.md 檔案，則以 target_file: ./AGENTS.md 重複呼叫。

如果任何單次 render-anchor-section.md 呼叫回傳 placeholder，請不要失敗。請收集已渲染/佔位符的代號，用於完成摘要。

對於每次呼叫，同時記錄 render_freshness。當其值不是 network 或 cache（即為 fallback 或 embedded）時，將 (anchor_slug, render_freshness) 記錄在 anchor_freshness_notes 中。完成摘要的「錨點新鮮度」行會使用此列表。

步驟 7：完成摘要

✓ 內容語調設定完成！

範圍：品牌語調 + 各平台語氣規則。發佈、分析和媒體流程**不**包含在內——此技能刻意保持範圍狹窄。

已建立的檔案：
  CLAUDE.md                                    — 品牌、範圍、語調規則的指標
  .claude/rules/content-voice-<slug>.md        — 每個選定平台一個檔案 [列出 emitted_voice_files；將跳過的標記為「（已存在——保持不變）」]
  .gitignore                                   — 大型媒體檔案規則
  .claude/onboarding-meta.json                 — 供 /upgrade-setup 使用的設定標記

外部技能：
  [✓ Superpowers 已透過 superpowers_method（superpowers_scope）安裝]
  [已跳過——稍後可使用 /plugin install superpowers@claude-plugins-official 安裝]
  [⚠ Superpowers 安裝失敗——請手動安裝：https://github.com/obra/superpowers]

錨點新鮮度：
  [如果 anchor_freshness_notes 為空，則省略整個區塊；否則每個條目一行：
   錨點 <anchor_slug> 來自 <render_freshness> — 建議執行 /anchors 以重新整理。]

下一步：
  啟動一個新的 Claude 工作階段，然後說：「以我的品牌語調，起草一份關於 [主題] 的 [YouTube 腳本 | 短影音鉤子 | 電子報 | Podcast 開場]」
  或者：「將這篇部落格文章改編為 Instagram Reels，遵循我的短影音語調規則」
  - 隨時執行 `/anchors` 以重新整理錨點區段。如果任何區段因為離線模式而被渲染為佔位符，請在連線後重新執行 `/anchors`。