docs: READMEとIssue管理コマンドのドキュメントを更新し、ディレクトリ構成を明確化

Author: tonbiattack

README.md

@@ -419,13 +419,19 @@ Remove-Item -Recurse -Force "C:\path\to\git-plus"
 │   ├── gitcmd/           # Gitコマンド実行の共通ユーティリティ
 │   ├── ui/               # UI関連のユーティリティ
 │   └── pausestate/       # pause/resume状態管理
-├── docs/                  # ドキュメント
-│   └── commands/         # コマンド別ドキュメント
+├── doc/                  # READMEや社内向けのコマンドリファレンス
+│   └── commands/         # カテゴリ別ドキュメント
+├── docs/                  # 公開リポジトリに同期されるドキュメント
+│   └── commands/         # 公開用ドキュメント
 ├── main.go               # エントリーポイント
 ├── bin/                  # ビルド済みバイナリ
 └── go.mod
 ```
 
+補足:
+- `doc/` 配下がこのリポジトリの一次ソースであり、READMEや開発作業から直接リンクされています。
+- `docs/` は public リポジトリに同期される公開ドキュメントです。公開向けの調整が必要なときのみ編集します。
+
 ### 共通パッケージ
 
 #### `internal/gitcmd`

doc/commands/issue.md

@@ -230,3 +230,98 @@ Title: ダークモード対応
 - `gh auth login` でログイン済みである必要があります
 - タイトルと本文の両方を編集できます
 - タイトルは `Title:` の後に、本文は `---` の区切り線の後に記載します
+
+## git issue-list
+
+GitHubのopenしているissue一覧を取得し、番号で選択して編集・コメント追加・クローズ・新規作成・一括クローズを実行できる統合ビューアです。日常的なIssue対応をこの画面だけで完結できます。
+
+**使い方:**
+```bash
+git issue-list
+git issue-list -h              # ヘルプを表示
+```
+
+**処理フロー:**
+1. `gh issue list` でopenしているIssueを取得し、番号付きで一覧表示（タイトルと本文の冒頭をプレビュー）。
+2. 入力待ちのプロンプトで番号またはショートカットを受付。
+3. 番号を入力すると詳細ビューとアクションメニューを表示。
+4. 選択したアクションを実行後は再び一覧に戻り、必要な回数だけ繰り返し操作できます。
+
+**一覧画面で使える入力:**
+
+- `1`〜`n`: 指定したIssueの詳細を表示しアクションメニューへ。
+- `n`: 新しいIssueを作成（`git issue-create` と同じエディタフロー）。
+- `bc`: 表示中のIssueの中から複数件を選択して一括クローズ。
+- `q`: 即終了。
+- Enterのみ: 不正入力扱いで再度入力待ちになります。
+
+**アクションメニュー（番号入力後）:**
+
+- `e`: 選択したIssueをエディタで編集。
+- `m`: コメントを追加（本文だけ編集）。
+- `c`: コメント入力→Issueクローズ。コメントを空にするとコメント無しでクローズ。
+- `n`: 別の新規Issueを作成。
+- `b`: 一覧に戻る。
+- `q`: issue-list全体を終了。
+
+**主な機能:**
+- Issue一覧と本文プレビューの同時表示。
+- 詳細画面からそのまま編集/コメント/クローズを実行。
+- 一括クローズ操作（`bc`）を内蔵し、複数番号をまとめて処理可能。
+- 空のIssue一覧でも新規作成に誘導。
+- `git config core.editor` / `VISUAL` / `EDITOR` で設定されたエディタを自動利用。
+
+**注意事項:**
+- GitHub CLI (`gh`) が必要です。`gh auth login` 済みであることを確認してください。
+- 一括クローズ後は一覧が再取得され、直前の選択状態はリセットされます。
+- コメントやクローズ処理はIssueごとに逐次実行されるため、途中で失敗した場合も結果サマリーに成功/失敗件数が表示されます。
+
+## git issue-bulk-close
+
+複数のIssue番号を指定し、同じコメントを投稿してからまとめてクローズします。issue-listの `bc` からも内部的に呼び出されるほか、単独コマンドとしても利用できます。
+
+**使い方:**
+```bash
+git issue-bulk-close 12 15 18             # Issue 12,15,18 を一括クローズ（コメントはエディタ入力）
+git issue-bulk-close 42 43 -m "対応完了"   # 42と43を同じコメントでクローズ
+git issue-bulk-close １ ２ ３             # 全角数字も入力可
+git issue-bulk-close -h                   # ヘルプを表示
+```
+
+**オプション:**
+
+- `-m, --message <text>`: コメントを直接指定。省略すると一時ファイルをエディタで開いて入力。
+
+**処理フロー:**
+1. 引数のIssue番号を正規化（全角→半角、重複排除）し、openかどうかチェック。
+2. 対象Issueのタイトル一覧を表示して最終確認。
+3. コメントを取得（`-m` 指定時はそのまま使用、未指定時はエディタで入力）。空でも可。
+4. 各Issueに対してコメント投稿（任意）→`gh issue close` でクローズを順に実行。
+5. 成功/失敗件数をサマリー表示。
+
+**コメント入力テンプレート（エディタ起動時）:**
+```markdown
+# 一括クローズ用コメント
+#
+# 以下のissueに同じコメントを投稿してクローズします:
+# - Issue #12
+# - Issue #15
+# - Issue #18
+# ...
+# コメントを空にするとコメントなしでクローズされます。
+```
+
+**使用例:**
+```bash
+# バグ修正が完了したIssueをまとめて閉じる
+git issue-bulk-close 101 104 105 -m "Fix deployed to production"
+
+# コメントを書きながら確認したい場合
+git issue-bulk-close 21 22 23
+```
+
+**注意事項:**
+- GitHub CLI (`gh`) が必要です。`gh auth login` 済みであることを確認してください。
+- 既にクローズ済みのIssueは警告を出してスキップします。
+- コメントを空にするとコメント追加をスキップした状態でクローズのみ実行します。
+- 大量のIssueを指定した場合は順次処理されるため、途中で失敗した番号があっても残りは続行します。