撰寫有效的描述
您的技能描述對於可發現性和使用者理解至關重要。
兩種描述
1. Frontmatter 描述（200 字元）
出現在：
- 搜尋結果
- 技能卡片
- 市場列表
目標： 快速傳達價值和範圍。
2. 內容描述（無限制）
出現在：
- 技能詳細頁面
- 文件
目標： 提供全面的理解。
Frontmatter 描述技巧
以價值為先
從使用者獲得的好處開始，而不是技能是什麼。
好的做法：
"使用元件模式、效能技巧和無障礙指南撰寫更乾淨的 React 程式碼。"
不好的做法：
"此技能包含 React 開發指南。"
包含關鍵字
幫助使用者透過搜尋找到您的技能。
好的做法：
"TypeScript 型別安全指南：泛型、型別守衛、工具型別和嚴格模式最佳實踐。"
不好的做法：
"型別安全程式碼指南。"
明確說明範圍
設定清晰的期望。
好的做法：
"API 安全檢查清單：REST API 的身份驗證、授權、輸入驗證和速率限制。"
不好的做法：
"安全最佳實踐。"
使用主動語言
使其面向行動。
好的做法：
"使用 ARIA 標籤、鍵盤導航和螢幕閱讀器支援建立無障礙 React 元件。"
不好的做法：
"React 的無障礙資訊。"
範本
指南類技能
[動作] [領域] 使用 [關鍵功能 1]、[關鍵功能 2] 和 [關鍵功能 3]。
範例：
"使用 BEM 命名、工具類別和響應式設計模式撰寫可維護的 CSS。"
審查類技能
[審查類型] 針對 [受眾]：[檢查 1]、[檢查 2] 和 [檢查 3]。
範例：
"團隊的程式碼審查指南：安全檢查、效能分析和風格一致性。"
整合類技能
[整合/連接] [技術] 使用 [方法]：[功能 1] 和 [功能 2]。
範例：
"使用最佳實踐整合 Stripe 支付：webhook 處理和錯誤恢復。"
常見錯誤
太模糊
問題： "更好程式碼的指南。" 更好的做法： "Python 程式碼品質：PEP 8 風格、型別提示和文件標準。"
太長
問題： 超過 300 字元的描述會被截斷。 更好的做法： 保持在 180 字元以下。使用內容區塊來說明細節。
沒有上下文的術語
問題： "具有 CQRS 模式的 DDD 的 SOLID 原則。" 更好的做法： "乾淨架構模式：單一職責、依賴注入和領域建模。"
沒有差異化
問題： "React 開發指南。" 更好的做法： "React 伺服器元件：串流、suspense 和資料獲取模式。"
關鍵字策略
包含使用者可能搜尋的詞彙：
| 類別 | 關鍵字 | |----------|----------| | 技術 | React、TypeScript、Python、AWS | | 領域 | 身份驗證、支付、分析 | | 任務 | 審查、測試、部署 | | 品質 | 安全性、效能、無障礙性 |
測試您的描述
- 搜尋測試： 搜尋相關詞彙時能找到這個嗎？
- 瀏覽測試： 能在 5 秒內理解這個技能嗎？
- 差異化測試： 這與類似技能有何不同？
- 行動測試： 清楚知道如何使用這個技能嗎？