GitHub Issues/Projects活用ガイド - タスク管理とプロジェクト運営の実践

1

git --version

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

┌─────────────────────────────────────────────────────────────┐
│  Issue #42: ログイン画面のバリデーション追加                    │
├─────────────────────────────────────────────────────────────┤
│  Title（タイトル）: 簡潔で内容がわかるタイトル                   │
│  Description（本文）: 詳細な説明、再現手順、期待される動作        │
├─────────────────────────────────────────────────────────────┤
│  サイドバー                                                   │
│  ├─ Assignees: 担当者                                        │
│  ├─ Labels: ラベル（bug, enhancement等）                     │
│  ├─ Projects: 関連するProject                                │
│  ├─ Milestone: マイルストーン                                 │
│  └─ Development: 関連するPR/ブランチ                          │
├─────────────────────────────────────────────────────────────┤
│  Comments: チームメンバーからのコメント・議論                   │
└─────────────────────────────────────────────────────────────┘

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

## バグの概要
ログインフォームで空のパスワードを送信できてしまう

## 再現手順
1. ログイン画面にアクセスする
2. メールアドレスを入力する
3. パスワード欄を空のままにする
4. 「ログイン」ボタンをクリックする

## 期待される動作
パスワードが空の場合、エラーメッセージが表示され送信がブロックされる

## 実際の動作
パスワードが空でもリクエストが送信され、サーバーエラーが発生する

## 環境
- OS: Windows 11
- ブラウザ: Chrome 120
- アプリバージョン: v1.2.3

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

## 機能の概要
ダークモードの実装

## 背景・動機
夜間にアプリを使用する際、画面が眩しく目が疲れるというフィードバックが複数寄せられている

## 提案する解決策
- システム設定に連動するダークモード切り替え機能
- 手動でのテーマ切り替えオプション
- 設定の永続化

## 代替案
- ブラウザ拡張機能での対応（ただし一貫性に欠ける）

## 追加情報
参考デザイン: [リンク]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

カテゴリ別ラベル:
├─ type: bug        （赤系）   バグ報告
├─ type: feature    （緑系）   新機能
├─ type: refactor   （青系）   リファクタリング
├─ type: docs       （黄系）   ドキュメント
└─ type: test       （紫系）   テスト関連

優先度ラベル:
├─ priority: high   （赤）     高優先度
├─ priority: medium （橙）     中優先度
└─ priority: low    （灰）     低優先度

ステータスラベル:
├─ status: blocked      ブロック中
├─ status: in-progress  作業中
├─ status: review       レビュー待ち
└─ status: ready        着手可能

対象コンポーネント:
├─ area: frontend   フロントエンド
├─ area: backend    バックエンド
├─ area: database   データベース
└─ area: infra      インフラ

1
2
3
4
5

label:bug label:"priority: high"
# バグかつ高優先度のIssueを検索

label:enhancement -label:wontfix
# 新機能要望で対応予定のあるものを検索

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

┌─────────────────────────────────────────────────────────────┐
│  Milestone: v1.0.0                                          │
│  Due: 2026-01-31                                            │
├─────────────────────────────────────────────────────────────┤
│  Progress: ████████████░░░░░░░░ 60%                         │
│                                                             │
│  Open: 4 issues    Closed: 6 issues                         │
├─────────────────────────────────────────────────────────────┤
│  Open Issues:                                               │
│  ├─ #42 ログイン画面のバリデーション追加                       │
│  ├─ #45 パスワードリセット機能                                │
│  ├─ #48 エラーハンドリングの改善                              │
│  └─ #50 ユニットテストの追加                                  │
└─────────────────────────────────────────────────────────────┘

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

