最佳實踐
建立有效且可維護的 Agent Skills 指南。
概述
設計良好的技能是決定 AI 助理是否實用的關鍵。遵循這些最佳實踐來建立可靠運作的技能。
核心原則
1. 具體明確，避免模糊
好的做法：
"標題使用句首大寫。僅大寫第一個字和專有名詞。"
不好的做法：
"使用適當的大寫方式。"
2. 提供範例
用展示代替說明。包含預期行為的具體範例。
好的做法：
格式化日期時：
- 寫成："January 15, 2024"
- 不要寫成："01/15/24" 或 "15 Jan 2024"
3. 明確定義範圍
明確說明技能涵蓋什麼和不涵蓋什麼。
好的做法：
此技能涵蓋：
- React 元件設計
- 狀態管理
- 效能優化
此技能不涵蓋：
- 後端 API 設計
- 資料庫架構
- DevOps/部署
4. 使用一致的結構
以可預測的方式組織內容，讓 AI 能快速找到資訊。
建議的章節：
- 背景/概述
- 指南
- 建議與避免事項
- 範例
- 參考資料
5. 保持專注
一個技能 = 一個領域。不要試圖涵蓋所有內容。
好的做法： "React 元件指南" 不好的做法： "完整網頁開發指南"
常見錯誤
過度設計
不要增加無法提供價值的複雜性：
- 太多相互矛盾的規則
- 很少發生的邊界情況
- 冗餘資訊
規範不足
不要讓重要細節模糊不清：
- 關鍵概念缺少範例
- 使用模糊語言如「視情況而定」
- 沒有邊界情況的指導
指令衝突
確保您的指南不會相互矛盾：
問題：
"保持回應簡潔" 和 "提供詳細解釋"
解決方案：
"保持回應簡潔。對於複雜主題，在可展開的區塊中提供詳細解釋。"