ousiass issue-split
大きなIssue（spec-genで作成した仕様書Issue等）を、実装可能なスコープ単位のサブissueに分割する。 各サブissueの内容をユーザーと1つずつ確認しながら作成する。
前提条件
- Claude Code 環境
ghCLI（認証済み）
引数
- Issue 番号 (例:
/issue-split #123): 分割対象のGitHub Issue - Issue URL (例:
/issue-split https://github.com/owner/repo/issues/123): 同上 - 引数なし: ユーザーにIssue番号をヒアリング
フェーズ1: Issue取得と分析
gh issue view <番号> --json title,body,labels,urlで元Issueを取得- Issue本文にリンクされた仕様書があれば Read で読み込む
- Glob で
**/spec/**/*.md,**/specs/**/*.md,**/docs/**/*.mdも探索
- Glob で
- 要件の全体像を把握し、TaskCreate で「Issue分割」タスクを作成
フェーズ2: スコープ分割の提案
Issueの内容を独立して実装できるスコープ単位に分割する
- 典型的な分割軸: 環境構築、バックエンド（API/DB）、フロントエンド、テスト/CI等
- 依存関係を考慮し実装順を決定
AskUserQuestionのpreviewに分割一覧を表示して確認するpreview に載せるフォーマット:
1. <タイトル> [依存: なし] 概要: ... 2. <タイトル> [依存: #1] 概要: ...選択肢:
- この分割でOK — そのまま進む
- もっと細かく分けたい — 指定スコープをさらに分割
- もっとまとめたい — スコープを統合
- 分割を修正したい — 自由記述で調整
ユーザーが納得するまで繰り返す
フェーズ3: 各サブissueの対話的確認
スコープごとに以下を繰り返す（実装順に1つずつ）:
3-1: サブissue下書き作成
元Issueと仕様書から該当スコープの情報を抽出し、下書きを作成する:
- タイトル:
<type>: <スコープの実装内容>（implスキルがそのまま使えるタイトル）- type はスコープの性質で選択:
feat（機能）,chore（環境構築）,test（テスト/CI）,docs（ドキュメント）等
- type はスコープの性質で選択:
- 本文:
templates/sub-issue.mdのフォーマットに従う - ラベル: 元Issueのラベルを引き継ぎ + スコープ別ラベル（例:
scope:backend,scope:frontend）があれば付与
3-2: ユーザー確認
AskUserQuestion で下書きをプレビュー表示し確認:
- このまま作成する
- 修正してから作成する — 修正点を記述 → 反映 → 再確認
- このスコープはスキップする
フェーズ4: サブissue作成とリンク
承認済みの各サブissueを
gh issue createで作成- ラベル指定:
--label <label1> --label <label2> - 作成したissue番号を記録
- ラベル指定:
親Issueの本文末尾にサブissue一覧を追記する:
gh issue view <番号> --json body -q .bodyで既存本文を取得- 末尾に「## サブissue」セクションを追加（既にあれば既存リンクを残して追記）
## サブissue 実装順に記載: - [ ] #<番号> <タイトル> - [ ] #<番号> <タイトル> - 一時ファイルに書き出し
gh issue edit <番号> --body-file <一時ファイル>で更新 - 一時ファイルを削除
作成結果のサマリーをユーザーに報告:
- 親Issue URL
- 各サブissue URL と実装順
implスキルでの実行例:/impl #<最初のサブissue番号>
ルール
- 質問には必ず
AskUserQuestionを使い選択式で提示する。テキストだけで質問しない - 1回あたり4問以内にまとめる
- 各選択肢の
descriptionに判断材料を記載する - サブissueのタイトルは
implスキルが読んで実装に取り組める形式にする - Issue作成前に必ずユーザーの承認を得る
- 元Issueの内容を改変しない（サブissueセクションの追記のみ）
- TaskCreate/TaskUpdate で進捗を管理する