技能 backend-dev-guidelines

⚙️

backend-dev-guidelines

Name: backend-dev-guidelines
Author: BrianDai22

安全 ⚙️ 外部命令🔑 環境變數📁 檔案系統存取🌐 網路存取

Node.js-Backend-Dienste mit Best Practices erstellen

Inkonsistenter Backend-Code verursacht Fehler und verlangsamt die Entwicklung. Dieser Skill bietet Schichtenarchitektur-Muster, BaseController-Vorlagen, Prisma-Repository-Muster, Zod-Validierungsanleitungen und Sentry-Integration für zuverlässige Express-Microservices.

支援: Claude Codex Code(CC)

📊 69 充足

下載技能 ZIP

在 Claude 中上傳

前往設定 → 功能 → 技能 → 上傳技能

開啟並開始使用

測試它

正在使用「backend-dev-guidelines」。 Erstelle eine Route zum Anlegen eines neuen Benutzers

預期結果:

Routendefinition (routes/userRoutes.ts):
- POST /users Route definieren
- SSOMiddlewareClient.verifyLoginStatus anwenden
- An UserController.createUser delegieren
Controller-Methode (controllers/UserController.ts):
- BaseController erweitern
- Eingabe mit createUserSchema.parse(req.body) validieren
- userService.create(validated) aufrufen
- handleSuccess mit Status 201 bei Erfolg verwenden
- handleError mit Sentry-Erfassung bei Fehler verwenden

正在使用「backend-dev-guidelines」。 Validierung zu einem bestehenden API-Endpunkt hinzufügen

預期結果:

Zod-Schema in validators/userSchemas.ts erstellen:
- Eingabestruktur mit Typinferenz definieren
- String-Constraints hinzufügen (E-Mail-Format, Mindestlänge)
- Inferrierten Typ für TypeScript-Verwendung exportieren
Controller aktualisieren:
- Schema importieren und schema.parse(req.body) verwenden
- ZodError mit formatierten Nachrichten behandeln
- 400 bei Validierungsfehler zurückgeben

安全審計

安全

v5 • 1/16/2026

Pure documentation skill containing only markdown files with TypeScript code examples. No executable code, no network calls, no file system access beyond reading its own files, and no environment variable access. Content matches stated purpose of providing backend development guidelines. All 556 static findings are false positives from misidentified template literals and anti-pattern documentation.

已掃描檔案

5,538

分析行數

發現項

審計總數

風險因素

⚙️ 外部命令 (319)

🔑 環境變數 (53)

📁 檔案系統存取 (44)

🌐 網路存取 (6)

resources/configuration.md:182 resources/configuration.md:186 resources/testing-guide.md:191 resources/testing-guide.md:194 skill-report.json:165 skill-report.json:6

審計者: claude 查看審計歷史 →

品質評分

架構

100

可維護性

內容

社群

100

安全

規範符合性

你能建構什麼

Neuer Express-Endpunkt

Erstellen Sie eine saubere Route, die nach dem Schichtenarchitektur-Muster an einen Controller delegiert

Eingabevalidierung hinzufügen

Implementieren Sie typsichere Validierung mit Zod-Schemas und automatischer TypeScript-Typinferenz

Code-Review-Standards

Setzen Sie konsistente Muster über Microservices hinweg mit BaseController und Repository-Mustern durch

試試這些提示

Neuer Endpunkt

Create a route for /users that returns a list of active users. Use the layered architecture pattern with a controller that extends BaseController.

Validierungsschema

Create a Zod schema for a user registration form with email, name, and password fields. Include TypeScript type inference.

Repository-Muster

Create a UserRepository class that uses PrismaService to find users by email and create new users. Include error handling.

Fehlerbehandlung

Show how to properly capture errors in a service method with Sentry, including user context and operation tags.

最佳實務

Halten Sie Routes sauber, indem Sie die gesamte Logik an Controller delegieren
Erweitern Sie BaseController für konsistente Fehlerbehandlung und Sentry-Integration
Verwenden Sie Zod für typsichere Eingabevalidierung mit automatischer TypeScript-Inferenz
Trennen Sie Zuständigkeiten: Routes behandeln Routing, Controller behandeln HTTP, Services behandeln Geschäftslogik, Repositories behandeln Datenzugriff

避免

Geschäftslogik in Route-Handlern - verletzt Separation of Concerns
Direkte process.env-Verwendung statt unifiedConfig
Fehlende Fehlerbehandlung oder Unterdrücken von Fehlern ohne Sentry-Erfassung
Direkte Prisma-Aufrufe in Controllern oder Services - verwenden Sie stattdessen Repositories

常見問題

Funktioniert dieser Skill mit Fastify statt Express?

Die Muster lassen sich mit geringfügigen Anpassungen auf Fastify übertragen. Routes und Controller bleiben ähnlich. Verwenden Sie stattdessen das Fastify-Plugin-System.

Welche Datenbank-ORMs werden unterstützt?

Das primäre Muster verwendet Prisma, aber das Repository-Muster gilt für jedes ORM. Kysely und TypeORM können ähnliche Service- und Repository-Schichten verwenden.

Kann ich dies mit Next.js API-Routes verwenden?

Ja. Das Controller-Muster lässt sich auf API-Route-Handler übertragen. Services und Repositories funktionieren unverändert. Passen Sie BaseController für Next.js Response an.

Sind meine Daten bei der Verwendung dieses Skills sicher?

Ja. Dies ist ein reiner Dokumentations-Skill. Er stellt Code-Beispiele bereit, greift aber niemals auf Ihre Dateien, Umgebungsvariablen zu oder führt Netzwerkanfragen aus.

Warum erhalte ich Typfehler mit dem generierten Code?

Stellen Sie sicher, dass die erforderlichen Abhängigkeiten installiert sind: @sentry/node, @prisma/client, zod und deren TypeScript-Typen. Führen Sie prisma generate nach der Schemadefinition aus.

Wie unterscheidet sich dies von Dokumentations-Websites?

Dieser Skill bietet kontextbezogene Muster, die speziell auf Ihre Codebasis zugeschnitten sind. Er versteht Ihre vorhandenen Muster und generiert konsistenten Code, der zu Ihrer Architektur passt.