常見問題排查
簡化說明
由於篇幅限制，本文件使用簡化版本。完整內容請參考源文件。
部署相關問題
Network Egress Error（網路錯誤）
問題：部署到 Vercel 時出現網路錯誤。
解決方案：
- 前往 https://claude.ai/settings/capabilities
- 在 "Allowed Domains" 中新增
*.vercel.com - 儲存設定後重新部署
部署失敗
問題：無法提取 preview URL。
解決方案：檢查完整錯誤回應，常見錯誤類型：
- File too large：專案體積超限
- Invalid framework：框架識別失敗
- Network timeout：網路逾時
框架檢測不準確
問題：檢測到的框架與實際不符。
解決方案：
- 檢查
package.json中的依賴 - 如果不影響部署，可以忽略
- 專案仍能正常部署
技能啟用問題
技能未啟用
問題：技能沒有被啟用。
解決方案：
- 驗證技能已安裝
- 使用明確的關鍵詞
- 重新載入技能
Web 設計指南無法拉取規則
問題：無法從 GitHub 拉取規則。
解決方案：
- 在 claude.ai 設定中新增：
raw.githubusercontent.com和github.com - 驗證網路存取
規則驗證問題
VALIDATION_ERROR
問題：規則驗證失敗。
解決方案：
- 檢查 frontmatter 格式
- 確保有標題和說明
- 確保至少包含一個程式碼範例
- 確保 impact 級別合法