Compétences add-endpoint
🔗

add-endpoint

Sûr 🌐 Accès réseau📁 Accès au système de fichiers⚙️ Commandes externes

Catalyst-RelayサーバーへのHTTPエンドポイントの追加

Catalyst-Relayサーバーに新しいAPIルートを追加したいが、正しいパターンがわからないですか？このスキルは、Zodバリデーション、一貫したレスポンスタイプ、適切なドキュメントを備えたエンドポイントを作成するための完全なテンプレートを提供します。

Prend en charge: Claude Codex Code(CC)
📊 71 Adéquat
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "add-endpoint". src/server/routes/preview/data.tsにデータプレビュー用のPOSTエンドポイントを作成

Résultat attendu:

  • リクエストバリデーション用のZodスキーマを持つルートファイルを作成
  • 型付きレスポンス用のDataPreviewResponseインターフェースを追加
  • ファクトリパターンを使用してdataPreviewHandlerを実装
  • リテラルタイプを使用した一貫した成功/エラーレスポンスエンベロープを使用
  • routes/index.tsでの接続準備完了

Utilisation de "add-endpoint". src/server/routes/packages/list.tsにパッケージ一覧取得のGETエンドポイントを追加

Résultat attendu:

  • PackageListResponseインターフェースを持つルートファイルを作成
  • ページネーションサポート付きのlistPackagesHandlerを実装
  • Zodでのクエリパラメータバリデーションを追加
  • 型安全レスポンスのためのsuccessをconstとして使用
  • index.tsでの登録準備完了

Audit de sécurité

Sûr
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
Fichiers analysés
314
Lignes analysées
3
résultats
5
Total des audits

Facteurs de risque

🌐 Accès réseau (1)
skill-report.json:6
📁 Accès au système de fichiers (2)
skill-report.json:6 SKILL.md:25
⚙️ Commandes externes (20)
SKILL.md:18 SKILL.md:20-60 SKILL.md:60-64 SKILL.md:64-66 SKILL.md:66-75 SKILL.md:75-81 SKILL.md:81-91 SKILL.md:91-93 SKILL.md:93-97 SKILL.md:97-101 SKILL.md:101 SKILL.md:101-102 SKILL.md:102 SKILL.md:102-103 SKILL.md:103 SKILL.md:103-107 SKILL.md:107-112 SKILL.md:112-123 SKILL.md:123-127 SKILL.md:127-136
Audité par: claude Voir l’historique des audits →

Score de qualité

38
Architecture
100
Maintenabilité
85
Contenu
31
Communauté
100
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

新しいAPIエンドポイントの追加

適切なバリデーションとエラー処理を備えたCatalyst-Relayの認証付きRESTエンドポイントの作成

サーバー機能の拡張

Catalyst-Relayの中核機能をHTTP APIを介して公開するための新しいルートの追加

ADT APIラッパーの構築

フロントエンド統合用のカスタムHTTPエンドポイントでSAP ADT操作をラップする

Essayez ces prompts

シンプルエンドポイントの作成 
 uptimeとメモリ使用量を返すsrc/server/routes/health/check.tsに新しいGETエンドポイントを作成
POSTエンドポイントの追加 
検索フィルターを受け付け、一致するユーザーレコードを返すsrc/server/routes/users/search.tsにPOSTエンドポイントを追加
CRUD操作の作成 
src/server/routes/transports/にトランスポートリクエスト管理の完全なCRUDエンドポイントを作成（作成、読取、更新、削除の各操作を含む）
ルートをアプリに接続 
新しい/transports/createエンドポイントをsrc/server/routes/index.tsにセッション認証ミドルウェアとともに登録

Bonnes pratiques

  • ファクトリパターンを使用：依存関係を受け取るハンドラ関数をエクスポート
  • リクエストスキーマとレスポンスタイプを同じファイルに配置して共存
  • 判別可能な共用体型を保持するためにsuccessとfalseリテラルにas constを使用

Éviter

  • 単一ファイルに複数のハンドラを配置することは避ける
  • リクエストボディのZodスキーマバリデーションをスキップしない
  • エラーコードをハードコードしない - エラーレスポンスパターンを使用

Foire aux questions

新しいルートファイルはどのディレクトリに作成すればよいですか？
新しいルートファイルはsrc/server/routes/{カテゴリ}/{エンドポイント}.tsに作成します（例：auth/login.tsやpreview/data.ts）
どのバリデーションライブラリが使用されていますか？
ZodはsafeParse()を使用した型安全なパースとエラー処理によるリクエストバリデーションに使用されます
ルートはどのように登録されますか？
ルートはsrc/server/routes/index.tsでapp.post()、app.get()などを使用し、ハンドラファクトリとともに登録します
エンドポイントには認証が必要ですか？
エンドポイントはファクトリパターンを通じてsessionManagerを受け取ります。認証要件はルート設定によって異なります
どのようなレスポンスタイプが要求されますか？
{ success: true|false as const, data?: result, error?: message, code?: string }エンベロープをHTTPステータスコードとともに使用します
ExpressやFastifyとは何が違うのですか？
Catalyst-Relayは、組み込みのTypeScriptサポートとミドルウェア構成を備えた軽量WebフレームワークであるHonoを使用しています

Détails du développeur

Licence

MIT

Dépôt

https://github.com/Artisan-Edge/Catalyst-Relay/tree/main/.claude/skills/add-endpoint

Réf

main

Structure de fichiers

📄 SKILL.md