Claude Skills 入門：將重複工作寫成可重用程序

規則成日重貼，可以整成 Skill

你每次改客戶 Email，都會講同一批要求：簡潔、專業但唔生硬、唔好作交期，再附幾封寫得好嘅例子。Skill 就係將呢套程序同參考整理成一個資料夾，需要嗰陣先用。

Project 主要放背景；Skill 主要講點完成一類任務。兩者可以配合，但 Skill 本身唔會自動取得 Email、網站或檔案權限，亦唔會單靠一個名稱就替你排程。

1. 先揀一件細而穩定嘅工作

用「修改香港客戶英文 Email」做例子。唔好第一個 Skill 就包寫文案、報價、出單同發送，咁樣難以知道邊一步出錯。

email-polish-hk/
  SKILL.md
  reference/
    good-examples.md
    tone-rules.md

最簡單只需要 SKILL.md。冇真實需要就唔加程式或依賴套件。

2. 寫清楚適用範圍

以下內容可以直接存做 SKILL.md：

---
name: email-polish-hk
description: 用戶貼上英文客戶 Email 並要求修改語氣、清晰度或長度時使用；不適用於社交貼文。
---

# 香港客戶 Email 編輯

## 做法
1. 讀草稿，確認目的、收件人關係同已有事實。
2. 指出最多三個問題：含糊、過度客套或欠缺下一步。
3. 出兩個版本：簡潔直接，以及較溫和。
4. 保留原意，唔好加入未提供嘅交期、退款承諾、原因或附件。
5. 建議一個版本，講一句原因；只交草稿，唔發送。

## 語氣
- 用完整、自然嘅英文，唔好為咗口語化刪到句子唔清楚。
- 對新客保留合適稱呼，對熟客可以親切啲。
- 資料未確認就用 [待確認]，唔好抄參考例子嘅事實。

## 參考
見 reference/good-examples.md 同 reference/tone-rules.md。

description 講用途同比較適合嘅情境，唔係堆一串關鍵字。佢會影響 Claude 判斷幾時使用，仍然要靠測試驗證。

3. 放入有解釋嘅例子

good-examples.md 可以咁寫：

# 示範：通知延遲

原句：Please be advised that your order has been delayed.
修改：Sorry, your order has been delayed. We’re checking the revised delivery date and will update you by [confirmed date].

點解咁改：先講清現況，再交代下一步。日期必須由用戶確認，唔好由 Skill 自己決定。

例子用虛構資料或者刪走客戶識別資料。唔好將真實客戶 Email、電話同地址包喺可分享嘅 Skill 入面。

4. 安裝同啟用

目前 Claude 嘅 Skills 入口係 Customize → Skills，使用前要啟用程式執行及檔案建立功能；組織帳戶亦可能受管理員設定限制。自訂 Skill 嘅上載格式同可用功能見 官方使用指南。

Claude Code 亦支援本地 Skills。只喺自己帳戶使用可以放 ~/.claude/skills/；專案共用則放專案嘅 .claude/skills/。API 同 Agent SDK 有自己嘅載入方式，唔好將網頁上載步驟當成 API 用法；開發時由 Anthropic 文件入口 查當前規格。

5. 測三種情況

請用 email-polish-hk 修改呢段客戶 Email：

Dear Mr Chan, your delivery has been delayed. We are checking with the supplier. I do not yet have a confirmed delivery date.

只改語氣同清晰度，唔好補作原因或日期。

再試一封缺收件人背景嘅草稿，睇佢會唔會問；最後要求寫 IG 貼文，睇佢有冇錯用呢個 Skill。冇自動用到時，先確認已啟用，再明確叫名試一次。

用熟之後再擴充

週報 Skill 可以分「進度、阻礙、決定、下一步」，每個數字要有原始紀錄；資料不足就留白，唔好要求每節硬塞一個數字。亦唔應禁止「未確認」等字眼，否則會逼出假肯定。

分享畀同事前，讀一次全部文件同程式，檢查有冇私人資料、金鑰或不必要嘅外連。團隊共用方式以帳戶提供嘅功能為準，唔好假設有公開市集可以直接提交。

Skill 唔會自己越用越準。你要將實際修改同好例子加返入去，再試同一批測試。