microservices
FastAPI/PythonおよびGoを用いた本番品質のマイクロサービス構築に関するガイドラインを提供します。サーバーレスパターン、クリーンアーキテクチャ、オブザーバビリティ、レジリエンスを網羅しており、堅牢なサービス設計が必要な場面で活用できます。
description の原文を見る
Guidelines for building production-grade microservices with FastAPI/Python and Go, covering serverless patterns, clean architecture, observability, and resilience.
SKILL.md 本文
マイクロサービス開発
FastAPI/PythonとGoを使用したマイクロサービスアーキテクチャの専門家です。
コア原則
- 外部ストレージとキャッシュ (Redis) を備えたステートレスサービスを設計する
- NGINX、Traefik、またはKongを使用したAPIゲートウェイパターンを実装する
- 復元力のためにサーキットブレーカーとリトライパターンを使用する
- AWS LambdaとAzure Functionsでのサーバーレスデプロイメントに最適化する
FastAPI Pythonマイクロサービス
非同期処理
- CeleryまたはRQを使用した非同期タスクの処理
- 適切なタスクキューイングとワーカー管理の実装
- 分散システムにおける結果整合性の設計
可観測性
- 分散トレーシングにOpenTelemetryを使用する
- ELK Stackインテグレーションを使用した構造化ログの実装
- Prometheusおよびgrafanaをモニタリングとアラート用に設定する
- 相関IDがサービス境界全体に伝播することを確認する
セキュリティ
- 認証と認可のためにOAuth2を実装する
- レート制限とDDoS保護を適用する
- キャッシュレイヤーにRedisまたはMemcachedを使用する
- サービス境界での全てのインプットを検証する
Go バックエンド開発(マイクロサービス向け)
アーキテクチャ
- ハンドラー、サービス、リポジトリ、ドメインモデルを分離したClean Architectureパターンに従う
- ドメイン駆動設計の原則を適用する
- インターフェース駆動開発と依存性注入を使用する
- ビジネスロジックはハンドラーではなくドメインレイヤーに保つ
プロジェクト構造
project/
cmd/ # アプリケーションエントリーポイント
internal/ # プライベートアプリケーションコード
pkg/ # パブリックライブラリ
api/ # API定義 (OpenAPI, protobuf)
configs/ # 設定ファイル
test/ # 追加のテストユーティリティ
エラーハンドリング
- コンテキストラッピングを使用した明示的なエラーハンドリング
- デバッグに必要な十分なコンテキスト付きでエラーを返す
- ドメイン固有の障害のためにカスタムエラータイプを実装する
- エラーを静かに無視しない
並行処理
- 適切なライフサイクル管理によりゴルーチンを安全に管理する
- すべての関数呼び出しを通じてコンテキストを伝播する
- 通信のためにチャネルを適切に使用する
- グレースフルシャットダウンパターンを実装する
テスト
- テーブル駆動パターンを使用した包括的なユニットテストを作成する
- 外部依存関係のモックを使用する
- 高速ユニットテストと統合テストを分離する
- 重要なパスのエンドツーエンドテストを実装する
復元力
- 指数バックオフでリトライを実装する
- サーキットブレーカーを使用してカスケード障害を防ぐ
- グレースフルデグラデーション向けに設計する
- 部分的な障害に適切に対応する
ライセンス: Apache-2.0(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- mindrally
- リポジトリ
- mindrally/skills
- ライセンス
- Apache-2.0
- 最終更新
- 不明
Source: https://github.com/mindrally/skills / ライセンス: Apache-2.0
関連スキル
doubt-driven-development
重要な判断はすべて、本番環境への展開前に新しい視点から対抗的レビューを実施します。速度より正確性が重要な場合、不慣れなコードを扱う場合、本番環境・セキュリティに関わるロジック・取り消し不可の操作など影響度が高い場合、または後でバグを修正するよりも今検証する方が効率的な場合に活用してください。
apprun-skills
TypeScriptを使用したAppRunアプリケーションのMVU設計に関する総合的なガイダンスが得られます。コンポーネントパターン、イベントハンドリング、状態管理(非同期ジェネレータを含む)、パラメータと保護機能を備えたルーティング・ナビゲーション、vistestを使用したテストに対応しています。AppRunコンポーネントの設計・レビュー、ルートの配線、状態フローの管理、AppRunテストの作成時に活用してください。
desloppify
コードベースのヘルスチェックと技術負債の追跡ツールです。コード品質、技術負債、デッドコード、大規模ファイル、ゴッドクラス、重複関数、コードスメル、命名規則の問題、インポートサイクル、結合度の問題についてユーザーが質問した場合に使用してください。また、ヘルススコアの確認、次の改善項目の提案、クリーンアップ計画の作成をリクエストされた際にも対応します。29言語に対応しています。
debugging-and-error-recovery
テストが失敗したり、ビルドが壊れたり、動作が期待と異なったり、予期しないエラーが発生したりした場合に、体系的な根本原因デバッグをガイドします。推測ではなく、根本原因を見つけて修正するための体系的なアプローチが必要な場合に使用してください。
test-driven-development
テスト駆動開発により実装を進めます。ロジックの実装、バグの修正、動作の変更など、あらゆる場面で活用できます。コードが正常に動作することを証明する必要がある場合、バグ報告を受けた場合、既存機能を修正する予定がある場合に使用してください。
incremental-implementation
変更を段階的に実施します。複数のファイルに影響する機能や変更を実装する場合に使用してください。大量のコードを一度に書こうとしている場合や、タスクが一度では完結できないほど大きい場合に活用します。