name: fix description: "Issueの実装/修正をTDDで進める。Usage: /fix [ISSUE_NUMBER]"
Implement Issue (Common)
このスキルは、Issue対応を worktree + TDD 前提で進めるための共通フローを提供する。
1. Preparation (Task Setup)
- 要件確認: Issue本文とプロジェクトのドキュメントを読む
- worktree 前提:
- Vive が worktree を作っている前提
- 無い場合は
/worktree-managementを使って作成する
- ディレクトリ移動:
- 対象 worktree ディレクトリに移動する
- 以降のコマンドは 必ず worktree 内で実行する
- 初期化(必要なら):
- 新規 worktree:
environment-setup(プロジェクト固有)を実行 - 既存 worktree:
.envと依存関係が揃っていればスキップ
- 新規 worktree:
1.1 環境構築後の確認(アイドリング防止)
environment-setup 完了後、必ず以下を確認してから次に進む:
| 確認項目 | コマンド例 | 問題時の対処 |
|---|---|---|
| 開発サーバー起動 | npm run dev / pnpm dev |
ログを確認、依存関係を再インストール |
| ポート競合 | lsof -i :3000 |
kill -9 <PID> または .env でポート変更 |
| DB接続 | docker compose ps / pg_isready |
コンテナ起動、認証情報確認 |
| スキーマ適用 | npx prisma migrate status |
npx prisma migrate dev |
| テスト実行 | npm test |
エラーログを確認 |
2. Planning & Design
実装前に「計画が明確か?」を自問する。
- 複雑(複数レイヤー、複数ファイル大)なら
/plannerを使って実装計画を作る - 設計判断が必要なら
/architectを使って設計案とトレードオフを整理する
3. Implementation Flow (TDD)
TDDで進める。E2Eと単体がある場合は Nested TDD を優先する。
- 進行ガイド:
/tdd-runner - ビルド/型エラーが詰まる:
/build-error-resolver
4. Final Verification & Documentation
実装が終わったら 必ず 次を行う:
- ドキュメント整合:
/doc-updater(必要ならプロジェクトSSOTを更新) - 標準検証: 変更に関係する
lint/test/buildをローカルで通す(E2Eがあるなら該当シナリオも)
5. Push & PR(必要なら)
5.0 base ブランチ(重要)
PR の base は 対象リポジトリの AGENTS.md(ルート)のブランチ運用(PR)に従う。
(例: develop 集約なら origin/develop、main 集約なら origin/main)
5.1 コンフリクトチェック(必須)
git fetch origin
git merge-base --is-ancestor <BASE> HEAD
- exit 0: そのまま push 可能
- exit 1: base が先に進んでいる →
/rebase-resolver
5.2 PR作成
PR作成が必要なら /pr-creator を使う。