القائمة
API 設計原則與決策。REST vs GraphQL vs tRPC 選擇、回應格式、版本控制、分頁。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
使用 Claude API / Anthropic SDK 建構、除錯和最佳化應用程式。使用此技能建構的應用程式應包含提示快取 (prompt caching)。也處理在 Claude 模型版本之間遷移現有 Claude API 程式碼（4.5 → 4.6，4.6 → 4.7，替換已退役模型）。觸發時機：程式碼匯入 anthropic/@anthropic-ai/sdk；使用者要求使用 Claude API、Anthropic SDKs 或 Managed Agents (/v1/agents, /v1/sessions, /v1/environments)；使用者在檔案中新增/修改/調整 Claude 功能（快取、思考、壓縮、工具使用、批次、檔案、引用、記憶）或模型（Opus/Sonnet/Haiku）；關於 Anthropic SDK 專案中提示快取/快取命中率的問題。不觸發：檔案匯入 `openai`/其他提供者 SDK，檔案名稱類似 `*-openai.py`/`*-generic.py`，與提供者無關的程式碼，一般程式設計/機器學習。
當編寫呼叫 Gemini API 的程式碼時請使用此技能，用於文字生成、多輪對話、多模態理解、影像生成、串流回應、背景研究任務、函式呼叫、結構化輸出，或從舊的 generateContent API 遷移。此技能涵蓋 Interactions API，這是在 Python 與 TypeScript 中使用 Gemini 模型與代理的建議方式。
Tailwind CSS v4 原則。CSS 優先配置、容器查詢、現代模式、設計 token 架構。
處理使用 Gemini Live API 的即時、雙向串流應用程式時使用此技能。涵蓋基於 WebSocket 的音訊/視訊/文字串流、語音活動偵測 (VAD)、原生音訊功能、函式呼叫、會話管理、用戶端身分驗證的臨時權杖，以及所有 Live API 設定選項。涵蓋的 SDK - google-genai (Python)、@google/genai (JavaScript/TypeScript)。
Python 開發原則與決策。框架選擇、非同步模式、型別提示、專案結構。教你思考而非複製。
自動代理選擇與智慧任務路由。分析使用者請求並自動選擇最佳專家代理，無需使用者明確提及。
| name | api-patterns |
| description | API 設計原則與決策。REST vs GraphQL vs tRPC 選擇、回應格式、版本控制、分頁。 |
| allowed-tools | Read, Write, Edit, Glob, Grep |
API 設計原則與 2025 年最佳決策。 學習思考方式，而非複製固定模式。
僅閱讀與需求相關的檔案！ 查看內容地圖，找到你需要的。
| 檔案 | 描述 | 何時閱讀 |
|---|---|---|
api-style.md | REST vs GraphQL vs tRPC 決策樹 | 選擇 API 類型 |
rest.md | 資源命名、HTTP 方法、狀態碼 | 設計 REST API |
response.md | 封裝模式、錯誤格式、分頁 | 回應結構 |
graphql.md | Schema 設計、使用時機、安全性 | 考慮 GraphQL |
trpc.md | TypeScript monorepo、型別安全 | TS 全端專案 |
versioning.md | URI/Header/Query 版本控制 | API 演進規劃 |
auth.md | JWT、OAuth、Passkey、API Keys | 驗證模式選擇 |
rate-limiting.md | Token bucket、滑動視窗 | API 保護 |
documentation.md | OpenAPI/Swagger 最佳實踐 | 文件撰寫 |
security-testing.md | OWASP API Top 10、驗證/授權測試 | 安全稽核 |
| 需求 | 技能 |
|---|---|
| API 實作 | @[skills/backend-development] |
| 資料結構 | @[skills/database-design] |
| 安全細節 | @[skills/security-hardening] |
設計 API 前：
不要：
要：
| 腳本 | 用途 | 指令 |
|---|---|---|
scripts/api_validator.py | API 端點驗證 | python scripts/api_validator.py <project_path> |
