connection-pooling
データベース接続プール設計と運用を支援するスキル。サーバーレス環境やTursoの接続制約を踏まえたサイジングと検証手順を整理する。Anchors:• 『The Pragmatic Programmer』(Andrew Hunt, David Thomas)/ 適用: 実践的改善 / 目的: 接続管理の品質維持Trigger:Use when designing connection pools, sizing database connections, or troubleshooting serverless connection limits.connection pooling, database connections, pool sizing, serverless connections, Turso
When & Why to Use This Skill
This Claude skill provides a comprehensive framework for designing, sizing, and managing database connection pools, specifically optimized for serverless environments and Turso. It helps developers maintain high system availability and performance by providing structured workflows for requirement analysis, constraint identification, and configuration validation to prevent connection exhaustion.
Use Cases
- Case 1: Sizing database connection pools for serverless applications to prevent 'too many connections' errors during auto-scaling events.
- Case 2: Designing resilient database architectures for Turso by analyzing specific connection constraints and implementing optimal timeout and retry policies.
- Case 3: Troubleshooting existing database performance bottlenecks related to connection latency or pool exhaustion using structured monitoring metrics.
- Case 4: Establishing a standardized validation process for database connection settings using automated scripts to ensure alignment with industry best practices.
| name | connection-pooling |
|---|---|
| description | | |
| • 『The Pragmatic Programmer』(Andrew Hunt, David Thomas)/ 適用 | 実践的改善 / 目的: 接続管理の品質維持 |
connection-pooling
概要
データベース接続プールを設計し、負荷と制約に応じた接続管理を行う。
ワークフロー
Phase 1: 要件整理
目的: 目的・負荷・制約を明確化する。
アクション:
- 想定トラフィックと同時実行を整理する。
- 接続上限と制約を整理する。
- 成功条件と監視指標を整理する。
Task: agents/analyze-pooling-requirements.md を参照
Phase 2: 制約分析
目的: サーバーレス/Tursoの制約を整理する。
アクション:
- サーバーレス制約と運用前提を確認する。
- 監視項目と警戒値を整理する。
- リスクと回避策を整理する。
Task: agents/analyze-turso-constraints.md を参照
Phase 3: 設計
目的: 接続プール構成と検証方針を定義する。
アクション:
- プール構成とサイズを設計する。
- タイムアウトとリトライ方針を設計する。
- 検証手順と監視項目を整理する。
Task: agents/design-pooling-configuration.md を参照
Phase 4: 検証と記録
目的: 設定を検証し記録を更新する。
アクション:
scripts/validate-skill.mjsで構造を検証する。scripts/check-connections.mjsで設定を検証する。scripts/log_usage.mjsで記録を更新する。
Task: agents/validate-pooling-setup.md を参照
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| analyze-pooling-requirements | Phase 1開始時 | 目的/負荷 | 要件整理メモ、成功条件一覧 |
| analyze-turso-constraints | Phase 2開始時 | 制約/環境 | 制約整理メモ、回避策一覧 |
| design-pooling-configuration | Phase 3開始時 | 要件整理メモ | 接続プール設計書、検証ガイド |
| validate-pooling-setup | Phase 4開始時 | 接続プール設計書 | 検証レポート、ログ更新内容 |
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|---|
| 負荷前提を明文化する | サイジング根拠を残すため |
| サーバーレス制約を整理する | 接続枯渇を防ぐため |
| エラーハンドリングを設計する | 障害時の復旧を容易にするため |
| テンプレートを参照する | 設定漏れを防ぐため |
避けるべきこと
| 禁止事項 | 問題点 |
|---|---|
| 制約を無視した設定 | 接続枯渇が発生する |
| 監視なしで運用する | 異常検知が遅れる |
| タイムアウトを省略する | 復旧が遅れる |
リソース参照
scripts/(決定論的処理)
| スクリプト | 機能 |
|---|---|
scripts/check-connections.mjs |
接続設定の検証 |
scripts/validate-skill.mjs |
スキル構造の検証 |
scripts/log_usage.mjs |
使用記録と評価メトリクス更新 |
references/(詳細知識)
| リソース | パス | 読込条件 |
|---|---|---|
| レベル1 基礎 | references/Level1_basics.md | 初回整理時 |
| レベル2 実務 | references/Level2_intermediate.md | 設計時 |
| レベル3 応用 | references/Level3_advanced.md | 詳細設計時 |
| レベル4 専門 | references/Level4_expert.md | 改善ループ時 |
| エラーハンドリング | references/error-handling.md | 障害対策時 |
| サイジングガイド | references/pool-sizing-guide.md | サイジング時 |
| サーバーレス接続 | references/serverless-connections.md | サーバーレス運用時 |
| 旧スキル | references/legacy-skill.md | 互換確認時 |
| 要件索引 | references/requirements-index.md | 要件整理時 |
assets/(テンプレート・素材)
| アセット | 用途 |
|---|---|
assets/drizzle-config-template.ts |
接続プール設定テンプレート |
運用ファイル
| ファイル | 目的 |
|---|---|
EVALS.json |
レベル評価・メトリクス管理 |
LOGS.md |
実行ログの蓄積 |
CHANGELOG.md |
改善履歴の記録 |