# 安裝說明｜美業 AI 技能包

不會寫程式也沒關係。挑一種妳平常在用的 AI，照著做就好。
（以下步驟依 2026-09 的官方說明寫；各家介面偶爾會改位置，找不到時照「關鍵字」在設定裡搜尋。）

---

## 方法 0｜什麼都不裝，先用小工具（最快）

最快：直接用瀏覽器打開 https://hourlight-skills.github.io/beauty-ai-skills/tools/ （手機也可以）。
想存在自己電腦、沒網路也能用：
1. 到本專案的 GitHub 頁面，按綠色「Code」→「Download ZIP」，解壓縮。
2. 打開資料夾裡的 `tools`，雙擊 `index.html`，用瀏覽器開。

都不用登入、不用安裝。最推薦先開「一鍵指令產生器」（`tools/one-click.html`）：選一張卡、填幾格、按一下複製，打開 ChatGPT、Claude 或 Gemini 貼上就好，完全不用懂 AI。
其他小工具：LINE 貼圖打包器、廣告字眼檢查器、打平線計算機、客人資料清理器、服務時薪與折扣底線、排程空檔與清潔緩衝、耗材效期與補貨、預約須知體檢＋放鳥損失、透明價目表＋傳圖報價、儲值金／套票餘額本；
通用小工具（不只美業）：AI 訂閱與花費一頁看、提示詞收藏盒、AI 回答查核清單、逐字稿轉待辦、LINE 常見問答產生器、貼文發出前體檢、一篇變五個平台、30 天發文排程、影片／Podcast 章節時間碼、追蹤連結產生器（UTM）、LINE 官方帳號費用試算、營業稅起徵點對照。

---

## 方法 1｜claude.ai 網頁

官方說明：Free、Pro、Max、Team、Enterprise 方案都能上傳技能。

**先確認兩個開關**
1. 設定裡的「程式碼執行與檔案建立（Code execution and file creation）」要打開，技能才能用。
2. 如果妳是用公司或團隊帳號：管理員可能關掉了「讓成員自己建立技能」。上傳時看到沒有權限，請找妳們的管理員。

**上傳**
1. 下載整包（方法 0 的第 1 步）。
2. 打開 `skills` 資料夾，挑一個技能資料夾（例如 `salon-social-post`），**對那個資料夾按右鍵壓縮成 ZIP**。
   壓好的 ZIP 打開來，第一層要直接看到 `salon-social-post` 資料夾，裡面有 `SKILL.md`。不要多包一層 `skills`。
3. 打開 claude.ai →「Customize」→「Skills」。
4. 按「＋」→「Create skill」→「Upload a skill」，選剛剛的 ZIP。
5. 上傳後，確認這個技能旁邊的開關是**開著**的。

一次上傳一個技能。想全部裝，就每個資料夾各壓一個 ZIP、各傳一次。
只裝一個也能用；技能裡提到的其他技能沒裝時，它會改用內建的簡單檢查。

---

## 方法 2｜Claude Code（要先裝好 Claude Code）

Claude Code 跟 Claude 的聊天 App 是兩個不同的東西。還沒裝的話，先照官方安裝說明裝好：https://code.claude.com/docs/

裝好之後，在 Claude Code 裡依序輸入這兩行：
```
/plugin marketplace add hourlight-skills/beauty-ai-skills
/plugin install beauty-ai-skills@hourlight-skills
```
裝好後技能會以 `/beauty-ai-skills:技能名稱` 出現，也可以不叫它，直接講妳要做的事。

不想用指令的話：把 `skills` 裡的技能資料夾，複製到妳個人資料夾裡的 `.claude\skills\`。
（Windows：打開檔案總管，在網址列輸入 `%USERPROFILE%` 按 Enter，就是妳的個人資料夾；裡面沒有 `.claude\skills` 就自己建立。）

---

## 方法 3｜Codex

把 `skills` 裡的技能資料夾複製到：
- 所有專案都能用：個人資料夾裡的 `.agents\skills\`（Windows 一樣在網址列輸入 `%USERPROFILE%` 找到個人資料夾，沒有就自己建立）
- 只在某個資料夾用：那個資料夾裡的 `.agents\skills\`

複製完，資料夾長這樣才對：
```
.agents
└── skills
    └── salon-social-post
        └── SKILL.md
```
Codex 通常會自己偵測到新技能；沒看到就重開一次。

---

## 裝好了怎麼確認

不要只問 AI「妳有哪些技能」，它有時候會自己編。用這兩個方法確認：
1. **看清單**：
   - claude.ai：Customize → Skills 看得到剛傳的技能、開關是開的
   - Claude Code 用外掛指令裝的：輸入 `/` 會看到 `/beauty-ai-skills:...` 開頭的指令；用複製資料夾裝的：輸入 `/` 會看到技能名稱本身（例如 `/salon-social-post`）
   - Codex：在技能選單看得到技能名稱
2. **試一句，看它有沒有照技能的固定格式回**：挑妳剛裝的那一個試。
   - `salon-social-post`：說「幫我寫一篇 IG 貼文，店名小花美甲，想介紹秋天的新色」。技能有在跑的話，它會先問妳目標客群、要不要 Hashtag 這些問題（最多 5 題），寫完最後會附【發文前檢查】四個勾選框。
   - `salon-breakeven`：說「幫我算打平線，房租兩萬五、水電三千、系統行銷三千、保險雜支兩千、自己薪水 29,500，客單價一千五、耗材兩百、手續費五十」。它會附算式、算出每月 50 位，還會**分開**算房租漲、耗材漲、兩個一起漲三種結果。
   - 其他技能：看那個技能 `SKILL.md` 裡「交出去的格式」那一段，回答有照那個格式就是有在跑。
   只有答案對不夠，要看到技能規定的格式或提問，才算確定技能有被用到。

---

## 常見問題

**Q：要錢嗎？**　技能包和小工具免費。用到的 AI 照各家當下的方案：claude.ai 官方說明免費版也能上傳技能（有額度限制）；Claude Code、Codex 能不能用、要什麼方案，以各家官方頁為準。

**Q：客人的資料會被拿走嗎？**　小工具在妳的瀏覽器裡跑，不上傳。用 AI 技能時，客人姓名、電話、email、生日、病史請先換成客編；各家 AI 怎麼關掉「拿我的資料訓練」，見書第 21 章。

**Q：技能裡的價格、法規過期了怎麼辦？**　技能裡的數字依 2026-09 官方資料寫，重要的地方都附了官方連結。發出去、報稅、上架之前，以官方當下公告為準；發現過期歡迎到 GitHub 開 Issue 告訴我們（附官方網址，不要附客人資料）。

**Q：想看為什麼要這樣做？**　技能最後寫了對應《AI 時代，美業人的逆襲指南》第幾章；紋繡那一支是書外補充，最後列的是衛福部與衛生局的原文連結。