المهارات backend-dev-guidelines
⚙️
backend-dev-guidelines
آمن ⚙️
الأوامر الخارجية🔑
متغيرات البيئة📁
الوصول إلى نظام الملفات🌐
الوصول إلى الشبكة
ベストプラクティスでNode.jsバックエンドサービスを構築する
متاح أيضًا من: diet103,Dimon94,DojoCodingLabs,sickn33
一貫性のないバックエンドコードはバグを引き起こし、開発を遅らせます。このスキルはレイヤーアーキテクチャパターン、BaseControllerテンプレート、Prismaリポジトリパターン、Zodバリデーションガイド、Sentry統合を提供し、信頼性の高いExpressマイクロサービスを実現します。
يدعم: Claude Codex Code(CC)
1
تنزيل ZIP المهارة
2
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
3
فعّل وابدأ الاستخدام
اختبرها
استخدام "backend-dev-guidelines". 新規ユーザー作成ルートを作成する
النتيجة المتوقعة:
- ルート定義 (routes/userRoutes.ts):
- - POST /users ルートを定義
- - SSOMiddlewareClient.verifyLoginStatus を適用
- - UserController.createUser に委ねる
- コントローラメソッド (controllers/UserController.ts):
- - BaseController を拡張
- - createUserSchema.parse(req.body) で入力をバリデーション
- - userService.create(validated) を呼び出す
- - 成功時に handleSuccess で201ステータスを返す
- - 失敗時に Sentry capture で handleError を使用
استخدام "backend-dev-guidelines". 既存のAPIエンドポイントにバリデーションを追加する
النتيجة المتوقعة:
- validators/userSchemas.ts にZodスキーマを作成:
- - 型推論を使用した入力形状を定義
- - 文字列制約を追加（メール形式、最小長）
- - TypeScript使用のために推論型をエクスポート
- コントローラを更新:
- - schema.parse(req.body) をインポートして使用
- - ZodError をフォーマットされたメッセージで処理
- - バリデーション失敗時に400を返す
التدقيق الأمني
آمن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.
13
الملفات التي تم فحصها
5,538
الأسطر التي تم تحليلها
4
النتائج
5
إجمالي عمليات التدقيق
عوامل الخطر
⚙️ الأوامر الخارجية (319)
resources/architecture-overview.md:20-61 resources/architecture-overview.md:61-91 resources/architecture-overview.md:91-120 resources/architecture-overview.md:120-126 resources/architecture-overview.md:126-136 resources/architecture-overview.md:136-155 resources/architecture-overview.md:155-170 resources/architecture-overview.md:170-189 resources/architecture-overview.md:189-204 resources/architecture-overview.md:204-218 resources/architecture-overview.md:218-219 resources/architecture-overview.md:219-236 resources/architecture-overview.md:236-252 resources/architecture-overview.md:252-270 resources/architecture-overview.md:270-303 resources/architecture-overview.md:303-313 resources/architecture-overview.md:313-326 resources/architecture-overview.md:326-334 resources/architecture-overview.md:334-345 resources/architecture-overview.md:345-351 resources/architecture-overview.md:351-400 resources/architecture-overview.md:400-406 resources/architecture-overview.md:406-409 resources/architecture-overview.md:409-419 resources/architecture-overview.md:419-422 resources/architecture-overview.md:422-431 resources/architecture-overview.md:431-434 resources/architecture-overview.md:434-442 resources/async-and-errors.md:20-37 resources/async-and-errors.md:37-41 resources/async-and-errors.md:41-63 resources/async-and-errors.md:63-71 resources/async-and-errors.md:71-99 resources/async-and-errors.md:99-107 resources/async-and-errors.md:107-146 resources/async-and-errors.md:146-150 resources/async-and-errors.md:150-175 resources/async-and-errors.md:175-183 resources/async-and-errors.md:183-195 resources/async-and-errors.md:195-199 resources/async-and-errors.md:199-211 resources/async-and-errors.md:211-219 resources/async-and-errors.md:219-247 resources/async-and-errors.md:247-255 resources/async-and-errors.md:255-280 resources/async-and-errors.md:280-284 resources/async-and-errors.md:284-300 resources/complete-examples.md:20-120 resources/complete-examples.md:120-128 resources/complete-examples.md:128-201 resources/complete-examples.md:201-209 resources/complete-examples.md:209-255 resources/complete-examples.md:255-263 resources/complete-examples.md:263-317 resources/complete-examples.md:317-325 resources/complete-examples.md:325-359 resources/complete-examples.md:359-364 resources/complete-examples.md:364-379 resources/complete-examples.md:379-382 resources/complete-examples.md:382-409 resources/complete-examples.md:409-412 resources/complete-examples.md:412-453 resources/complete-examples.md:453-468 resources/complete-examples.md:468-489 resources/complete-examples.md:489-492 resources/complete-examples.md:492-508 resources/complete-examples.md:508-511 resources/complete-examples.md:511-528 resources/complete-examples.md:528-531 resources/complete-examples.md:531-558 resources/complete-examples.md:558-561 resources/complete-examples.md:561-581 resources/complete-examples.md:581-584 resources/complete-examples.md:584-595 resources/complete-examples.md:595-598 resources/complete-examples.md:598-603 resources/complete-examples.md:603-606 resources/complete-examples.md:606-630 resources/configuration.md:42-51 resources/configuration.md:51-56 resources/configuration.md:56-63 resources/configuration.md:63-66 resources/configuration.md:66-69 resources/configuration.md:69-77 resources/configuration.md:77-114 resources/configuration.md:114-118 resources/configuration.md:118-120 resources/configuration.md:120-147 resources/configuration.md:147-162 resources/configuration.md:162-189 resources/configuration.md:189-193 resources/configuration.md:193-198 resources/configuration.md:198-211 resources/configuration.md:211-218 resources/configuration.md:218-222 resources/configuration.md:222-234 resources/configuration.md:234-242 resources/configuration.md:242-244 resources/configuration.md:244-249 resources/configuration.md:249-254 resources/configuration.md:254-257 resources/configuration.md:257-263 resources/database-patterns.md:20-25 resources/database-patterns.md:25-29 resources/database-patterns.md:29-35 resources/database-patterns.md:35-55 resources/database-patterns.md:55-75 resources/database-patterns.md:75-83 resources/database-patterns.md:83-89 resources/database-patterns.md:89-93 resources/database-patterns.md:93-109 resources/database-patterns.md:109-117 resources/database-patterns.md:117-129 resources/database-patterns.md:129-133 resources/database-patterns.md:133-149 resources/database-patterns.md:149-157 resources/database-patterns.md:157-167 resources/database-patterns.md:167-171 resources/database-patterns.md:171-182 resources/database-patterns.md:182-190 resources/database-patterns.md:190-217 resources/middleware-guide.md:20 resources/middleware-guide.md:22-41 resources/middleware-guide.md:41-49 resources/middleware-guide.md:49-51 resources/middleware-guide.md:51-83 resources/middleware-guide.md:83-92 resources/middleware-guide.md:92-99 resources/middleware-guide.md:99-107 resources/middleware-guide.md:107-109 resources/middleware-guide.md:109-153 resources/middleware-guide.md:153-161 resources/middleware-guide.md:161-174 resources/middleware-guide.md:174-182 resources/middleware-guide.md:182-204 resources/routing-and-controllers.md:35-65 resources/routing-and-controllers.md:65-89 resources/routing-and-controllers.md:89-91 resources/routing-and-controllers.md:91-171 resources/routing-and-controllers.md:171-226 resources/routing-and-controllers.md:226-230 resources/routing-and-controllers.md:230-294 resources/routing-and-controllers.md:294-309 resources/routing-and-controllers.md:309-311 resources/routing-and-controllers.md:311-336 resources/routing-and-controllers.md:336-346 resources/routing-and-controllers.md:346-348 resources/routing-and-controllers.md:348-370 resources/routing-and-controllers.md:370-388 resources/routing-and-controllers.md:388-390 resources/routing-and-controllers.md:390-440 resources/routing-and-controllers.md:440-454 resources/routing-and-controllers.md:454-481 resources/routing-and-controllers.md:481-485 resources/routing-and-controllers.md:485-525 resources/routing-and-controllers.md:525-529 resources/routing-and-controllers.md:529-542 resources/routing-and-controllers.md:542-556 resources/routing-and-controllers.md:556-569 resources/routing-and-controllers.md:569-573 resources/routing-and-controllers.md:573-593 resources/routing-and-controllers.md:593-597 resources/routing-and-controllers.md:597-611 resources/routing-and-controllers.md:611-634 resources/routing-and-controllers.md:634-649 resources/routing-and-controllers.md:649-665 resources/routing-and-controllers.md:665-671 resources/routing-and-controllers.md:671-676 resources/routing-and-controllers.md:676-698 resources/routing-and-controllers.md:698-701 resources/routing-and-controllers.md:701-723 resources/routing-and-controllers.md:723-726 resources/routing-and-controllers.md:726-749 resources/sentry-and-monitoring.md:29 resources/sentry-and-monitoring.md:33-105 resources/sentry-and-monitoring.md:105-120 resources/sentry-and-monitoring.md:120-135 resources/sentry-and-monitoring.md:135-139 resources/sentry-and-monitoring.md:139-153 resources/sentry-and-monitoring.md:153-157 resources/sentry-and-monitoring.md:157-173 resources/sentry-and-monitoring.md:173-181 resources/sentry-and-monitoring.md:181-191 resources/sentry-and-monitoring.md:191-195 resources/sentry-and-monitoring.md:195-209 resources/sentry-and-monitoring.md:209-217 resources/sentry-and-monitoring.md:217-253 resources/sentry-and-monitoring.md:253-261 resources/sentry-and-monitoring.md:261-292 resources/sentry-and-monitoring.md:292-298 resources/sentry-and-monitoring.md:298-329 resources/services-and-repositories.md:23-27 resources/services-and-repositories.md:27-57 resources/services-and-repositories.md:57-59 resources/services-and-repositories.md:59-200 resources/services-and-repositories.md:200-204 resources/services-and-repositories.md:204-218 resources/services-and-repositories.md:218-242 resources/services-and-repositories.md:242-244 resources/services-and-repositories.md:244-270 resources/services-and-repositories.md:270-317 resources/services-and-repositories.md:317-333 resources/services-and-repositories.md:333-337 resources/services-and-repositories.md:337-346 resources/services-and-repositories.md:346-356 resources/services-and-repositories.md:356-359 resources/services-and-repositories.md:359-375 resources/services-and-repositories.md:375-400 resources/services-and-repositories.md:400-435 resources/services-and-repositories.md:435-462 resources/services-and-repositories.md:462-477 resources/services-and-repositories.md:477-499 resources/services-and-repositories.md:499-503 resources/services-and-repositories.md:503-523 resources/services-and-repositories.md:523-542 resources/services-and-repositories.md:542-548 resources/services-and-repositories.md:548-558 resources/services-and-repositories.md:558-578 resources/services-and-repositories.md:578-584 resources/services-and-repositories.md:584-596 resources/services-and-repositories.md:596-602 resources/services-and-repositories.md:602-610 resources/services-and-repositories.md:610-616 resources/services-and-repositories.md:616-619 resources/services-and-repositories.md:619-630 resources/services-and-repositories.md:630-636 resources/services-and-repositories.md:636-664 resources/services-and-repositories.md:664-672 resources/services-and-repositories.md:672-699 resources/services-and-repositories.md:699-703 resources/services-and-repositories.md:703-715 resources/services-and-repositories.md:715-723 resources/services-and-repositories.md:723-781 resources/testing-guide.md:20-73 resources/testing-guide.md:73-81 resources/testing-guide.md:81-108 resources/testing-guide.md:108-116 resources/testing-guide.md:116-130 resources/testing-guide.md:130-134 resources/testing-guide.md:134-140 resources/testing-guide.md:140-148 resources/testing-guide.md:148-181 resources/testing-guide.md:181-189 resources/testing-guide.md:189-195 resources/testing-guide.md:195-199 resources/testing-guide.md:199-212 resources/testing-guide.md:212-226 resources/testing-guide.md:226-228 resources/validation-patterns.md:41-53 resources/validation-patterns.md:53-61 resources/validation-patterns.md:61-87 resources/validation-patterns.md:87-91 resources/validation-patterns.md:91-123 resources/validation-patterns.md:123-127 resources/validation-patterns.md:127-143 resources/validation-patterns.md:143-151 resources/validation-patterns.md:151-153 resources/validation-patterns.md:153-250 resources/validation-patterns.md:250-254 resources/validation-patterns.md:254-271 resources/validation-patterns.md:271-275 resources/validation-patterns.md:275-290 resources/validation-patterns.md:290-298 resources/validation-patterns.md:298-335 resources/validation-patterns.md:335-352 resources/validation-patterns.md:352-372 resources/validation-patterns.md:372-374 resources/validation-patterns.md:374-425 resources/validation-patterns.md:425-442 resources/validation-patterns.md:442-470 resources/validation-patterns.md:470-474 resources/validation-patterns.md:474-493 resources/validation-patterns.md:493-501 resources/validation-patterns.md:501-518 resources/validation-patterns.md:518-522 resources/validation-patterns.md:522-528 resources/validation-patterns.md:528-532 resources/validation-patterns.md:532-569 resources/validation-patterns.md:569-577 resources/validation-patterns.md:577-595 resources/validation-patterns.md:595-599 resources/validation-patterns.md:599-611 resources/validation-patterns.md:611-615 resources/validation-patterns.md:615-627 resources/validation-patterns.md:627-631 resources/validation-patterns.md:631-648 resources/validation-patterns.md:648-652 resources/validation-patterns.md:652-667 resources/validation-patterns.md:667-671 resources/validation-patterns.md:671-708 resources/validation-patterns.md:708-712 resources/validation-patterns.md:712-746 SKILL.md:55-67 SKILL.md:67-77 SKILL.md:77-92 SKILL.md:92-95 SKILL.md:95 SKILL.md:95-96 SKILL.md:96 SKILL.md:96-97 SKILL.md:97 SKILL.md:97-98 SKILL.md:98 SKILL.md:98-106 SKILL.md:106-114 SKILL.md:114-118 SKILL.md:118-129 SKILL.md:129-133 SKILL.md:133-140 SKILL.md:140-144 SKILL.md:144-151 SKILL.md:151-155 SKILL.md:155-158 SKILL.md:158-162 SKILL.md:162-165 SKILL.md:165-169 SKILL.md:169-175 SKILL.md:175-181 SKILL.md:181-201
🔑 متغيرات البيئة (53)
resources/architecture-overview.md:185 resources/architecture-overview.md:207 resources/configuration.md:44 resources/configuration.md:45 resources/configuration.md:58 resources/configuration.md:61 resources/configuration.md:62 resources/configuration.md:130 resources/configuration.md:131 resources/configuration.md:132 resources/configuration.md:133 resources/configuration.md:134 resources/configuration.md:137 resources/configuration.md:138 resources/configuration.md:228 resources/configuration.md:231 resources/configuration.md:251 resources/configuration.md:252 resources/configuration.md:253 resources/configuration.md:8 resources/configuration.md:20 resources/configuration.md:38 resources/configuration.md:44 resources/configuration.md:45 resources/configuration.md:58 resources/configuration.md:61 resources/configuration.md:62 resources/configuration.md:130 resources/configuration.md:131 resources/configuration.md:132 resources/configuration.md:133 resources/configuration.md:134 resources/configuration.md:137 resources/configuration.md:138 resources/configuration.md:151 resources/configuration.md:202 resources/configuration.md:228 resources/configuration.md:231 resources/configuration.md:240 resources/configuration.md:243 resources/configuration.md:251 resources/configuration.md:252 resources/configuration.md:253 resources/configuration.md:133 resources/configuration.md:196 resources/configuration.md:228 resources/sentry-and-monitoring.md:44 resources/sentry-and-monitoring.md:44 skill-report.json:146 SKILL.md:146 SKILL.md:142 SKILL.md:146 SKILL.md:229
📁 الوصول إلى نظام الملفات (44)
resources/complete-examples.md:24 resources/complete-examples.md:25 resources/complete-examples.md:130 resources/complete-examples.md:131 resources/complete-examples.md:132 resources/complete-examples.md:212 resources/complete-examples.md:213 resources/complete-examples.md:214 resources/complete-examples.md:366 resources/configuration.md:126 resources/configuration.md:126 resources/configuration.md:125 resources/configuration.md:125 resources/configuration.md:125 resources/middleware-guide.md:93 resources/routing-and-controllers.md:38 resources/routing-and-controllers.md:39 resources/routing-and-controllers.md:40 resources/routing-and-controllers.md:234 resources/routing-and-controllers.md:235 resources/routing-and-controllers.md:313 resources/routing-and-controllers.md:314 resources/routing-and-controllers.md:406 resources/routing-and-controllers.md:531 resources/sentry-and-monitoring.md:40 resources/sentry-and-monitoring.md:40 resources/sentry-and-monitoring.md:39 resources/sentry-and-monitoring.md:39 resources/sentry-and-monitoring.md:140 resources/sentry-and-monitoring.md:182 resources/sentry-and-monitoring.md:219 resources/services-and-repositories.md:338 resources/services-and-repositories.md:505 resources/services-and-repositories.md:506 resources/services-and-repositories.md:725 resources/services-and-repositories.md:726 resources/services-and-repositories.md:727 resources/services-and-repositories.md:730 resources/testing-guide.md:23 resources/testing-guide.md:25 resources/testing-guide.md:201 resources/validation-patterns.md:378 resources/validation-patterns.md:379 skill-report.json:6
تم تدقيقه بواسطة: claude عرض سجل التدقيق →
درجة الجودة
38
الهندسة المعمارية
100
قابلية الصيانة
85
المحتوى
22
المجتمع
100
الأمان
91
الامتثال للمواصفات
ماذا يمكنك بناءه
新しいExpressエンドポイント
レイヤーアーキテクチャパターンに従ってコントローラに委ねるクリーンなルートを作成する
入力バリデーションの追加
Zodスキーマと自動TypeScript型推論でタイプセーフなバリデーションを実装する
コードレビュー基準
BaseControllerとリポジトリパターンでマイクロサービス間で一貫したパターンを適用する
جرّب هذه الموجهات
新しいエンドポイント
/usersのルートを作成して、アクティブユーザーのリストを返す。BaseControllerを拡張したコントローラを使用したレイヤーアーキテクチャパターンを使用すること。
バリデーションスキーマ
メール、名前、パスワードフィールドを持つユーザー登録フォームのZodスキーマを作成すること。TypeScript型推論を含めること。
リポジトリパターン
PrismaServiceを使用してメールによるユーザーの検索と新規ユーザーの作成を行うUserRepositoryクラスを作成すること。エラー処理を含めること。
エラー処理
Sentryを使用したサービスメソッドでのエラーの適切なキャプチャ方法を示すこと。ユーザーコンテキストとオペレーショタグを含めること。
أفضل الممارسات
- ルートをクリーンに保ち、すべてのロジックをコントローラに委ねる
- 一貫したエラー処理とSentry統合のためにBaseControllerを拡張する
- 自動TypeScript推論を使用してZodでタイプセーフな入力バリデーションを行う
- 懸念事項を分離する：ルートはルーティングを、コントローラはHTTPを、サービスはビジネスロジックを、リポジトリはデータアクセスを担当する
تجنب
- ルートハンドラにビジネスロジックを入れる - 懸念事項の分離に違反
- unifiedConfigではなく直接 process.env を使用する
- エラー処理がない、またはSentryキャプチャせずにエラーを握りつぶす
- コントローラやサービスから直接Prismaを呼び出す - 代わりにリポジトリを使用する
الأسئلة المتكررة
このスキルはExpressではなくFastifyで使用できますか？
パターンは小さな調整でFastifyに移行できます。ルートとコントローラは類似したままです。代わりにFastifyプラグインシステムを使用します。
どのようなデータベースORMがサポートされていますか？
主要パターンはPrismaを使用しますが、リポジトリパターンは任意のORMに適用できます。KyselyとTypeORMも同様のサービスとレイヤーを使用できます。
これをNext.js APIルートで使用できますか？
はい。コントローラパターンはAPIルートハンドラにマッピングされます。サービスとリポジトリはそのまま動作します。Next.js ResponseにBaseControllerを適応させます。
このスキルを使用するとデータは安全ですか？
はい。これはドキュメント専用のスキルです。コード例を提供しますが、ファイル、環境変数へのアクセス、ネットワークリクエストを行うことはありません。
生成されたコードで型エラーが発生するのですが、なぜですか？
必要な依存関係がインストールされていることを確認してください：@sentry/node、@prisma/client、zod、およびそれらのTypeScriptタイプ。スキーマ定義後に prisma generate を実行してください。
ドキュメントサイトとどう違いますか？
このスキルはコードベース固有のコンテキスト対応パターンを提供します。既存のパターンを理解し、アーキテクチャに一致する一貫したコードを生成します。
تفاصيل المطور
المؤلف
BrianDai22الترخيص
MIT
المستودع
https://github.com/BrianDai22/concetrateaiquiz/tree/main/.claude/skills/backend-dev-guidelinesمرجع
main
بنية الملفات