Communitygithub.com

Anmolop97/Agent-Skills

掌握 REST 和 GraphQL API 設計原則,打造直觀、可擴展且易於維護的 API,讓開發者愛不釋手。適用於設計新 API、審查 API 規範或建立 API 設計標準。

Agent-Skills 是什麼?

這個技能旨在幫助開發者和 AI 代理掌握 REST 與 GraphQL API 的核心設計原則。它提供了一套結構化指導方針,用於設計直觀、可擴展且易於維護的 API,以滿足開發者需求並經得起時間考驗。該技能支援多種應用場景,包括設計全新 API、重構既有 API、建立團隊標準、審查規格、遷移 API 範式(如從 REST 遷移至 GraphQL)以及建立開發者友善的文件。其工作流程遵循明確的四步驟:首先定義消費者、使用案例與限制;接著選擇 API 風格並建模資源或類型;然後指定錯誤處理、版本控制、分頁與驗證策略;最後透過範例驗證並進行一致性審查。該技能還引用了一份詳細的實作手冊(`resources/implementation-playbook.md`),內含模式、檢查清單與範本,確保設計過程有據可循。請注意,此技能不適用於僅需特定框架實作指引、基礎設施工作不涉及 API 合約,或無法變更/版本化公開介面的情況。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Anmolop97/Agent-Skills/tree/HEAD/skills/api-design-principles

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

API 設計原則

掌握 REST 和 GraphQL API 設計原則,打造直觀、可擴展且易於維護的 API,讓開發者愛不釋手,並經得起時間考驗。

使用此技能的時機

  • 設計新的 REST 或 GraphQL API
  • 重構現有 API 以提升可用性
  • 為團隊建立 API 設計標準
  • 在實作前審查 API 規格
  • 在 API 範式之間遷移(例如 REST 到 GraphQL)
  • 建立開發者友善的 API 文件
  • 針對特定使用案例(行動裝置、第三方整合)最佳化 API

不應使用此技能的時機

  • 你只需要特定框架的實作指引
  • 你只進行基礎設施工作,不涉及 API 合約
  • 你無法變更或對公開介面進行版本控制

指示

  1. 定義消費者、使用案例與限制。
  2. 選擇 API 風格並建模資源或類型。
  3. 指定錯誤處理、版本控制、分頁與驗證策略。
  4. 透過範例驗證並進行一致性審查。

請參閱 resources/implementation-playbook.md 以取得詳細的模式、檢查清單與範本。

資源

  • resources/implementation-playbook.md:包含詳細的模式、檢查清單與範本。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Anmolop97/Agent-Skills

Searches, installs, updates, and lists skills from the Antigravity Skill Vault. Use when choosing or managing workspace or global skills through the npm CLI.

Anmolop97/Agent-Skills

Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.

Anmolop97/Agent-Skills

Reference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIR...

Anmolop97/Agent-Skills

Searches, installs, updates, and lists skills from the Antigravity Skill Vault. Use when choosing or managing workspace or global skills through the npm CLI.

相關技能