--- title: 用技能教助理怎麼做事 description: 把做事方法寫成技能，或從 GitHub 匯入技能包，掛到助理上；每次回答，助理都會照著技能裡的指示做。 url: https://agentlab.cresclab.com/docs/zh-tw/studio/skills language: zh-Hant updated: 2026-11-06 --- # 用技能教助理怎麼做事 把做事方法寫成技能，或從 GitHub 匯入技能包，掛到助理上；每次回答，助理都會照著技能裡的指示做。 ## 技能是什麼 技能是一段可以重複使用的做事方法，例如「回覆客訴的步驟」或「報價單的格式」。掛上技能的助理，每次回答都會把技能當成持續有效的工作指示。 技能和[知識庫](https://agentlab.cresclab.com/docs/zh-tw/studio/knowledge.md)的差別： - **知識庫**放的是資料。助理依問題檢索，只取用相關的部分。 - **技能**放的是做法。掛上的技能每次回答都會整段帶上，不經過檢索。 開啟主控台的「技能」，可以看到兩個區塊：「技能庫」列出工作區共用的技能和你自己的技能；「技能包」可以從 GitHub 匯入技能。 ## 誰能做什麼 | 動作 | 誰可以 | | ------------------------------------ | -------------------- | | 查看技能庫 | 工作區所有成員 | | 建立、編輯、刪除工作區技能庫裡的技能 | 工作區擁有者與管理員 | | 匯入、同步技能包 | 工作區擁有者與管理員 | | 把技能掛到助理上、取下 | 工作區擁有者與管理員 | | 建立、編輯、刪除自己的技能 | 工作區所有成員 | | 把自己的技能掛到自己的私人助理上 | 技能的擁有者 | ## 建立技能 1. 開啟「技能」，捲到「建立技能」。 2. 填「名稱」。 3. 需要的話填「描述(選填)」，說明這個技能用在什麼時候。 4. 填「指示內容」：用到這個技能時，助理要照著做的步驟。 5. 決定「只給自己用」要不要打開（見[只給自己用的技能](https://agentlab.cresclab.com/docs/zh-tw/studio/skills.md#personal-skills)）。 6. 按「建立」。 建立後，技能會出現在「技能庫」的表格，顯示「名稱」和「描述」。 > [!TIP] > 指示內容寫成步驟最有效，例如「先確認訂單編號，再依退貨期限判斷……」。要給助理參考的資料，放進[知識庫](https://agentlab.cresclab.com/docs/zh-tw/studio/knowledge.md)。 ## 只給自己用的技能 建立技能時打開「只給自己用」，技能就只有你看得到，不會加進工作區技能庫。這些技能會列在「技能庫」表格的「我的技能」下方，名稱旁標示「只有你」。 - 不是擁有者或管理員的成員，寫的技能一律只給自己用，這個開關會固定打開。要加進工作區技能庫，需要請工作區擁有者或管理員建立。 - 自己的技能只能掛在你自己的私人助理上，在私人助理的「其他設定」裡掛。 - 私人助理掛著你的個人技能時，不能分享出去。先把技能取下，或請管理員把它放進工作區技能庫，再分享。 - 你可以自己編輯、刪除、還原自己的技能，不需要管理員權限。 ## 從 GitHub 匯入技能包 如果你的團隊已經把技能放在 GitHub，可以整包匯入，之後再同步更新。 1. 在「技能」頁的「技能包」區塊，填「Repository 網址」，例如 `https://github.com/your-org/skills`。 2. 需要的話填「分支或標籤」。不填就用 `main`。 3. 按「匯入技能包」。 完成後，頁面會顯示這次的結果：「新增 N、更新 N、略過 N、保留本地 N、格式錯誤 N、未匯入的附檔 N。」 ### Repository 的格式 Repository 裡每個資料夾放一個 `SKILL.md`，就是一個技能： ```markdown SKILL.md --- name: 退貨處理 description: 客戶要求退貨時使用 --- 1. 先確認訂單編號與購買日期。 2. 超過 7 天的訂單，說明退貨期限並提供客服信箱。 ``` - `name` 必填，成為技能的名稱；`description` 選填。 - 文件開頭必須是 `---`，而且要有結尾的 `---`。 - `---` 之後的內容就是指示內容，不能是空的。 - 和 `SKILL.md` 放在同一個資料夾的其他檔案不會匯入，會算在「未匯入的附檔」。 - 不符合格式或超過[長度上限](https://agentlab.cresclab.com/docs/zh-tw/studio/skills.md#limits)的 `SKILL.md` 不會匯入，會算在「格式錯誤」。 ### 匯入和同步的規則 - 只支援 github.com 上的公開 repository。 - 技能庫裡已經有同名的技能（不分大小寫），那個技能會被略過，不會覆蓋。 - 匯入的技能會放進工作區技能庫，算在 50 個的額度裡。 - 每個技能包會列出網址、分支或標籤，以及目前同步到的 commit。按「同步」會抓 repository 的最新內容： - 上游改了、你沒改過的技能，會更新成新內容，舊內容留在[版本紀錄](https://agentlab.cresclab.com/docs/zh-tw/studio/skills.md#edit-and-history)。 - 你在 Agent Lab 改過的技能，同步時一律保留你的版本，算在「保留本地」。 - 上游刪掉的技能，仍會留在技能庫，不會自動刪除。 - Repository 的大小也有上限：最多 5,000 個檔案、總共 32 MB、單一檔案 4 MB。超過就整包不匯入。 ## 掛到助理上 1. 開啟助理的設定頁，找到「技能」區塊。 2. 在「選擇技能」選一個，按「掛上」。 3. 要取下時，按技能標籤上的 ×。 一個助理最多掛 20 個技能。技能庫裡還沒有技能時，這裡會提示你先到「技能」頁建立。設定助理的其他部分，見[助理](https://agentlab.cresclab.com/docs/zh-tw/studio/assistants.md)。 ## 助理怎麼使用技能 每次回答時，助理會把掛上的技能依掛上的順序，接在它自己的工作指示後面，再讀取知識庫的資料。技能不會因為提問者是誰而不同。 所有掛上的技能合計有長度上限，約 6,000 位元組（中文約 2,000 字）。加到某個技能會超過上限時，從那個技能開始，後面的技能都不會帶上，主控台也不會提示。掛了很多技能，或技能寫得很長時，請把最重要的先掛，並且讓每個技能保持精簡。 ## 編輯與版本紀錄 - **編輯**：在技能那一列按「編輯」，改完按「儲存變更」。編輯畫面會顯示目前是「第 N 版」。所有掛著這個技能的助理，會立刻改用新的內容。 - **同時編輯**：有其他人在你編輯期間改了同一個技能，你的儲存會被擋下，畫面會重新載入並提示你，先看過現在的內容再儲存。 - **歷史**：按「歷史」可以看「…以前的內容」，每個版本都標示時間和修改者。目前生效的版本標示「目前使用中」。想改回某一版，按「改回這個版本」。 ## 刪除技能 在技能那一列按「刪除」。對話框會列出正在使用這個技能的助理，提醒你刪掉之後它們的回覆會改變。確認後按「仍要刪除」，想保留就按「先留著」。 刪除會把技能從所有助理上取下。掛上、取下、刪除技能，都會記錄在「團隊與權限」的稽核紀錄裡。 ## 上限 | 項目 | 上限 | | ---------------------- | ---------------------------------- | | 工作區技能庫 | 50 個（含匯入的技能） | | 每位成員自己的技能 | 50 個，不占工作區額度 | | 每個助理掛上的技能 | 20 個 | | 名稱 | 120 字 | | 描述 | 500 字 | | 指示內容 | 4,000 字 | | 每次回答帶上的技能合計 | 約 6,000 位元組（中文約 2,000 字） | | 技能包頁面列出的數量 | 前 50 個 | 名稱、描述、指示內容都以字數計算，中文字和英文字母一樣算一個字。每次回答帶上的技能合計則是以位元組計算，中文字一個算 3 位元組，所以中文技能大約 2,000 字就會到上限。名稱、描述或指示內容超過長度時，建立會顯示「無法建立技能，請檢查名稱與指示內容。」，編輯後儲存會顯示「技能儲存失敗，請再試一次。」。 ## 接下來 - [助理](https://agentlab.cresclab.com/docs/zh-tw/studio/assistants.md): 建立助理，掛上技能和知識庫。 - [知識庫](https://agentlab.cresclab.com/docs/zh-tw/studio/knowledge.md): 放進文件和問答，讓助理照你的資料回答。