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
name: connection-pooling description: | データベース接続プール設計と運用を支援するスキル。 サーバーレス環境や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
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 |
改善履歴の記録 |