phase-4-api
Skill for designing and implementing backend APIs. Includes Zero Script QA methodology for API validation. Use proactively when user needs to design or implement backend APIs. Triggers: API design, REST API, backend, endpoint, API 설계, 백엔드, 엔드포인트, API設計, バックエンド, API设计, 后端, diseño de API, backend, conception API, backend, API-Design, Backend, progettazione API, backend Do NOT use for: frontend-only projects, Starter level
来源信息
- 仓库
- ww-w-ai/bkit-gemini
- 最近来源活动
- 2026年3月11日 04:41
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 66
- 分支
- 16
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- phase-4-api
- classification
- C
- description
- Skill for designing and implementing backend APIs. Includes Zero Script QA methodology for API validation. Use proactively when user needs to design or implement backend APIs. Triggers: API design, REST API, backend, endpoint, API 설계, 백엔드, 엔드포인트, API設計, バックエンド, API设计, 后端, diseño de API, backend, conception API, backend, API-Design, Backend, progettazione API, backend Do NOT use for: frontend-only projects, Starter level
- user-invocable
- true
- argument-hint
- allowed-tools
- ["read_file","write_file","replace","glob","grep_search","run_shell_command"]
- imports
- ["templates/design.template.md"]
- agents
- {}
- context
- session
- memory
- project
- pdca-phase
- do
# Phase 4: API Design & Implementation
> Build robust backend APIs
## Deliverables
### 1. API Specification
OpenAPI/Swagger format:
```yaml
openapi: 3.0.0
info:
title: User API
version: 1.0.0
paths:
/api/users:
get:
summary: List users
responses:
'200':
description: User list
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/User'
post:
summary: Create user
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateUser'
```
### 2. Endpoint Implementation
```typescript
// app/api/users/route.ts
import { NextRequest, NextResponse } from 'next/server';
export async function GET(request: NextRequest) {
const users = await db.user.findMany();
return NextResponse.json(users);
}
export async function POST(request: NextRequest) {
const body = await request.json();
const user = await db.user.create({ data: body });
return NextResponse.json(user, { status: 201 });
}
```
### 3. Error Handling
```typescript
// Standard error response
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid email format",
"details": [
{ "field": "email", "message": "Must be a valid email" }
]
}
}
```
## API Patterns
- RESTful resource naming
- Consistent response format
- Proper HTTP status codes
- Input validation
- Rate limiting
## Output
Save to: `docs/02-design/api-spec.yaml`
## Next Phase
After completion: `/phase-5-design-system` or `/phase-6-ui-integration`
在 GitHub 查看