المهارات scaffolding-fastapi-dapr
🔧

scaffolding-fastapi-dapr

مخاطر منخفضة ⚡ يحتوي على سكربتات📁 الوصول إلى نظام الملفات🌐 الوصول إلى الشبكة🔑 متغيرات البيئة

DaprとSQLModelを使用したFastAPIバックエンドの構築

適切なパターンで本番環境対応のバックエンドを作成するには、複数のドキュメントソースを調査する必要があります。このスキルは、FastAPI、SQLModel、Dapr pub/sub、JWT認証のすぐに使えるコードパターンを提供し、すぐに開発を始められます。

يدعم: Claude Codex Code(CC)
🥉 75 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "scaffolding-fastapi-dapr". SQLModelを使用したTaskモデルと非同期エンドポイントの作成

النتيجة المتوقعة:

  • title、status、priorityフィールドとタイムスタンプを持つTaskモデル
  • PostgreSQL用の非同期データベースエンジンのセットアップ
  • セッション注入を使用したPOST /tasksエンドポイント
  • 404ハンドリングを使用したGET /tasks/{id}エンドポイント
  • 部分更新を使用したPATCH /tasks/{id}エンドポイント

استخدام "scaffolding-fastapi-dapr". タスクイベント用のDapr pub/subのセットアップ

النتيجة المتوقعة:

  • トピックルートを返すDaprサブスクリプションエンドポイント
  • データアンラップを使用したCloudEventハンドラー
  • トピックパラメータを使用したイベント公開関数
  • SUCCESSステータスを返すエラーハンドリング

استخدام "scaffolding-fastapi-dapr". 保護されたルートへのJWT認証の追加

النتيجة المتوقعة:

  • 1時間のキーキャッシュを使用したJWKSクライアント
  • RS256検証によるトークンデコード
  • 保護されたエンドポイント用のHTTPBearer依存性
  • クレームからのユーザーペイロード抽出

التدقيق الأمني

مخاطر منخفضة
v5 • 1/16/2026

Documentation and code-pattern skill with minimal executable code. The only script (verify.py) only checks file existence. HTTP calls are to standard Dapr sidecar (localhost:3500) and configurable auth endpoints. No credential theft, data exfiltration, or persistence mechanisms.

7
الملفات التي تم فحصها
2,219
الأسطر التي تم تحليلها
4
النتائج
5
إجمالي عمليات التدقيق

عوامل الخطر

⚡ يحتوي على سكربتات (1)
scripts/verify.py:1-21
📁 الوصول إلى نظام الملفات (1)
scripts/verify.py:7-11
🌐 الوصول إلى الشبكة (2)
SKILL.md:166-175 references/dapr-patterns.md:103-127
🔑 متغيرات البيئة (2)
SKILL.md:62 references/fastapi-patterns.md:86
تم تدقيقه بواسطة: claude عرض سجل التدقيق →

درجة الجودة

68
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
20
المجتمع
90
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

REST APIバックエンドの構築

SQLModel、非同期データベースパターン、JWT検証を使用したFastAPIアプリケーションを作成します。

Daprマイクロサービスの統合

Dapr pub/sub、状態管理、スケジュールジョブを使用したイベント駆動型アーキテクチャをセットアップします。

エージェント対応APIの作成

一貫したパターンで人間のユーザーとAIエージェントの両方に対応するエンドポイントを設計します。

جرّب هذه الموجهات

タスクCRUDエンドポイントの作成 
SQLModelを使用してTaskモデルを作成し、非同期データベースセッションを使用してPOST、GET、PATCHエンドポイントを生成する方法を教えてください。
JWT認証の追加 
FastAPIの保護されたルートにHTTPBearerセキュリティを使用して、Better Auth JWKSエンドポイントに対するJWT検証を実装してください。
Dapr pub/subのセットアップ 
CloudEventメッセージを受信し、トピックにイベントを公開するFastAPIのDaprサブスクリプションハンドラーを作成してください。
非同期テストの設定 
AsyncClient、AsyncSession、データベース接続の依存性オーバーライドを使用した非同期テスト用のpytestフィクスチャを作成してください。

أفضل الممارسات

  • MissingGreenletエラーを防ぐため、コミット前にデータベースオブジェクトからプリミティブを常に抽出する
  • 無限リトライを防ぐため、エラー時でもDaprハンドラーからSUCCESSステータスを返す
  • 認証サーバーの負荷を減らしパフォーマンスを向上させるため、JWKSキーを1時間キャッシュする

تجنب

  • async session.exec()の代わりに同期session.execute()を使用すること
  • DaprハンドラーでCloudEventのdataフィールドのアンラップを忘れること
  • サービス関数内でトランザクションをコミットし、呼び出し元にコミット制御を任せないこと

الأسئلة المتكررة

必要なPythonバージョンは何ですか?
型ヒントと最新の非同期パターンのためにPython 3.10以降が必要です。
PostgreSQLの代わりにSQLiteを使用できますか?
はい、DATABASE_URLをsqlite://に変更し、aiosqliteアダプターを使用してください。
既存の認証システムにこれを接続するにはどうすればよいですか?
AUTH_SERVER_URLとJWKS_URL環境変数を設定し、verify_tokenパターンを使用してください。
これらのパターンを使用する際、データは安全ですか?
これらは読み取り専用のパターンです。データフローとストレージは自分のコードで制御します。
MissingGreenletエラーが発生するのはなぜですか?
コミット後にデタッチされたオブジェクトにアクセスしています。コミット前にプリミティブを抽出してください。
DjangoやFlaskの使用とどう違いますか?
FastAPIは、非同期サポート、自動OpenAPIドキュメント、Pydanticバリデーションを標準で提供します。

تفاصيل المطور

المؤلف

Asmayaseen

الترخيص

MIT

المستودع

https://github.com/Asmayaseen/hackathon-2/tree/main/.claude/skills/scaffolding-fastapi-dapr

مرجع

main

بنية الملفات

📁 references/

📄 dapr-patterns.md

📄 fastapi-patterns.md

📄 production-testing.md

📄 sqlmodel-patterns.md

📁 scripts/

📄 verify.py

📄 SKILL.md