技能開發最佳實踐

建立有效的代理技能需要仔細考慮結構、清晰度和可重複使用性。本指南涵蓋了從社群和官方指南中收集的最佳實踐。

清晰地建構技能結構

結構良好的技能更容易讓代理遵循，也更便於人類維護。

使用清晰的章節

用明確的章節組織您的技能：

• 概述 - 技能的功能
• 前提條件 - 使用技能前需要準備什麼
• 指令 - 逐步指導
• 範例 - 具體的輸入/輸出對
• 故障排除 - 常見問題和解決方案

保持指令原子化

將複雜任務分解為簡單的順序步驟：

## 指令

1. 分析輸入文件
2. 識別關鍵章節
3. 提取相關資訊
4. 按照範本格式化輸出
5. 驗證結果

為清晰度而寫作

請記住，AI 代理會按字面意思理解您的指令。

具體明確

避免模糊的語言：

• ❌ "適當處理檔案"
• ✅ "解析 JSON 檔案並提取所有 'status' 欄位設定為 'active' 的物件"

定義術語

如果使用特定領域的術語，請定義它：

## 定義

- **Widget**: 顯示使用者資料的 UI 元件
- **Gadget**: 處理請求的後端服務

包含範例

範例幫助代理理解預期行為。

展示輸入和輸出

## 範例

### 輸入
使用者：「建立這份會議記錄的摘要」
[記錄內容]

### 預期輸出
## 會議摘要

**日期**：2025年1月10日
**參與者**：Alice、Bob、Carol

### 要點
1. 討論第一季目標
2. 預算審核已通過
3. 下次會議安排在1月17日

處理邊界情況

考慮可能出錯的情況並提供指導：

## 邊界情況

- 如果輸入為空，回覆「沒有內容可處理」
- 如果格式無法識別，請求澄清
- 如果存在多種解釋，列出它們並請使用者選擇

全面測試

在分享技能之前：

1. 使用各種輸入進行測試
2. 測試邊界情況
3. 讓其他人在沒有解釋的情況下嘗試
4. 根據回饋進行迭代

記錄相依性

列出所需的任何工具、API 或其他技能：

## 相依性

- 檔案系統存取權限
- Python 3.9+
- 用於 PDF 輸入的 `pdf-parser` 技能

版本管理您的技能

追蹤變更：

## 更新日誌

### v1.1.0 (2025-01-10)
- 新增 PDF 輸入支援
- 改進錯誤處理

### v1.0.0 (2025-01-01)
- 初始版本

分享與協作

當我們分享時，社群會變得更強大：

1. 向 Awesome Skills 目錄 貢獻
2. 在 GitHub 上開源您的技能
3. 記錄您的學習歷程
4. 幫助他人解決問題

資源

• 官方技能快速入門
• Claude 技能最佳實踐
• 技能手冊

祝您開發愉快！