スキル add-endpoint
🔗

add-endpoint

安全 🌐 ネットワークアクセス📁 ファイルシステムへのアクセス⚙️ 外部コマンド

HTTP-Endpunkte zum Catalyst-Relay-Server hinzufügen

Möchten Sie neue API-Routen zu Ihrem Catalyst-Relay-Server hinzufügen, sind sich aber nicht sicher, welches Muster Sie verwenden sollen? Diese Skill-Vorlage bietet das vollständige Template für die Erstellung von Endpunkten mit Zod-Validierung, konsistenten Antwortformaten und richtiger Dokumentation.

対応: Claude Codex Code(CC)
📊 69 十分
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「add-endpoint」を使用しています。 Create a POST endpoint for previewing data at src/server/routes/preview/data.ts

期待される結果:

  • Created route file with Zod schema for request validation
  • Added DataPreviewResponse interface for typed responses
  • Implemented dataPreviewHandler using factory pattern
  • Used consistent success/error envelope with literal types
  • Ready to wire in routes/index.ts

「add-endpoint」を使用しています。 Add a GET endpoint for listing packages at src/server/routes/packages/list.ts

期待される結果:

  • Created route file with PackageListResponse interface
  • Implemented listPackagesHandler with pagination support
  • Added query parameter validation with Zod
  • Used success as const for type-safe responses
  • Route ready for registration in index.ts

セキュリティ監査

安全
v5 • 1/16/2026

This is a documentation-only skill containing a SKILL.md file with guidance for generating API endpoint code. No executable code, no file system access beyond reading its own file, no network calls, and no command execution capabilities. Pure prompt-based skill with zero attack surface. All 38 static findings are false positives caused by the analyzer misinterpreting documentation patterns (code examples as Ruby execution, Zod schemas as crypto, template placeholders as path traversal).

2
スキャンされたファイル
314
解析された行数
3
検出結果
5
総監査数
監査者: claude 監査履歴を表示 →

品質スコア

38
アーキテクチャ
100
保守性
85
コンテンツ
20
コミュニティ
100
セキュリティ
91
仕様準拠

作れるもの

Neue API-Endpunkte hinzufügen

Erstellen Sie authentifizierte REST-Endpunkte für Catalyst-Relay mit richtiger Validierung und Fehlerbehandlung

Serverfunktionalität erweitern

Neue Routen hinzufügen, um Catalyst-Relay-Kernfunktionen über die HTTP-API bereitzustellen

ADT-API-Wrapper erstellen

SAP ADT-Operationen mit benutzerdefinierten HTTP-Endpunkten für die Frontend-Integration umschließen

これらのプロンプトを試す

Einfachen Endpunkt erstellen
Create a new endpoint at src/server/routes/health/check.ts that returns server status with uptime and memory usage
POST-Endpunkt hinzufügen
Add a POST endpoint at src/server/routes/users/search.ts that accepts search filters and returns matching user records
CRUD-Operationen erstellen
Create full CRUD endpoints for managing transport requests at src/server/routes/transports/ with create, read, update, and delete operations
Route an App anbinden
Register the new /transports/create endpoint in src/server/routes/index.ts with session authentication middleware

ベストプラクティス

  • Verwenden Sie das Factory-Muster: Exportieren Sie eine Handler-Funktion, die Abhängigkeiten akzeptiert
  • Platzieren Sie Request-Schema und Antworttypen in derselben Datei für Co-Location
  • Verwenden Sie as const für Success- und Error-Literale, um diskriminierte Union-Typen zu erhalten

回避

  • Vermeiden Sie es, mehrere Handler in einer einzelnen Datei zu platzieren
  • Überspringen Sie nicht die Zod-Schema-Validierung für Request-Bodies
  • Hardcodieren Sie niemals Fehlercodes - verwenden Sie das Error-Envelope-Muster

よくある質問

Wo sollten neue Route-Dateien erstellt werden?
Erstellen Sie Route-Dateien in src/server/routes/{category}/{endpoint}.ts, z.B. auth/login.ts oder preview/data.ts
Welche Validierungsbibliothek wird verwendet?
Zod wird für Request-Validierung mit safeParse() für typsichere Analyse und Fehlerbehandlung verwendet
Wie werden Routen registriert?
Routen werden in src/server/routes/index.ts mit app.post(), app.get() usw. unter Verwendung des Handler-Factories registriert
Ist für Endpunkte eine Authentifizierung erforderlich?
Endpunkte erhalten sessionManager über das Factory-Muster. Authentifizierungsanforderungen hängen von der Routenkonfiguration ab
Welches Antwortformat ist erforderlich?
Verwenden Sie { success: true|false as const, data?: result, error?: message, code?: string } Envelope mit HTTP-Statuscodes
Wie unterscheidet sich dies von Express oder Fastify?
Catalyst-Relay verwendet Hono, ein leichtgewichtiges Web-Framework mit integrierter TypeScript-Unterstützung und Middleware-Komposition

開発者の詳細

ファイル構成

📄 SKILL.md