用技能教助理怎麼做事

把做事方法寫成技能，或從 GitHub 匯入技能包，掛到助理上；每次回答，助理都會照著技能裡的指示做。

技能是什麼#

技能是一段可以重複使用的做事方法，例如「回覆客訴的步驟」或「報價單的格式」。掛上技能的助理，每次回答都會把技能當成持續有效的工作指示。

技能和知識庫的差別：

• 知識庫放的是資料。助理依問題檢索，只取用相關的部分。
• 技能放的是做法。掛上的技能每次回答都會整段帶上，不經過檢索。

開啟主控台的「技能」，可以看到兩個區塊：「技能庫」列出工作區共用的技能和你自己的技能；「技能包」可以從 GitHub 匯入技能。

誰能做什麼#

建立技能#

1. 開啟「技能」，捲到「建立技能」。
2. 填「名稱」。
3. 需要的話填「描述(選填)」，說明這個技能用在什麼時候。
4. 填「指示內容」：用到這個技能時，助理要照著做的步驟。
5. 決定「只給自己用」要不要打開（見只給自己用的技能）。
6. 按「建立」。

建立後，技能會出現在「技能庫」的表格，顯示「名稱」和「描述」。

只給自己用的技能#

建立技能時打開「只給自己用」，技能就只有你看得到，不會加進工作區技能庫。這些技能會列在「技能庫」表格的「我的技能」下方，名稱旁標示「只有你」。

• 不是擁有者或管理員的成員，寫的技能一律只給自己用，這個開關會固定打開。要加進工作區技能庫，需要請工作區擁有者或管理員建立。
• 自己的技能只能掛在你自己的私人助理上，在私人助理的「其他設定」裡掛。
• 私人助理掛著你的個人技能時，不能分享出去。先把技能取下，或請管理員把它放進工作區技能庫，再分享。
• 你可以自己編輯、刪除、還原自己的技能，不需要管理員權限。

從 GitHub 匯入技能包#

如果你的團隊已經把技能放在 GitHub，可以整包匯入，之後再同步更新。

1. 在「技能」頁的「技能包」區塊，填「Repository 網址」，例如 https://github.com/your-org/skills。
2. 需要的話填「分支或標籤」。不填就用 main。
3. 按「匯入技能包」。

完成後，頁面會顯示這次的結果：「新增 N、更新 N、略過 N、保留本地 N、格式錯誤 N、未匯入的附檔 N。」

Repository 的格式

Repository 裡每個資料夾放一個 SKILL.md，就是一個技能：

---
name: 退貨處理
description: 客戶要求退貨時使用
---

1. 先確認訂單編號與購買日期。
2. 超過 7 天的訂單，說明退貨期限並提供客服信箱。

• name 必填，成為技能的名稱；description 選填。
• 文件開頭必須是 ---，而且要有結尾的 ---。
• --- 之後的內容就是指示內容，不能是空的。
• 和 SKILL.md 放在同一個資料夾的其他檔案不會匯入，會算在「未匯入的附檔」。
• 不符合格式或超過長度上限的 SKILL.md 不會匯入，會算在「格式錯誤」。

匯入和同步的規則

• 只支援 github.com 上的公開 repository。
• 技能庫裡已經有同名的技能（不分大小寫），那個技能會被略過，不會覆蓋。
• 匯入的技能會放進工作區技能庫，算在 50 個的額度裡。
• 每個技能包會列出網址、分支或標籤，以及目前同步到的 commit。按「同步」會抓 repository 的最新內容： - 上游改了、你沒改過的技能，會更新成新內容，舊內容留在版本紀錄。 - 你在 Agent Lab 改過的技能，同步時一律保留你的版本，算在「保留本地」。 - 上游刪掉的技能，仍會留在技能庫，不會自動刪除。
• Repository 的大小也有上限：最多 5,000 個檔案、總共 32 MB、單一檔案 4 MB。超過就整包不匯入。

掛到助理上#

1. 開啟助理的設定頁，找到「技能」區塊。
2. 在「選擇技能」選一個，按「掛上」。
3. 要取下時，按技能標籤上的 ×。

一個助理最多掛 20 個技能。技能庫裡還沒有技能時，這裡會提示你先到「技能」頁建立。設定助理的其他部分，見助理。

助理怎麼使用技能#

每次回答時，助理會把掛上的技能依掛上的順序，接在它自己的工作指示後面，再讀取知識庫的資料。技能不會因為提問者是誰而不同。

所有掛上的技能合計有長度上限，約 6,000 位元組（中文約 2,000 字）。加到某個技能會超過上限時，從那個技能開始，後面的技能都不會帶上，主控台也不會提示。掛了很多技能，或技能寫得很長時，請把最重要的先掛，並且讓每個技能保持精簡。

編輯與版本紀錄#

• 編輯：在技能那一列按「編輯」，改完按「儲存變更」。編輯畫面會顯示目前是「第 N 版」。所有掛著這個技能的助理，會立刻改用新的內容。
• 同時編輯：有其他人在你編輯期間改了同一個技能，你的儲存會被擋下，畫面會重新載入並提示你，先看過現在的內容再儲存。
• 歷史：按「歷史」可以看「…以前的內容」，每個版本都標示時間和修改者。目前生效的版本標示「目前使用中」。想改回某一版，按「改回這個版本」。

刪除技能#

在技能那一列按「刪除」。對話框會列出正在使用這個技能的助理，提醒你刪掉之後它們的回覆會改變。確認後按「仍要刪除」，想保留就按「先留著」。

刪除會把技能從所有助理上取下。掛上、取下、刪除技能，都會記錄在「團隊與權限」的稽核紀錄裡。

上限#

名稱、描述、指示內容都以字數計算，中文字和英文字母一樣算一個字。每次回答帶上的技能合計則是以位元組計算，中文字一個算 3 位元組，所以中文技能大約 2,000 字就會到上限。名稱、描述或指示內容超過長度時，建立會顯示「無法建立技能，請檢查名稱與指示內容。」，編輯後儲存會顯示「技能儲存失敗，請再試一次。」。

接下來#