issue-management-guidelines

# Issue Management Guidelines

## 概要

このSkillは、Issueの作成、分類、管理に関するガイドラインを定義する。適切なIssue管理により、タスクの可視化、優先順位付け、進捗管理を効率的に行うことを目的とする。

## 責任範囲

このSkillは以下の範囲をカバーする:

- Issue作成時の記述ガイドライン（タイトル、本文、再現手順）
- Issueテンプレートの定義と使用方法
- Issueの分類とラベル運用ルール
- Issueのライフサイクル管理（作成、割り当て、進捗更新、クローズ）
- Issueのクローズ基準と完了条件
- IssueとPull Requestの関連付け方法

## 基本方針

- タイトルは簡潔で具体的にする
- 本文には必要十分な情報を記載する
- AI自動生成署名を記述しない
- 原則として英語で記述する（チームの主要言語が英語以外の場合はその言語の使用を許可）
- プロジェクトにテンプレートがある場合はそちらを優先的に使用する
- 適切なラベルを付けて分類する
- 担当者とマイルストーンを明確にする
- Issueの状態を最新に保つ
- 完了条件を明確にする
- 関連するIssueやPRを相互に参照する

## Issue作成ガイドライン

### タイトルの書き方

- 簡潔で具体的にする（50文字以内を推奨）
- 実装内容や問題の本質を端的に表現する
- プレフィックスを付けて種類を明示する（任意）

良い例:

```text
Implement user authentication feature
Improve product search performance
Fix email input issue on login screen
```

悪い例:

```text
修正
バグ
機能追加してほしい
エラーが出る
🤖 Generated with [Claude Code](https://claude.com/claude-code)
```

### プレフィックスの使用（任意）

- プロジェクトで統一する場合は、以下のようなプレフィックスを使用する

```text
feat: 新機能の追加
fix: バグ修正
docs: ドキュメント更新
refactor: リファクタリング
test: テスト追加・修正
perf: パフォーマンス改善
chore: ビルドプロセス、ツール設定など
```

良い例:

```text
feat: ユーザープロフィール編集機能を追加
fix: ログイン時のセッションタイムアウト問題を修正
docs: API仕様書にエンドポイント説明を追加
```

### 本文の書き方

- 背景、目的、詳細を明確にする
- 再現手順（バグの場合）を記載する
- 期待する動作と実際の動作を記載する
- スクリーンショットやログを添付する

良い例:

```markdown
## 背景
ユーザーから商品検索が遅いという報告が複数件寄せられている。

## 現状の問題
商品検索に平均3秒かかっており、ユーザー体験を損なっている。

## 目的
検索クエリの最適化により、応答時間を1秒以内に短縮する。

## 詳細
- 検索対象: 商品名、カテゴリ、タグ
- データ件数: 約10万件
- 現在のクエリ: 全文検索をループ処理で実施

## 期待する改善内容
- データベースインデックスの追加
- クエリの最適化
- キャッシュの導入
```

バグ報告の場合:

```markdown
## 概要
ログイン画面でメールアドレスが入力できない。

## 再現手順
1. ログイン画面を開く
2. メールアドレス入力欄をクリックする
3. キーボードで入力を試みる

## 期待する動作
メールアドレスが入力できる。

## 実際の動作
入力欄がフォーカスされず、キーボード入力が反映されない。

## 環境
- OS: Windows 11
- ブラウザ: Chrome 120.0
- デバイス: PC

## スクリーンショット
（添付）
```

### 完了条件の明記

- Issueをクローズする条件を明確にする
- 受け入れ基準（Acceptance Criteria）を記載する

良い例:

```markdown
## 完了条件
- [ ] 商品検索の応答時間が1秒以内になる
- [ ] 既存の検索機能が正常に動作する
- [ ] テストケースが追加される
- [ ] パフォーマンステストに合格する
```

## Issueテンプレート

### テンプレートの種類

プロジェクトで以下のテン