一键在 Manus 中运行任何 Skill

开始使用

api-patterns

星标2

分支0

更新时间2026年5月9日 05:05

API 設計原則與決策。REST vs GraphQL vs tRPC 選擇、回應格式、版本控制、分頁。

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

Tai-ch0802

Tai-ch0802/skills-bundle

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

API 模式

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 前：

是否詢問過使用者 API 的消費者？
是否根據此情境選擇了 API 風格？（REST/GraphQL/tRPC）
是否定義了一致的回應格式？
是否規劃了版本控制策略？
是否考慮了驗證需求？
是否規劃了速率限制？
是否定義了文件方法？

❌ 反模式

不要：

所有情況預設使用 REST
在 REST 端點中使用動詞（/getUsers）
回傳不一致的回應格式
將內部錯誤暴露給客戶端
跳過速率限制

要：

根據情境選擇 API 風格
詢問客戶端需求
撰寫完整文件
使用適當的狀態碼

腳本

腳本	用途	指令
`scripts/api_validator.py`	API 端點驗證	`python scripts/api_validator.py <project_path>`

同仓库更多 Skills

同仓库

claude-api

Tai-ch0802/skills-bundle

使用 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`，與提供者無關的程式碼，一般程式設計/機器學習。

2026-05-092

gemini-interactions-api

Tai-ch0802/skills-bundle

當編寫呼叫 Gemini API 的程式碼時請使用此技能，用於文字生成、多輪對話、多模態理解、影像生成、串流回應、背景研究任務、函式呼叫、結構化輸出，或從舊的 generateContent API 遷移。此技能涵蓋 Interactions API，這是在 Python 與 TypeScript 中使用 Gemini 模型與代理的建議方式。

2026-05-092

tailwind-patterns

Tai-ch0802/skills-bundle

Tailwind CSS v4 原則。CSS 優先配置、容器查詢、現代模式、設計 token 架構。

2026-05-092

gemini-live-api-dev

Tai-ch0802/skills-bundle

處理使用 Gemini Live API 的即時、雙向串流應用程式時使用此技能。涵蓋基於 WebSocket 的音訊/視訊/文字串流、語音活動偵測 (VAD)、原生音訊功能、函式呼叫、會話管理、用戶端身分驗證的臨時權杖，以及所有 Live API 設定選項。涵蓋的 SDK - google-genai (Python)、@google/genai (JavaScript/TypeScript)。

2026-05-092

python-patterns

Tai-ch0802/skills-bundle

Python 開發原則與決策。框架選擇、非同步模式、型別提示、專案結構。教你思考而非複製。

2026-05-092

intelligent-routing

Tai-ch0802/skills-bundle

自動代理選擇與智慧任務路由。分析使用者請求並自動選擇最佳專家代理，無需使用者明確提及。

2026-05-092

name	api-patterns
description	API 設計原則與決策。REST vs GraphQL vs tRPC 選擇、回應格式、版本控制、分頁。
allowed-tools	Read, Write, Edit, Glob, Grep

API 模式

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 前：

是否詢問過使用者 API 的消費者？
是否根據此情境選擇了 API 風格？（REST/GraphQL/tRPC）
是否定義了一致的回應格式？
是否規劃了版本控制策略？
是否考慮了驗證需求？
是否規劃了速率限制？
是否定義了文件方法？

❌ 反模式

不要：

所有情況預設使用 REST
在 REST 端點中使用動詞（/getUsers）
回傳不一致的回應格式
將內部錯誤暴露給客戶端
跳過速率限制

要：

根據情境選擇 API 風格
詢問客戶端需求
撰寫完整文件
使用適當的狀態碼

腳本

腳本	用途	指令
`scripts/api_validator.py`	API 端點驗證	`python scripts/api_validator.py <project_path>`