القائمة
API tasarımı, GraphQL schema, OpenAPI spec, versioning. ⚠️ Tasarım aşaması için kullan. Uygulama/security için → backend-api.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/vuralserhat86/antigravity-agentic-skills --skill api-designيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Guide for conducting comprehensive accessibility audits of code to identify WCAG compliance issues and barriers to inclusive design. This skill should be used when reviewing accessibility, ARIA implementation, keyboard navigation, or screen reader compatibility.
Transform clarified user requests into structured delegation prompts optimized for specialist agents (cto-architect, strategic-cto-mentor, cv-ml-architect). Use after clarification is complete, before routing to specialist agents. Ensures agents receive complete context for effective work.
AGENTS.md dosyaları oluşturma, monorepo yapılandırma ve agent instruction yönetimi rehberi.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | api_design |
| description | API tasarımı, GraphQL schema, OpenAPI spec, versioning. ⚠️ Tasarım aşaması için kullan. Uygulama/security için → backend-api. |
RESTful ve GraphQL API tasarımı rehberi.
GET(read) · POST(create) · PUT(full-update) · PATCH(partial) · DELETE
2xx Success · 4xx Client Error · 5xx Server Error
| Code | Kullanım |
|---|---|
| 200/201/204 | OK/Created/No Content |
| 400/401/403/404/422 | Bad/Unauth/Forbidden/NotFound/Validation |
| 500/503 | Server Error/Unavailable |
Pattern: /api/v{n}/{resource}/{id?}/{sub-resource?}
✅ GET /api/v1/users
✅ GET /api/v1/users/{id}
✅ POST /api/v1/users
❌ GET /api/v1/getUsers (verb kullanma!)
?page=1&limit=20 · ?status=active · ?sort=createdAt&order=desc · ?fields=id,name
// Success
{ success: true, data: T, meta?: { page, total } }
// Error
{ success: false, error: { code: string, message: string, details?: [] } }
| Yöntem | Örnek | Öneri |
|---|---|---|
| URL (önerilen) | /api/v1/users | ✅ En yaygın |
| Header | Accept: ...version=1 | Opsiyonel |
| Query | ?version=1 | Kaçın |
type Query {
user(id: ID!): User
users(filter: Filter, pagination: Pagination): UserConnection!
}
type Mutation {
createUser(input: CreateUserInput!): UserPayload!
}
N+1 Çözümü: DataLoader, Batch loading, Query complexity limiting
openapi: 3.0.3
info: { title: API, version: 1.0.0 }
paths:
/users:
get:
responses:
'200': { $ref: '#/components/schemas/UserList' }
API Design v2.0 - Compact
openapi.yaml or schema.graphql BEFORE coding.| Aşama | Doğrulama |
|---|---|
| 1 | OpenAPI spec onaylandı (lint geçerli) |
| 2 | Kod ve Spec tipleri senkronize (codegen) |
| 3 | Contract testleri geçiyor |
| 4 | Dokümantasyon canlı ve güncel |