Promo Writer — Claude Code Plugin Marketplace

把長篇內容（課程大綱、講稿、逐字稿、筆記）萃取乾貨，轉換成帶有作者個人語氣與風格的宣傳文，預設輸出 Facebook 貼文格式。

這個 repo 是一個 Claude Code plugin marketplace，目前包含一個 plugin：

Plugin	說明
promo-writer	長文 → 萃取乾貨 + 選定切角 → 套用個人語氣風格 → 輸出 promo.md

目錄

• 安裝
• 使用
• 專案結構
• 開發
• 這個 plugin 是怎麼做出來的
  • 第一步：寫 skill 素材
  • 第二步：在自己電腦上驗證
  • 第三步：請 AI 轉換成 plugin marketplace

安裝

在 Claude Code 中執行：

/plugin marketplace add dean9703111/promo-writer
/plugin install promo-writer@promo-writer-marketplace

使用

安裝後可以直接下指令觸發，例如：

• 「把這份課程大綱轉成 FB 宣傳貼文」
• 「用我的語氣幫這場直播寫一篇暖場文」

也可以手動呼叫：

/promo-writer:promo-writer

Skill 會依照 references/voice-and-style.md 的語氣風格規則撰寫，對標 references/examples.md 的黃金範例，主打分享價值、不做硬性銷售。成品輸出到來源內容同目錄的 promo.md。

專案結構

.
├── .claude-plugin/
│   └── marketplace.json          # marketplace 目錄檔
└── plugins/
    └── promo-writer/
        ├── .claude-plugin/
        │   └── plugin.json       # plugin manifest（版本管理在這裡）
        └── skills/
            └── promo-writer/
                ├── SKILL.md      # skill 主體：工作流程與品質檢查清單
                └── references/
                    ├── voice-and-style.md   # 語氣與風格指南
                    └── examples.md          # 黃金範例、hook 庫、CTA 庫、金句庫

開發

本機測試（不需安裝）：

claude --plugin-dir ./plugins/promo-writer

修改後在 session 內執行 /reload-plugins 即可重新載入。發佈更新時記得 bump plugins/promo-writer/.claude-plugin/plugin.json 的 version，使用者才會收到更新。

驗證格式：

claude plugin validate ./plugins/promo-writer   # 驗證 plugin
claude plugin validate .                        # 驗證 marketplace

這個 plugin 是怎麼做出來的

核心方案一句話：先把 skill 寫好、在自己電腦上驗證到產出穩定，最後才請 AI 一句話轉換成 plugin marketplace。 打包是整個流程中最便宜的一步，不用自己研究格式。

第一步：寫 skill 素材

• voice-and-style.md —— 拿自己定稿過的貼文逆向拆解，把語氣寫成可執行的規則（人設調性、結構、開場公式、emoji 規範、結尾公式……共 10 節）。規則要具體到可以檢查：「emoji 只用 1️⃣2️⃣3️⃣、👇、👉」比「emoji 克制」有用得多。
• examples.md —— 黃金完整範例 + 開場 hook 庫 + 結尾 CTA 庫 + 金句庫。模型對標範例比對標規則更準。
• SKILL.md —— 只放工作流程和品質檢查清單，風格細節放 references/ 按需載入。

第二步：在自己電腦上驗證

skill 先以最簡單的形式放在專案裡（一個 SKILL.md + references/，連 plugin 都不是），直接在 Claude Code 裡拿真實的課程大綱、講稿跑：

1. 餵一份長文，看產出像不像自己寫的
2. 不像的地方，回頭修 voice-and-style.md 的規則或補 examples.md 的範例
3. 重複到產出穩定、不用每次手動調整為止

這一步最花時間，但也是價值所在——沒驗證過的 skill 不值得打包。

第三步：請 AI 轉換成 plugin marketplace

驗證通過後，轉換交給 Claude Code，實際使用的 prompt 就這三句：

「我想要把專案的 skill 轉換成 Claude plugin marketplace」

AI 自己查了最新官方文件確認格式，把 SKILL.md 和 references/ 搬進 plugins/promo-writer/skills/promo-writer/，產生 plugin.json 與 marketplace.json，跑 claude plugin validate 驗證通過。

「README 跟 .gitignore 設計會讓專案更明確且易懂？」

補上這份 README 和 .gitignore（排除本機個人設定 .claude/settings.local.json）。

「我想要在最後告訴大家製作這個 plugin 的方案」

就是你現在讀的這個章節。

整個轉換過程零手寫設定檔——格式規範交給 AI 查最新文件處理，人的時間留在第一、二步：規則與範例的品質，直接決定產出像不像你本人。