Create Feature Skill - 新機能開発統合スキル

役割

新機能開発の全工程を統合的に実行するスキルです。要件分析から PR 作成まで、各専門スキルを適切な順序で呼び出し、完全な機能開発を自動化します。

実行フロー

Phase 1: 事前確認とブランチ作成

1-1. パラメータ確認

• feature_name: 機能名確認
• issue_number: Issue番号確認
• specification_path: 仕様書パス確認（オプション）
• figma_url: FigmaデザインURL確認（オプション）
• target: 実装対象確認（backend/frontend/fullstack）

1-2. ブランチ管理

# 現在のブランチを確認
git branch --show-current

# mainブランチの場合は新しいブランチを作成
# ブランチ名: feature/[feature_name]-[issue_number]
# 例: feature/user-profile-123

# mainブランチでないことを確認

Phase 2: 要件分析（analyze-requirements）

/analyze-requirements feature_name="[feature_name]" figma_url="[figma_url]"

実行内容:

• プロジェクト構造理解
• 既存機能調査
• 外部リソース取得（Figma、Context7）
• データモデル設計
• API設計
• 分析レポート作成

成果物:

• 分析レポート
• データモデル設計案
• API設計案

Phase 3: Backend実装（develop-backend）

条件: target が "backend" または "fullstack" の場合のみ実行

/develop-backend feature_name="[feature_name]" specification_path="[specification_path]" issue_number=[issue_number] branch_type="feature"

実行内容:

• データベース設計（Flyway マイグレーション）
• Entity/DTO作成
• Mapper実装（MyBatis）
• Service実装
• Controller実装
• OpenAPI仕様書更新
• 単体テスト実装
• error-codes.md更新（新規エラー時）
• database-design.md更新（DB変更時）
• サーバー起動確認

成果物:

• Controller/Service/Mapper/Entity/DTO クラス
• XMLマッピングファイル
• Flywayマイグレーションファイル
• 単体テストコード
• 更新されたドキュメント

Phase 4: Frontend実装（develop-frontend）

条件: target が "frontend" または "fullstack" の場合のみ実行

/develop-frontend feature_name="[feature_name]" specification_path="[specification_path]" figma_url="[figma_url]" issue_number=[issue_number] branch_type="feature"

実行内容:

• コンポーネント設計（Presentational/Container）
• 型定義とAPI連携準備
• Presentationalコンポーネント実装
• Containerコンポーネント実装
• API連携実装
• フォーム実装（該当する場合）
• 単体テスト実装
• サーバー起動確認

成果物:

• ページコンポーネント
• Presentational/Containerコンポーネント
• カスタムフック
• 単体テストコード
• Storybookストーリー

Phase 5: アーキテクチャレビュー（review-architecture）

/review-architecture target="[target]"

実行内容:

• コーディング規約準拠確認
• 設計整合性チェック
• ドキュメント整合性チェック
• DRY原則の確認
• 禁止事項違反の検出

判定:

• ✅ 合格 → Phase 6へ
• ❌ 不合格 → Phase 3または4へ戻って修正

Phase 6: 品質保証（qa-check）

/qa-check target="[target]"

実行内容:

• Lintチェック
• 単体テスト実行
• ビルド検証
• カバレッジ確認（80%以上）

判定:

• ✅ 合格 → Phase 7へ
• ❌ 不合格 → Phase 3または4へ戻って修正

Phase 7: PR作成（create-pr）

/create-pr issue_number=[issue_number]

実行内容:

• 変更内容の確認
• PR説明文の自動生成
• GitHub PRの作成
• PR URL返却

成果物:

• GitHub Pull Request
• PR URL

Phase 8: 完了報告

## Create Feature 完了報告

### 機能名
- [feature_name]

### Issue番号
- #[issue_number]

### PR URL
- [PR URL]

### 実装内容

#### Backend（実装した場合）
- **API**: [実装したエンドポイント一覧]
- **データベース**: [追加/変更したテーブル]
- **テスト**: [テストクラス数] クラス、[テストケース数] ケース
- **カバレッジ**: [数値]%

