prime-backend について
prime-backendは、複雑なフルスタックリポジトリのバックエンドを把握するためのエージェントスキルです。ルート、サービス、データ層に絞って調査し、先にJiraやConfluenceの情報を読み込めます。
主な機能
- 01JiraとConfluenceの情報を先に取得
- 02バックエンドのルートと主要ファイルを特定
- 03ルート、サービス、データ層を整理
- 04最近の変更と作業ツリーを確認
- 05構造化したバックエンド概要を作成
活用シーン
- 01バックエンド開発前のコードベース把握
- 02JiraやConfluenceのタスクに基づく分析
- 03マイグレーションやAPI変更、未完了作業の確認
MCP 対応
Atlassian MCPツールを呼び出してJira課題やConfluenceページを取得し、バックエンド分析の文脈として利用できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/prime-backendを入力して読み込まれたか確認します。
詳細
Prime Backend：バックエンドコンテキストの読み込み
目的
バックエンドのコードベースの構造、ルート、サービス、データ層を分析し、的を絞った理解を深めます。バックエンドのコンテキストだけを読み込むことで、複雑なフルスタックのコードベースでもコンテキストウィンドウを軽く保てます。外部タスクへの参照が提供されている場合は、まずそれを読み込み、実際の作業に基づいて分析を進めます。
手順
Step 0：外部コンテキストの読み込み
コードベースの分析より前に、この手順を実行してください。 任意の引数として、[jira-issue-keys] [confluence-page-ids] を受け取ります。
- Jira キーには、単一のキー（
ACC-2）またはカンマ区切りのキー（ACC-2,ACC-3）を指定できます。 - Confluence ページ ID は数値のページ ID です。
Jira の課題キーが指定されている場合：
mcp__atlassian__getAccessibleAtlassianResourcesを呼び出して、cloudIdを取得します。- Jira の各キーについて、
cloudId、課題キー、responseContentFormat: "markdown"を指定してmcp__atlassian__getJiraIssueを呼び出します。 - 取得した課題の概要、説明、受け入れ条件を、この後のすべての作業におけるタスクコンテキストとして扱います。
Confluence のページ ID が指定されている場合：
- 各ページ ID について、
contentFormat: "markdown"を指定してmcp__atlassian__getConfluencePageを呼び出します（上記でcloudIdを取得していない場合は、mcp__atlassian__getAccessibleAtlassianResourcesを呼び出して取得します）。 - 取得したページの内容を、参考コンテキスト（仕様、設計ドキュメント、要件）として扱います。
引数が指定されていない場合： この手順全体を省略し、Step 1 に進みます。
読み込んだ外部コンテキストを簡潔に要約してから、次に進みます。これにより、以降の調査の枠組みが明確になります。
1. バックエンドの場所を特定する
追跡対象のファイルをすべて一覧表示して、バックエンドのルートを特定します。
!git ls-files
一般的なバックエンドのルートは、backend/、server/、api/、app/（FastAPI/Django）、src/（バックエンドのみのプロジェクトの場合）です。先に適切なルートを特定してから進めてください。
2. バックエンドのドキュメントを読む
- CLAUDE.md または類似の全体ルールファイル（プロジェクト全体の規約を確認するため）を読みます
- バックエンドのルート内にある README を読みます
.claude/references/backend-api-best-practices.mdが存在する場合は読みます（プロジェクト固有の API 規約が記載されています）
3. 主要なバックエンドファイルを特定する
構成に応じて、以下を読みます。
- メインのエントリーポイント（
main.py、app.py、server.ts、index.tsなど） - ルート登録／ルーターのインデックス（
routes/、api/、routers/） - コア設定（
pyproject.toml、package.json、tsconfig.json） - データベース設定と ORM のセットアップ（
database.py、db.ts、alembic.ini） - コアデータモデルまたはスキーマ（
models/、schemas/） - 代表的な機能スライスを 1～2 件（ルート + サービス + モデル）読み、確立されたパターンを把握します
- ミドルウェアと依存性注入のセットアップ
バックエンドが公開する共有型またはコントラクトを定義している場合を除き、バックエンドのルート外にあるファイルは読み飛ばします。
4. 現在のバックエンドの状態を把握する
最近のバックエンド関連の作業を確認します。
!git log -10 --oneline
!git status
未完了のマイグレーション、保留中のスキーマ変更、進行中の API 変更があれば記録します。
出力レポート
以下の内容を網羅した簡潔な要約を提示します。
外部タスクコンテキスト（読み込んだ場合）
- Jira の課題：キー、タイトル、目標の一行要約、受け入れ条件
- Confluence のページ：タイトルと記載内容
バックエンドの概要
- フレームワークと主要ライブラリ（FastAPI、Django、Express、NestJS など）
- 言語とランタイムのバージョン
- データベースと ORM（PostgreSQL + SQLAlchemy、MongoDB + Mongoose など）
ディレクトリ構成
- バックエンドのルートと、主要なサブディレクトリごとの役割の一行説明
アーキテクチャのパターン
- ルート、サービス、データアクセス層の構成
- 確認できた依存性注入またはミドルウェアのパターン
- エラー処理の方法
規約
- 命名規則、モジュール構成
- マイグレーションツールと現在のマイグレーション状態
- 確認できたテストフレームワークと規約
現在の状態
- アクティブなブランチ、最近のバックエンドの変更
- 保留中のマイグレーションやスキーマの変更
- 直ちに対処すべき懸念事項（検証の不足、未処理のエラーなど）
箇条書きと明確な見出しを使い、要約をひと目で把握できるようにしてください。