add-endpoint
إضافة نقاط نهاية HTTP إلى خادم Catalyst-Relay
هل تحتاج إلى إضافة مسارات API جديدة إلى خادم Catalyst-Relay ولكن غير متأكد من النمط الصحيح؟ توفر هذه المهارة القالب الكامل لإنشاء نقاط نهاية مع التحقق من صحة Zod، وتنسيقات استجابة متسقة، والتوثيق المناسب.
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“add-endpoint”。 إنشاء نقطة نهاية POST للمعاينة في 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”。 إضافة نقطة نهاية GET لإدراج الحزم في 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
安全审计
安全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).
风险因素
🌐 网络访问 (1)
📁 文件系统访问 (2)
⚙️ 外部命令 (20)
质量评分
你能构建什么
إضافة نقاط نهاية API جديدة
إنشاء نقاط نهاية REST المصادقة لـ Catalyst-Relay مع التحقق من صحة مناسب ومعالجة الأخطاء
توسيع وظائف الخادم
إضافة مسارات جديدة لتعرض وظائف Catalyst-Relay الأساسية عبر HTTP API
بناء أغلفة ADT API
لف عمليات SAP ADT مع نقاط نهاية HTTP مخصصة لدمج الواجهة الأمامية
试试这些提示
إنشاء نقطة نهاية جديدة في src/server/routes/health/check.ts تُرجع حالة الخادم مع وقت التشغيل واستخدام الذاكرة
إضافة نقطة نهاية POST في src/server/routes/users/search.ts تقبل فلاتر البحث وتُرجع سجلات المستخدمين المطابقة
إنشاء نقاط نهاية CRUD كاملة لإدارة طلبات النقل في src/server/routes/transports/ مع عمليات الإنشاء والقراءة والتحديث والحذف
تسجيل نقطة النهاية الجديدة /transports/create في src/server/routes/index.ts مع برنامج وسيط المصادقة
最佳实践
- استخدم نمط المصنع:صدّر وظيفة معالج تقبل التبعيات
- ضع مخطط الطلب وأنواع الاستجابة في نفس الملف للتجميع
- استخدم as const لنجاح وحروف الخطأ للحفاظ على أنواع الاتحاد المميزة
避免
- تجنب وضع معالجات متعددة في ملف واحد
- لا تتخطى التحقق من صحة Zod لأجسام الطلبات
- لا تقوم أبداً بتكويد رموز الأخطاء الثابتة - استخدم نمط مغلف الأخطاء