SKILL.md 怎麼寫:把人工操作流程改寫成智能體 Skill 的提示詞(觸發描述、步驟、判斷點、參考文件拆分)
團隊裏有一套反覆執行的流程(發版步驟、週報整理、代碼評審清單、客戶資料核對),想沉澱成智能體可以按需加載的 Skill 時用:把現有的流程文檔或口頭步驟交給 AI,它改寫成結構清楚的 SKILL.md——什麼情況下啟用、按什麼順序做、遇到分支怎麼判斷、哪些內容拆到附屬文件,並指出原流程裏只有老員工才知道的隱含知識。
通用大模型 對話模型通用
【角色】你是為團隊編寫智能體 Skill 的工程師。你知道寫給人看的流程文檔預設讀者有背景知識、會自己判斷,而寫給智能體的 Skill 必須把觸發條件、判斷依據和完成標準都寫出來。 【輸入】 - 現有流程(文檔原文,或一位熟手口述的步驟):[現有流程] - 這個流程什麼時候會被用到(用戶通常怎麼提出需求):[使用場景與說法] - 智能體在其中可用的工具與權限:[可用工具與權限] - 流程中用到的模板、腳本、清單等材料:[已有材料] - 所用平台對 Skill 的格式要求:[平台格式要求] 【任務】 1. 先判斷適不適合做成 Skill:這個流程是否會重複出現、步驟是否相對穩定、是否有智能體自己無法推斷的團隊約定。不適合的話說明更合適的形式(寫進項目說明文件、做成腳本、保持人工)。 2. 挖出隱含知識:逐步檢查原流程,列出「熟手預設知道但文檔沒寫」的內容——前置條件、判斷標準(什麼算「沒問題」)、例外情況、做完後要通知誰——整理成問題清單問我;我沒回答的部分在成稿中標【待確認】。 3. 寫元資訊: - 名稱:簡短、小寫、用連字符; - 描述:一兩句話,說明這個 Skill 做什麼、在什麼情況下應當使用,包含用戶常用的說法作為觸發線索;同時寫明不適用的相近情況,避免誤觸發。 4. 寫正文,建議結構: - 適用範圍與前置檢查(不滿足時怎麼辦); - 步驟:每步寫清動作、用到的工具或材料、這一步完成的判斷標準;需要判斷的地方寫成「如果……則……否則……」; - 需要先徵得用戶確認才能做的動作(對外發送、刪除、發佈等); - 完成標準與最終彙報應包含的內容; - 常見問題與處理。 5. 拆分建議:正文只保留每次都要用的內容;篇幅長的參考資料、模板、示例放到附屬文件,在正文裏用一句話說明什麼時候去讀哪個文件;能確定性完成的步驟(格式轉換、校驗)建議做成腳本而不是讓模型每次重新寫。 6. 解釋每條關鍵規則背後的原因(一句話即可),讓智能體在遇到流程沒覆蓋的情況時能據此判斷,而不是隻會機械執行。 7. 給出 4–6 條測試用的用戶請求:應當觸發並走通的、應當觸發但會走到分支的、相近但不應觸發的,分別寫明期望行為。 【約束】 - 不替我編造流程中沒有的步驟或團隊規定;發現流程本身有漏洞時單獨指出,由我決定是否修改。 - 格式以我提供的平台要求為準;我沒提供時按「帶名稱與描述的元資訊 + Markdown 正文」的常見形式寫,並提醒我核對所用平台的文檔。 - 正文不寫口令、密鑰等憑據內容,只寫它們存放的位置。 【輸出格式】適用性判斷 → 隱含知識問題清單 → SKILL.md 全文 → 附屬文件與腳本拆分清單 → 測試請求表。
高亮處換成你自己的內容:[現有流程]、[使用場景與說法]、[可用工具與權限]、[已有材料]、[平台格式要求]
ChatGPT Plus 充值
已被複製 0 次
使用說明
怎麼填變量:[現有流程] 可以直接貼團隊文檔,也可以讓最熟悉的人口述一遍後貼轉寫稿,口述版往往包含更多「其實還要看一下……」的隱含步驟。[使用場景與說法] 寫用戶平時怎麼開口,例如「幫我發個版」「出一下這週的週報」,這些說法會寫進描述裏幫助觸發。[平台格式要求] 從所用產品的文檔裏複製關於 Skill 文件結構的說明;拿不準就留空,模型會按常見形式寫並提醒核對。
常見失敗與調整:
- 描述寫得太寬(「處理各類文檔」),導致不相關的請求也觸發;或太窄,用戶換個說法就不觸發。用第 7 步的測試請求來回調整描述。
- 把幾十頁的規範全文塞進正文。正文越長,每次加載佔用的上下文越多,按第 5 步拆到附屬文件。
- 通篇都是「必須」「嚴禁」,卻不說原因。遇到沒覆蓋的情況時模型無從判斷,補上第 6 步的理由。
追問:「根據我對隱含知識問題的回答,更新 SKILL.md」「把其中的校驗步驟寫成一個腳本,並在正文裏改為調用它」。
示例輸出
示例,僅供參考(虛構:把「每週客戶週報」流程改寫成 Skill)
markdown
---
name: weekly-client-report
description: 按團隊模板整理每週客戶週報。當用戶說「出週報」「整理本週給客戶的進展」或提供本週工作記錄並要求彙總時使用。不用於內部站會紀要或月度總結。
---
# 每週客戶週報
## 前置檢查
- 確認用戶提供了本週工作記錄;沒有則先詢問,不要憑空編寫進展。
## 步驟
1. 讀取 `templates/report.md` 作為版式。
2. 把工作記錄歸入「已完成 / 進行中 / 風險與需客戶配合」三欄。
- 如果某項沒有明確狀態,歸入「進行中」並標【待確認】。
3. 數字(工時、完成數量)只使用記錄裏出現的,原因:週報會被客戶當作結算依據。
4. 生成草稿後交給用戶確認。**發送給客戶前必須得到用戶明確同意。**
## 完成標準
三欄齊全、無【待確認】殘留、用戶已確認草稿。
不應觸發的測試請求:「幫我寫一下今天站會的紀要」——期望行為是不加載本 Skill。
同款作品
用這條提示詞做出來的作品;原作者會因此獲得積分
還沒有同款,來做第一個。


0 條評論
還沒有評論,來搶沙發~