المهارات backend-dev-guidelines
⚙️
backend-dev-guidelines
آمن ⚙️
الأوامر الخارجية🔑
متغيرات البيئة📁
الوصول إلى نظام الملفات🌐
الوصول إلى الشبكة
ベストプラクティスでExpressマイクロサービスを構築する
متاح أيضًا من: diet103,BrianDai22,DojoCodingLabs,sickn33
バックエンドコードは明確なパターンがないと一貫性がなく、メンテナンスが困難になります。このスキルは、Node.js/Express/TypeScriptマイクロサービス向けのレイヤー構造、エラーハンドリング、バリデーション、テストに関する包括的なガイドラインを提供します。
يدعم: Claude Codex Code(CC)
1
تنزيل ZIP المهارة
2
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
3
فعّل وابدأ الاستخدام
اختبرها
استخدام "backend-dev-guidelines". Create a user service with repository pattern and Sentry error tracking
النتيجة المتوقعة:
- UserService - ユーザー操作のビジネスロジック
- - コンストラクタ経由の依存性注入
- - メールの一意性バリデーション
- - データアクセス用のUserRepository
- - エラー時のSentry captureException
- UserRepository - データアクセスの抽象化
- - findById、findByEmail、findActive
- - create、update、delete操作
- - 意味のあるメッセージ付きエラーハンドリング
استخدام "backend-dev-guidelines". Add Zod validation to the user registration endpoint
النتيجة المتوقعة:
- RegistrationSchema - Zodバリデーションスキーマ
- - email: メール形式バリデーション付き文字列
- - password: 最低8文字の文字列
- - name: 任意の文字列
- - バリデーションエラーは詳細付きで400を返す
- コントローラーはschema.parse()でバリデーションを実行
- 型推論がTypeScript型を自動生成
استخدام "backend-dev-guidelines". Configure unifiedConfig for a new microservice
النتيجة المتوقعة:
- config/unifiedConfig.ts - 型安全な設定
- - ホスト、ポート、認証情報付きのデータベース設定
- - 適切なデフォルト値付きのタイムアウト値
- - config.ini経由の環境別オーバーライド
- - 起動時にすべての設定をバリデーション
- - アプリ全体で単一ソースからインポート
التدقيق الأمني
آمنv5 • 1/17/2026
Documentation-only skill containing markdown guidelines. No executable code, scripts, or runtime capabilities. All 557 static findings are false positives triggered by markdown code block syntax and educational anti-pattern examples. Verified by previous audit rating risk_level: 'safe'. Contains 13 markdown files (5535 lines) of documentation only.
13
الملفات التي تم فحصها
5,535
الأسطر التي تم تحليلها
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:143 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
قابلية الصيانة
87
المحتوى
20
المجتمع
100
الأمان
91
الامتثال للمواصفات
ماذا يمكنك بناءه
Expressパターンを学ぶ
保守性の高いExpressアプリケーションのために、ルート、コントローラー、サービス、リポジトリをどのように整理するか、レイヤー構造を理解します。
チームのルールを定義する
マイクロサービス間でエラーハンドリング、バリデーション、設定、テストのための一貫したパターンを確立します。
Expressコードベースを最新化する
ビジネスロジックを含むルートを、依存性注入を備えた適切なコントローラーとサービスレイヤーにリファクタリングします。
جرّب هذه الموجهات
新しいエンドポイントの作成
[RESOURCE_NAME]機能のための新しいルート、コントローラー、サービス、リポジトリを作成してください。ZodバリデーションスキーマとSentryエラートラッキングを含めてください。BaseControllerパターンを従ってください。
バリデーションの追加
[ENDPOINT_PATH]にZodバリデーションを追加してください。リクエストボディの型推論付きバリデーションスキーマを作成してください。バリデーションエラーを適切なHTTPステータスコードで処理してください。
エラートラッキングの設定
[SERVICE_NAME]のSentry統合を設定してください。instrument.tsの初期化、BaseControllerエラーハンドリング、データベースクエリのパフォーマンスモニタリングを含めてください。
ルートのリファクタリング
[ROUTE_FILE]をリファクタリングして、ルーティングからビジネスロジックを分離してください。依存性注入を備えたコントローラーとサービスレイヤーに抽出してください。エラーハンドリングとバリデーションを追加してください。
أفضل الممارسات
- ルートは薄く維持 - すべてのビジネスロジックはコントローラーとサービスに委譲する
- 自動的なTypeScript推論付きの型安全バリデーションにZodを使用する
- すべてのエラーを意味のあるコンテキストとタグと共にSentryにキャプチャする
تجنب
- ビジネスロジックをルートハンドラーに直接配置しない
- process.envを直接使用しない - 型安全のためにunifiedConfigを使用する
- 適切なtry-catchとエラー伝播なしで非同期エラーを飲み込まない
الأسئلة المتكررة
推奨されるプロジェクト構成は？
レイヤー構造を使用してください：ルーティングにはルート、リクエスト処理にはコントローラー、ビジネスロジックにはサービス、データアクセスにはリポジトリ。
ユーザー入力のバリデーション方法は？
型推論付きのZodスキーマを使用してください。スキーマをvalidators/ディレクトリで定義し、コントローラーでschema.parse()を使用してください。
エラーを一貫して処理するには？
Sentry統合付きのhandleErrorメソッドを提供するBaseControllerを拡張してください。適切なHTTPステータスコードを持つカスタムエラータイプをスローしてください。
アプリケーションを設定するには？
unifiedConfigパターンを使用してください - config.iniからロードされ、環境変数にフォールバックする型安全な設定オブジェクト。
どのテストフレームワークを使用すべきですか？
ユニットテストとインテグレーションテストにJestを使用してください。リポジトリとサービスをモックしてください。ユニットテストは70%以上のコードカバレッジを目標にしてください。
公式Expressドキュメントとどう異なりますか？
このスキルは、Sentry、Zod、Prisma、一貫したエラーハンドリングを含むエンタープライズマイクロサービスのための意見主導のパターンを提供します。