AI Skill 使用教程從寫好 SKILL.md 到讓智能體正確調用適合人群使用 AI Agent 的新手、開發(fā)者和團隊成員。本文介紹一種常見的 Agent Skill 組織方式用SKILL.md寫清楚可復用的工作流程再按需附上參考資料、模板或腳本。不同產(chǎn)品的安裝目錄、發(fā)現(xiàn)機制和調用方式可能不同使用前請查看對應工具的說明。一、Skill 是什么可以把 Skill 理解為一份給 AI Agent 使用的“專項工作手冊”。它說明遇到哪類任務時應該采用什么流程、遵守什么規(guī)則、輸出什么結果。需要時還可以帶上參考資料、模板或腳本。例如一個“會議紀要整理”Skill 可以規(guī)定先提取會議結論和待辦負責人或日期缺失時標注“未說明”將原文事實與推測分開按統(tǒng)一格式輸出。Skill 本身通常不會自動賦予 Agent 新能力。它可以告訴 Agent 如何使用已經(jīng)可用的工具是否能讀寫文件、搜索網(wǎng)頁或連接應用取決于當前運行環(huán)境提供的權限和工具。二、Skill、提示詞和工具有什么區(qū)別內(nèi)容主要作用示例提示詞描述當前這一輪任務“總結這份會議記錄”Skill保存可反復使用的任務流程和約定每次整理會議紀要都按同一結構輸出工具讓 Agent 能執(zhí)行具體操作讀取文件、搜索網(wǎng)頁、運行腳本一句話理解提示詞說明這次要做什么Skill 提供穩(wěn)定的做法工具提供執(zhí)行能力。三、一個常見的 Skill 文件結構許多支持 Agent Skills 的工具使用SKILL.md作為入口文件。簡單的 Skill 只需要這個文件復雜流程可以把材料分開放meeting-notes/ ├── SKILL.md # 必需用途、觸發(fā)條件和步驟 ├── references/ │ └── style-guide.md # 可選團隊寫作規(guī)范 ├── assets/ │ └── meeting-template.md # 可選輸出模板 └── scripts/ └── validate.py # 可選重復性校驗腳本常見分工SKILL.md保留必要說明、工作步驟和結果要求references/放較長的背景材料或規(guī)范assets/放輸出模板、示例文件等靜態(tài)素材scripts/放可重復運行的腳本或校驗程序。剛開始不需要把所有目錄都建出來先寫清楚一個可用流程即可。四、編寫第一個 Skill下面以“整理會議紀要”為例。新建一個名為meeting-notes的文件夾并在其中創(chuàng)建SKILL.md--- name: meeting-notes description: 根據(jù)會議記錄整理結論、待辦事項和未決問題。用戶要求整理、歸納或規(guī)范化會議記錄時使用。 --- # 會議紀要整理 ## 目標 把用戶提供的會議記錄整理成易檢查的結構化紀要。 ## 工作步驟 1. 識別會議主題、日期和參會人原文沒有的信息標記“未提供”。 2. 提取明確達成的結論不把討論中的設想寫成已決定事項。 3. 提取待辦事項并記錄負責人和截止日期。 4. 將尚未解決的問題單獨列出。 5. 檢查姓名、數(shù)字、日期和行動項是否能在原文中找到依據(jù)。 ## 輸出格式 - 會議主題與日期 - 已確認結論 - 待辦事項事項負責人截止日期 - 未決問題 ## 邊界 - 只依據(jù)用戶提供的材料不補造事實。 - 缺少負責人或日期時寫“未說明”。 - 不發(fā)送會議紀要不修改原始文件。 - 如果材料中包含相互矛盾的信息列出矛盾并請用戶確認。這里的name是便于系統(tǒng)識別的短名稱description要說明 Skill 做什么以及何時應該使用。只寫“幫助整理”太寬泛Agent 不容易判斷適用時機。五、怎樣讓 Skill 更容易被正確調用1. 一個 Skill 對準一個明確目標不要把“寫文章、調試代碼、分析表格、整理會議”全部塞進一個 Skill。任務目標差別太大時分別建立 Skill觸發(fā)條件會更明確規(guī)則也更容易維護。2. 在 description 里寫觸發(fā)場景可以用這個結構[產(chǎn)出或處理什么]。當用戶要求[具體任務或場景]時使用。例如根據(jù)用戶提供的 CSV 生成數(shù)據(jù)摘要和異常項清單。當用戶要求分析、匯總或檢查 CSV 文件時使用。3. 用步驟替代模糊要求“認真分析并給出好結果”無法指導具體行動。更好的寫法是先檢查字段、再處理空值、然后計算指標、最后說明限制條件。4. 寫出停止條件告訴 Agent 什么時候需要停下來詢問例如材料不足、出現(xiàn)矛盾、需要外部發(fā)送或操作可能修改原始數(shù)據(jù)。六、怎樣安裝和使用 SkillSkill 的文件格式可以相近但每個平臺的安裝位置和加載方式并不完全相同。通用步驟如下查看正在使用的 Agent 是否支持SKILL.md或 Agent Skills 格式。按對應平臺的說明把 Skill 文件夾放進指定目錄、工作區(qū)或運行環(huán)境。檢查 Agent 是否能發(fā)現(xiàn)該 Skill部分工具會自動根據(jù)name和description判斷是否調用。直接描述具體任務如果需要明確指定可以在請求中寫“請使用meeting-notesSkill”。檢查輸出是否符合 Skill 的步驟和格式并根據(jù)遺漏調整說明。以 OpenAI 的 Agent Skills 文檔為例Skill 由包含SKILL.md的目錄構成可帶參考文件、腳本和素材在 API 執(zhí)行環(huán)境中的掛載方式取決于使用 hosted shell、local shell 或 Agents API。不要把某個平臺的安裝路徑直接套用到另一個工具。七、用真實任務迭代 Skill第一次寫出的 Skill 通常只是初稿?？梢杂脦追N不同輸入檢查規(guī)則是否清楚標準情況信息完整的會議記錄缺項情況沒有寫日期或負責人矛盾情況兩個段落對截止時間寫法不同邊界情況用戶只要求提取某一部分不適用情況用戶問的是會議邀請郵件而不是整理會議記錄。觀察 Agent 是否在正確任務中調用 Skill是否按格式輸出以及遇到缺失信息時有沒有亂猜。然后只修改不清楚或容易誤用的說明并再次檢查。八、常見問題排查Skill 沒有被調用檢查description是否包含實際觸發(fā)場景在任務中明確說“使用某某 Skill”確認 Skill 已放在正確位置并且當前環(huán)境支持這種加載方式。Agent 只遵循了一部分規(guī)則把重要要求改寫成編號步驟或檢查清單。把主要流程放在SKILL.md不要只藏在未被讀取的附加文件中。SKILL.md 越寫越長把詳細規(guī)范、示例或背景資料移到references/并在主文件中說明何時讀取。主文件優(yōu)先保留任務目標、觸發(fā)條件、關鍵步驟、輸出格式和邊界。不同平臺上的表現(xiàn)不一致檢查該工具支持的 front matter 字段、目錄約定和加載方式。相同的SKILL.md內(nèi)容不代表每個平臺都會以相同方式加載或調用。九、安全使用 SkillSkill 文件會影響 Agent 的判斷和工具使用方式。使用別人提供的 Skill 前先檢查它的指令、腳本和引用文件有沒有要求上傳或泄露本地資料有沒有運行來源不明的命令或下載程序有沒有要求繞過權限、確認步驟或安全限制腳本會讀取、覆蓋或刪除哪些文件是否會把信息發(fā)送給外部服務只使用任務所需的最小權限。涉及發(fā)送、發(fā)布、支付、刪除、生產(chǎn)環(huán)境修改等高影響操作時應保留人工審核和明確確認。十、本節(jié)小結一個好用的 Skill 不在于寫得很長而在于目標明確、觸發(fā)條件清楚、步驟可執(zhí)行、輸出能檢查、邊界寫完整。先從一個重復的小任務開始用實際結果不斷修訂再考慮增加參考資料、模板或腳本。參考資料OpenAI Agent Skills 文檔OpenAIBuild skillsAgent Skills 開放規(guī)范本文關鍵詞AI Skill、Agent Skills、SKILL.md、AI Agent、智能體工作流、提示詞