#### Frontend（実装した場合）
- **ページ**: [実装したページ一覧]
- **コンポーネント**: [作成したコンポーネント一覧]
- **テスト**: [テストファイル数] ファイル、[テストケース数] ケース
- **カバレッジ**: [数値]%

### 品質保証結果
- ✅ アーキテクチャレビュー: 合格
- ✅ QAチェック: 合格
- ✅ テストカバレッジ: 80%以上
- ✅ Lint/ビルド: 成功

### 次のステップ
Pull Requestのレビューを依頼してください。

エラーハンドリング

Phase 5（アーキテクチャレビュー）で不合格の場合

1. レビュー結果を分析
2. Backend/Frontendの該当箇所を特定
3. 必須修正事項を修正:
   • Backend修正が必要 → develop-backend を再実行
   • Frontend修正が必要 → develop-frontend を再実行
4. 修正完了後、review-architecture を再実行
5. 合格するまで繰り返し

Phase 6（QAチェック）で不合格の場合

1. QA結果を分析
2. 問題箇所を特定:
   • Lintエラー → コーディング規約準拠のため修正
   • テスト失敗 → テストまたは実装を修正
   • ビルドエラー → ビルドエラーを修正
   • カバレッジ不足 → テストを追加
3. 修正完了後、qa-check を再実行
4. 合格するまで繰り返し

各Phaseでのエラー

各スキル実行時にエラーが発生した場合:

1. エラー内容を詳細に確認
2. 原因を分析
3. 該当スキルを再実行（パラメータ調整等）
4. 解決しない場合はユーザーに報告

使用するスキル一覧

1. analyze-requirements: 要件分析
2. develop-backend: バックエンド実装（条件付き）
3. develop-frontend: フロントエンド実装（条件付き）
4. review-architecture: アーキテクチャレビュー
5. qa-check: 品質保証
6. create-pr: PR作成

重要な注意事項

必ず守るべきルール

1. ブランチ確認: mainブランチでないことを必ず確認
2. Issue番号必須: 全てのスキル呼び出しで統一したIssue番号を使用
3. 順序厳守: Phase 1 → 2 → 3/4 → 5 → 6 → 7 → 8 の順序を守る
4. レビュー/QA合格必須: Phase 5, 6 で不合格の場合は修正して再実行
5. 完全自動化: 人間の介入なしで完結させる（エラー時を除く）

品質基準

• テストカバレッジ: 80%以上
• Lintエラー: 0件
• テスト失敗: 0件
• ビルドエラー: 0件
• アーキテクチャレビュー: 合格
• QAチェック: 合格

タイムアウト対策

• 各スキル実行時のタイムアウトに注意
• 長時間かかる処理（ビルド等）はタイムアウト設定を調整
• バックグラウンド実行も活用

トラブルシューティング

analyze-requirements が失敗

• 仕様書パスを確認
• Figma URLを確認
• プロジェクト構造を確認

develop-backend/frontend が失敗

• ブランチを確認
• Issue番号を確認
• 依存関係を確認
• サーバー起動確認

review-architecture が不合格

• レビュー結果の必須修正事項を確認
• 該当箇所を修正
• 再度レビュー実行

qa-check が不合格

• QA結果の修正必要項目を確認
• Lint/テスト/ビルドエラーを修正
• 再度QA実行

create-pr が失敗

• git statusを確認
• コミット内容を確認
• GitHub認証を確認

参照ドキュメント

必須参照

• documents/development/development-policy.md: 開発ガイドライン
• documents/development/quick-checklist.md: 簡易チェックリスト

各スキルの詳細

• .claude/skills/analyze-requirements/README.md
• .claude/skills/develop-backend/README.md
• .claude/skills/develop-frontend/README.md
• .claude/skills/review-architecture/README.md
• .claude/skills/qa-check/README.md
• .claude/skills/create-pr/README.md