fullstack-software-engineer について
UI、API、データ永続化にまたがる開発を支援するフルスタックソフトウェアエンジニアリングスキルです。機能実装、クライアントとサーバーにまたがる不具合修正、テスト、本番デバッグを扱います。
主な機能
- 01UIとサーバーにまたがる機能開発
- 02APIとデータベース変更の設計
- 03認証、検証、データフローの実装
- 04ユニット、統合、E2Eテストの作成
- 05本番障害の調査と回帰テスト追加
活用シーン
- 01UI、API、ストレージを含む機能の構築
- 02クライアントとサーバーにまたがる不具合修正
- 03認証、ページネーション、ファイルアップロードの追加
- 04重要な経路のテストと小規模変更の準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/fullstack-software-engineerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/api_and_database.mdfeature_delivery.mdfrontend_integration.mdtesting_debugging.md詳細
フルスタックソフトウェアエンジニア
使用する場面
- 垂直機能（UI ＋ API ＋永続化）を実装する
- フロントエンドが利用する API を設計または変更する
- クライアントとサーバーにまたがるバグを修正する
- 認証、バリデーション、ページネーション、ファイルアップロードのフローを追加する
- ユニットテスト、統合テスト、重要な経路の E2E テストを作成または拡張する
使用しない場面
- パイプライン、GitOps、クラスターの運用 →
devopsまたはplatform-engineer - Terraform、ネットワーク、K8s クラスターの設計 →
infrastructure-engineer - セキュリティプログラム、監査証跡、SOC 業務 →
cybersecurity、compliance-engineer - 多数のチームにまたがる、サービスアーキテクチャの詳細な RFC →
senior-software-engineer - 明確にシニアフルスタックのリーダーシップが求められる業務 →
senior-fullstack-developer
関連スキル
| ニーズ | スキル |
|---|---|
| シニアレベルの機能提供と、より詳細なレビュー基準 | senior-fullstack-developer |
| RFC とサービス横断の設計 | senior-software-engineer |
| デプロイとオブザーバビリティの仕組み | devops |
| 要件と受け入れ基準 | business-analyst |
| ユーザー向けドキュメント | tech-writer-researcher |
| フロントエンドに特化したアーキテクチャとアクセシビリティ | senior-frontend-software-engineer |
| Web セッション、CSRF、CORS、ハイブリッドレンダリング | web-application-developer |
| 顧客チケットの再現とエスカレーション | support-engineer |
主なワークフロー
1. 垂直機能の提供
- 受け入れ基準とエッジケース（空、エラー、権限）を確認する
- API 契約と UI の状態を定義する
- サーバーを実装する：バリデーション、認可、永続化、マイグレーション
- 型付き契約に基づいてクライアントを実装する
- テストする：ユニット（ロジック）、統合（API）、E2E（正常系）
- 新しい経路にロギング／メトリクスを追加し、リスクが高い場合はフィーチャーフラグを設定する
チェックリストは references/feature_delivery.md を参照してください。
2. API とデータベース
| 項目 | デフォルト |
|---|---|
| バリデーション | 境界でスキーマを検証する（Zod、Pydantic） |
| 認証 | セッションまたは JWT を使用し、リソースごとに認可を確認する |
| クエリ | N+1 を避け、アクセスパターンに応じてインデックスを作成する |
| ミューテーション | 必要に応じてトランザクションを使用し、決済のようなフローでは冪等性キーを設定する |
| エラー | 安定したコードを使用し、内部情報をクライアントに公開しない |
ページネーションとマイグレーションについては references/api_and_database.md を参照してください。
3. フロントエンド連携
- ローディング／エラー／空の状態をデザインに合わせる
- Next.js App Router を使用する場合、読み取りが多いページではサーバー側のフェッチを優先する
- クライアントコンポーネントはインタラクティブな機能にのみ使用する
- アクセシブルなフォームにする（ラベル、フォーカス、キーボード）
フォームとキャッシュについては references/frontend_integration.md を参照してください。
4. テストと PR の適切な管理
- リントと型チェックが問題なく通る
- テストでは正常系だけでなく、変更した動作もカバーする
- リポジトリにシークレットを含めず、環境変数は設定から渡す
- PR を小さく保ち、ロールアウトとロールバックについて説明する
テストピラミッドについては references/testing_debugging.md を参照してください。
5. 本番環境のデバッグ
- 相関 ID またはリクエスト ID を使って再現する
- デプロイ、フラグ、最近の設定変更を確認する
- ログ → メトリクス → DB の低速クエリの順に追跡する
- 回帰テストを追加して修正し、重大度に応じてホットフィックスまたはロールバックを行う
よくある障害については references/testing_debugging.md を参照してください。
リファレンスを読み込むタイミング
- 機能のフロー →
references/feature_delivery.md - API と DB →
references/api_and_database.md - UI 連携 →
references/frontend_integration.md - テストと本番環境の問題 →
references/testing_debugging.md
コメント
Markdown 対応