每週都讓 Agent 整理客服工單，每週都重新解釋日期、字段和格式。做成 Skill 後，這些要求可以複用。但如果“幫我看看週報模板”也觸發完整彙總，或者缺少本週數據時拿舊文件填空，複用就變成了重複犯錯。
Skill 的第一道驗收不是寫得多完整，而是該運行時運行、不該運行時停下。 先把一個已經做過兩次的工作拆清楚，再讓 Skill Creator 幫忙。
從一份週報，寫出輸入契約
用一個虛構的客服週報任務做示例：把本週工單整理成“主要問題、需要升級的事項、待確認數據、下一步負責人”。它不負責發送報告，也不執行退款。
開始前列清五項：報告日期範圍、業務隊列、本次數據文件、允許參考的模板、預期輸出。日期是每輪變量，不能永久寫成“本週”；“客服工單”也要指定產品或隊列，不能默認讀所有目錄。
必要文件不存在、數據日期不符或關鍵字段缺失時，要求先補問。不從上週數據推本週，不把空字段猜成正常值。記錄只給出問題數量時，也不能憑空推斷解決時長。
任務：整理某個客服隊列在指定起止日期內的工單。
輸入：當前日期範圍、本次工單文件、報告模板。
輸出：報告草稿與缺項清單，保存到本次工作目錄。
停止條件：日期未指定、文件缺失、數據範圍不匹配。
不執行：發送報告、修改工單狀態、退款或客戶回覆。
用 Skill Creator 起草方法，不把資料塞進方法
在 Buda Agent 會話中說：“把這個做成 Skill。”Skill Creator 會圍繞用途、觸發情境、輸出和測試詢問，再起草 SKILL.md。
先把輸入契約、模板和幾條樣本交給它。name 是標識，description 說明什麼情況下使用，正文寫具體步驟。客戶數據、登錄信息和某一週的源文件不應複製進共享 Skill；方法引用每輪輸入，讓事實留在相應資料中。
先在 Buda AI 的 Marketplace 搜索並安裝已有合適 Skill，讀清步驟後再決定是否需要定製。現成 Skill 與團隊 SOP 的區別，往往就在日期邊界、輸出格式和停止條件，而不是名字夠不夠專業。
description 要能區分三個相似請求
“整理本週客服工單，按團隊週報模板輸出”是正觸發；“只解釋週報模板各欄含義”不是彙總任務；“沒有本週數據，先聊聊怎麼改善客服”也不是執行授權。
可以給 Creator 這樣的描述建議：
用於用戶明確要求按團隊模板整理指定時間範圍的客服工單報告。
不用於僅閱讀模板、解釋字段或討論客服策略。
用戶要求整理但必要輸入缺失時，先列缺項，不生成完整報告。
這不是硬編碼分類器的準確率保證。要用真實說法試觸發，尤其是同事不會照着 Skill 描述提問的時候。manifest 中的工具聲明也不是審批制度；不能靠描述一句“只讀”就省掉任務行爲檢查。
正文按五個動作寫，每步留下可檢查結果
讀取：確認指定範圍與當前文件，不遍歷無關客戶資料。
覈對：檢查工單日期、ID 與必要字段；缺項與衝突分別列出。
整理：按模板歸類，保留工單編號作爲證據；沒有原因記錄時寫待確認。
檢查：覈對總數是否能回到輸入，重複工單是否說明，升級事項有沒有負責人。
產出：保存報告草稿和缺項清單，給出路徑供人檢查；不追加發送步驟。
給每一步寫輸入和預期產物，比“認真分析、準確總結”更可測試。報告裏區分原始記錄和推斷，未記錄的根因不要補成確定事實。
準備 3 個正例、3 個反例、2 個缺輸入例
下面是建議驗收集，不是實測成績：
| 樣本 | 應有行爲 |
|---|---|
| 完整日期、工單文件、模板 | 運行並交報告草稿 |
| 同一任務換一種口語表達 | 仍識別任務，保留範圍 |
| 指定另一隊列與日期 | 使用新輸入，不沿用舊隊列 |
| 只查看模板 | 不開始工單彙總 |
| 只解釋字段 | 回答含義，不僞造報告 |
| 討論改善策略 | 不擅自執行週報流程 |
| 缺工單文件 | 列缺項，等待補充 |
| 文件日期與請求不符 | 指出衝突，不拿舊數據填空 |
每條記下請求、實際觸發、實際產物、偏差和修訂。漏觸發與誤觸發要分開看；產物格式正確卻來源錯了，也算失敗。不要把八個樣本通過寫成所有業務場景都可靠。
確認當前版本，再決定是否共享
Apps & Skills 可以查看完整 manifest，Local Skill 在工作區修改後需要 Refresh。先確認看到的步驟與剛修訂的一致，再重跑引發修改的樣本。Refresh 是重新掃描，不是自動證明測試通過，更不是上架 Marketplace。
先在 agent scope 試用一個專門 Agent 的流程；團隊確認輸出和停止條件後，再考慮 space scope 共享。Space 範圍的 Skill 對該 Space 的 Agent 可見，敏感資料和特定客戶上下文不要寫入共享方法。
爲方法記錄版本說明、修改點和受影響樣本。變更 description 會影響觸發範圍，改輸出字段會影響下游使用，都要回歸正常、反例和缺輸入情形。定時任務是下一層：只有方法驗收後，才另外定義每次的日期和數據來源；不要把固定排程當作方法已經可靠。
Skill 與 Agent 有什麼區別？
Agent 承接會話、工作資料和任務；Skill 是它可加載的具體方法。把同一種整理方法做成 Skill，可以少重複解釋，但每輪仍要給日期和本次文件。
改了文件，爲什麼還要 Refresh？
Apps & Skills 需要重新掃描工作區以顯示變更。編輯 Local Skill 的 SKILL.md 後 Refresh，再打開 manifest 檢查版本與步驟，隨後重跑相關樣本。
最值得保留哪個反例？
保留措辭最接近真實任務、但本來不該執行的請求，例如“只解釋這個週報模板”。它能暴露描述過寬的問題；同時留一個日期不匹配樣本，防止複用舊輸入。
挑一個已重複做過的 SOP，先寫出停止條件，再把八個樣本交給 Skill Creator。可複用流程的價值，不只是讓 Agent 更容易開始，也是讓團隊知道它何時應該停。