senior-backend

シニアバックエンドエンジニア

バックエンドサービスのスキャフォールディングとレビューを行います。Express／Fastify／Koa 向けの API 設計と OpenAPI 主導のコード生成、PostgreSQL スキーマ分析とマイグレーション生成、HTTP 負荷テスト、本番環境向けのセキュリティ強化に対応します。すぐに実行できるルートハンドラー、Zod バリデーター、TypeScript 型、ロールバック付きマイグレーション、負荷テストレポートを出力します。

主な機能

• API のスキャフォールディング — Express、Fastify、Koa 向けのルートハンドラー、バリデーションミドルウェア、TypeScript 型、OpenAPI 仕様を生成します。
• データベースの最適化 — スキーマ分析、欠落インデックスの検出、N+1 のリスク検出、ロールバックスクリプトと対になるマイグレーションの生成を行います。
• 負荷テスト — 設定可能な同時実行数で、レイテンシのパーセンタイル（P50／P90／P95／P99）、スループット、エラー率、エンドポイントの比較を実施します。
• セキュリティ強化 — 本番環境への対応に向けて、JWT の設定、レート制限、入力バリデーション（Zod）、セキュリティヘッダー（helmet）を設定します。
• 標準化されたコントラクト — 一貫した data／error／meta レスポンスエンベロープと HTTP ステータス規約を使用します。

使用するタイミング

• 新しい API を設計するとき、または既存のエンドポイントをリファクタリングするとき。
• クエリが遅いとき、またはデータベースのパフォーマンスを改善する必要があるとき。
• API を本番環境に向けて準備するとき、またはセキュリティレビュー後。
• バックエンドエンドポイントの回帰テスト／負荷テストのベースラインを構築するとき。

先に確認すること

スキャフォールディングを行う前に、次の入力を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。

• フレームワーク — Express／Fastify／Koa（--framework。生成されるルートハンドラー、バリデーター、型に影響します）
• API コントラクトのソース — スキャフォールディングの基となる OpenAPI 仕様またはエンドポイント一覧（スキャフォールダーが読み込む入力です）
• データベースの目的 — スキーマファイル、および分析とマイグレーション生成のどちらを希望するか（database_migration_tool.py の動作を決定します）

停止ルール：出力に最も影響する 2～3 項目だけを質問してください。ユーザーが「とりあえず下書きして」と言った場合は、作業を進め、成果物の冒頭に前提を列挙してください。

ツール

ツール	目的	コマンド
api_scaffolder.py	OpenAPI 仕様からルートハンドラー、Zod バリデーター、TS 型を生成します	python scripts/api_scaffolder.py openapi.yaml --framework express --output src/routes/
database_migration_tool.py	スキーマを分析し、インデックスを提案して、ロールバック付きマイグレーションを生成します	python scripts/database_migration_tool.py schema.sql --analyze
api_load_tester.py	レイテンシのパーセンタイル、スループット、比較機能を備えた HTTP 負荷テストを実行します	python scripts/api_load_tester.py https://api.example.com/users --concurrency 50 --duration 30

リファレンス

タスクに合ったリファレンスを読み込んでください。このファイルは簡潔に保ち、必要に応じて詳細を確認します。

• references/tools-reference.md — スキャフォールダー、マイグレーションツール、負荷テスターの詳しい使用例、フラグ一覧、出力例に加え、クイックスタートとよく使うコマンドを掲載しています。ツールを実行する際に参照してください。
• references/workflows-and-patterns.md — API 設計、データベース最適化、セキュリティ強化のワークフロー、一般的なレスポンス／インデックスのパターン、トラブルシューティング表、成功基準を掲載しています。サービスを設計または強化する際に参照してください。
• references/api_design_patterns.md — REST と GraphQL の比較、バージョニング、エラー処理、ページネーションを掲載しています。新しい API を設計する際に参照してください。
• references/database_optimization_guide.md — インデックス戦略、クエリ最適化、N+1 の解決策を掲載しています。遅いクエリを改善する際に参照してください。
• references/backend_security_practices.md — OWASP Top 10、認証パターン、入力バリデーションを掲載しています。セキュリティを強化する際に参照してください。

対象範囲と制限事項

このスキルで対応する内容：

• Express、Fastify、Koa を対象とした REST API の設計、スキャフォールディング、OpenAPI 駆動のコード生成
• PostgreSQL スキーマの分析、インデックスの最適化、ロールバックに対応したマイグレーションの生成
• レイテンシのパーセンタイル分析、スループットの測定、エンドポイントの比較を含む HTTP 負荷テスト
• JWT の設定、レート制限、入力検証、セキュリティヘッダーなどのバックエンドセキュリティパターン

このスキルで対応しない内容：

• フロントエンド開発、UI コンポーネント、クライアント側の状態管理 -- senior-frontend を参照
• インフラのプロビジョニング、コンテナオーケストレーション、CI/CD パイプラインの設定 -- senior-devops を参照
• GraphQL スキーマの設計、リゾルバー、サブスクリプション -- senior-fullstack を参照
• アプリケーションパフォーマンス監視（APM）、分散トレーシング、ログ集約 -- senior-secops を参照

統合ポイント

スキル	統合	データフロー
senior-fullstack	ここで生成された API ルートはフルスタックプロジェクトのスキャフォールディングに利用されます	OpenAPI 仕様 → フルスタックのスキャフォルダーが API コントラクトとして利用
senior-devops	ここで出力されたマイグレーションスクリプトは CI/CD デプロイメントパイプラインで利用されます	migrations/ ディレクトリ → デプロイメントワークフローで適用および検証
senior-security	負荷テストの結果とセキュリティ強化の出力はセキュリティレビューに活用されます	負荷テストの JSON → セキュリティ監査でレート制限とエラー処理を検証
senior-qa	生成されたルートハンドラーとバリデーターは QA 自動化のテスト対象になります	ルートファイル + Zod スキーマ → QA で統合テストスイートを生成
senior-frontend	スキャフォルダーが生成した TypeScript 型はフロントエンドの利用者と共有されます	types.ts → フロントエンドで API 型をインポートし、型安全なクライアントコードを作成
code-reviewer	スキーマ分析で見つかった問題とマイグレーションの差分はコードレビューチェックリストに活用されます	分析レポート → レビュアーがインデックスの網羅性と命名規則を検証