┌─────────────────────────────────────────────────────────────────────┐
│                    Project: Sprint 2026-01                          │
├─────────────────┬─────────────────┬─────────────────┬───────────────┤
│   Backlog (5)   │  In Progress (2)│   Review (1)    │   Done (8)    │
├─────────────────┼─────────────────┼─────────────────┼───────────────┤
│ ┌─────────────┐ │ ┌─────────────┐ │ ┌─────────────┐ │ ┌───────────┐ │
│ │ #55 検索機能│ │ │ #42 バリデ  │ │ │ #38 API修正 │ │ │ #30 完了  │ │
│ │ enhancement │ │ │ ーション    │ │ │ @alice      │ │ │           │ │
│ └─────────────┘ │ │ @bob        │ │ └─────────────┘ │ ├───────────┤ │
│ ┌─────────────┐ │ └─────────────┘ │                 │ │ #31 完了  │ │
│ │ #56 通知機能│ │ ┌─────────────┐ │                 │ │           │ │
│ │ enhancement │ │ │ #45 リセット│ │                 │ └───────────┘ │
│ └─────────────┘ │ │ @carol      │ │                 │      ...      │
│      ...        │ └─────────────┘ │                 │               │
└─────────────────┴─────────────────┴─────────────────┴───────────────┘

1
2
3
4
5

| Title              | Status      | Priority | Assignee | Due Date   |
|--------------------|-------------|----------|----------|------------|
| #42 バリデーション  | In Progress | High     | bob      | 2026-01-15 |
| #45 リセット機能    | In Progress | Medium   | carol    | 2026-01-20 |
| #55 検索機能        | Backlog     | Low      | -        | -          |

1
2
3
4
5

## 変更内容
ログインフォームにバリデーションを追加しました。

## 関連Issue
Closes #42

1
2
3
4
5

## 変更内容
認証機能の改善を行いました。

## 関連Issue
Closes #42, closes #45, closes #48

1

Fixes owner/repository#123

1
2
3

git commit -m "Add password validation

Closes #42"

1
2
3

## 変更内容
#42 に関連するリファクタリングを行いました。
（このPRでは完全には解決しません）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

1. 機能やバグを Issue として登録
   ├─ ラベル: type: feature / type: bug
   └─ 優先度を設定（任意）

2. Project のカンバンで管理
   ├─ Backlog → In Progress → Done
   └─ 着手時に自分をアサイン

3. ブランチ作成とPR
   ├─ Issue から「Create a branch」
   ├─ 作業完了後に PR 作成
   └─ 説明文に「Closes #番号」

4. マージで自動クローズ

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

Sprint Planning:
├─ バックログからSprintに含めるIssueを選定
├─ マイルストーンを設定（例: Sprint 2026-01）
├─ 担当者をアサイン
└─ 見積もり（ストーリーポイント）を設定

Daily Work:
├─ Projectボードで自分のタスクを確認
├─ ステータスを「In Progress」に変更
├─ Issueからブランチを作成
├─ 実装・テスト
├─ PR作成（Closes #番号 を記載）
└─ レビュー後にマージ

Sprint Review:
├─ マイルストーンの進捗を確認
├─ 完了率、残タスクの確認
└─ 振り返りと次Sprintの計画

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

# .github/ISSUE_TEMPLATE/bug_report.yml
name: Bug Report
description: バグの報告
labels: ["type: bug"]
body:
  - type: textarea
    id: description
    attributes:
      label: バグの概要
      description: 発生している問題を簡潔に説明してください
    validations:
      required: true
  - type: textarea
    id: steps
    attributes:
      label: 再現手順
      description: バグを再現するための手順
      placeholder: |
        1. '...'に移動する
        2. '...'をクリックする
        3. エラーが発生する
    validations:
      required: true
  - type: textarea
    id: expected
    attributes:
      label: 期待される動作
    validations:
      required: true
  - type: textarea
    id: environment
    attributes:
      label: 環境情報
      placeholder: |
        - OS: Windows 11
        - ブラウザ: Chrome 120

1
2

main ← feature-a : Closes #42 → Issueがクローズされる
develop ← feature-a : Closes #42 → Issueはクローズされない（developがデフォルトでない場合）