---
description: 新規タスクをGitHub Issueとして作成し、親issueとのリンクを自動管理。進捗ドキュメントのTasksセクションは不使用
---

# /issync:create-sub-issue: サブissue作成オペレーション

新規タスクをGitHub Issueとして作成し、以下を自動化：
1. タスク概要入力（インタラクティブ: 1つ / 引数: 複数可）
2. 親issue情報取得（`.issync/state.yml`）
3. LLMによるタイトル・本文生成
4. Issue作成（`ISSYNC_LABELS_AUTOMATION=true`の場合、`issync:plan`ラベル自動付与）
5. Sub-issues API連携（親issue紐づけ + 順序維持）

## コンテキスト

**横断的オペレーション** - どのステートでも実行可能（plan、poc、architecture-decision、implement）

**設計原則**:
- GitHub Sub-issuesを完全なSSOTとする（進捗ドキュメントのTasksセクション不使用）
- ユーザー入力は簡潔な概要のみ（LLMが適切なタイトル・本文を自動生成）
- Sub-issues APIで親issueと自動リンク、順序維持

## 使用方法

```bash
/issync:create-sub-issue                             # インタラクティブモード（1つ）
/issync:create-sub-issue "概要1" "概要2"            # 引数モード（複数可）
```

**入力例**: "Status変更時の自動アクション" "コマンド実装" など簡潔でOK

**推奨ワークフロー**:
- 基本: 1つずつ作成 → `/issync:plan`で詳細化 → 必要に応じて孫issue作成
- 複数の独立タスクが明確な場合のみ引数モードで一括作成

## 前提条件

- `.issync/state.yml`存在（`issync init`完了済み）
- `ISSYNC_GITHUB_TOKEN`環境変数設定
- `gh` CLIインストール済み
- `ISSYNC_LABELS_AUTOMATION=true`設定時: リポジトリに`issync:plan`ラベルが存在すること

## 実行ステップ

### ステップ1: 環境変数確認 & モード決定

ラベル自動付与の有効化状態を確認し、以降のステップで使用するモードフラグを設定。

**環境変数**:
```bash
ISSYNC_LABELS_AUTOMATION               # ラベル自動付与モード ("true" で有効)
```

**モード決定**:
- **ラベル自動付与**: `ISSYNC_LABELS_AUTOMATION="true"`で有効 (未設定時はステップ6のラベル付与をスキップ)

**出力**: 設定状態をユーザーに表示
```markdown
## Environment Check
**Label Automation**: {有効/無効}
```

### ステップ2: タスク概要の入力

- **インタラクティブモード**: プロンプトでタスク概要を1つ入力
- **引数モード**: コマンドライン引数から複数取得

### ステップ3: 親issue情報を取得

`issync status <親issue URL>`を実行し、以下を取得:
- `issue_url`: 親issueのURL
- `local_file`: 進捗ドキュメントのパス

### ステップ4: 親issueコンテキスト抽出

進捗ドキュメント全体を読み込み、LLMが以下を理解:
- Purpose/Overview: 目的、コアバリュー
- Context & Direction: 背景、設計哲学
- Specification: 仕様、アーキテクチャ（存在時）

### ステップ5: タイトル・本文生成

**タイトル**: 「{動詞} + {対象}」形式、10-30文字、親issueのスタイルに合わせる

**本文テンプレート**:
```markdown
Part of #{親issue番号}

## 目的
{タスクの具体的な目的（1-2文）}

## 背景
{親issueから関連情報を抽出・要約}

## 完了条件
- [ ] {完了条件（3-5項目）}
- [ ] コードレビュー完了
- [ ] ドキュメント更新完了

## 関連
- 親issue: #{親issue番号}
- 詳細: [親issueを見る]({親issueのURL})
```

### ステップ5.5: 既存issueの重複チェック

類似タスクが既に存在しないか検索し、重複作成を防ぐ。

**検索実行**:
```bash
gh search issues --repo {owner}/{repo} "{キーワード1} {キーワード2}" \
  --json number,title,url,state,labels --limit 5
```
- LLMがタイトルから主要キーワード抽出（動詞・名詞中心、2-3語）
- 検索対象: リポジトリ内全issue（open/closed）、親issueのsub-issues優先

**類似issue検出時の確認**:
```
⚠️  類似する既存issueが見つかりました:
#123 [open]: Status変更時の自動通知機能を実装

このまま新規issue作成を続けますか？ (y/n)
```
- `y`: ステップ6へ進む
- `n`: キャンセル、既存issue利用を推奨

**エラー時**: 警告表示後、検索スキップして続行

### ステップ6: ユーザー確認

生成したタイトル・本文プレビューを提示し、承認後に作成（`y`/`n`）

### ステップ7: Issue作成とSub-issues連携

**ラベル付与**:
ステップ1で確認したラベル自動付与モードが有効な場合、`--label "issync:plan"`を付与してissue作成。
未設定の場合はラベルなしで作成。

**処理フロー**:
```bash
PREV_SUB_ISSUE_ID=""
for i in "${!GENERATED_TITLES[@]}"; do
  TITLE="${GENERATED_TITLES[$i]}"
  BODY="${GENERATED_BODIES[$i]}"

  # ISSYNC_LABELS_AUTOMATIONに応じてラベル付与
  ISSUE_URL=$(gh issue create --repo {owner}/{repo} --title "$TITLE" --body "$BODY")
  ISSUE_NUMBER=$(echo $ISSUE_URL | grep -o '[0-9]*$')
  SUB_ISSUE_ID=$(gh api /repos/{owner}/{repo}/issues/$ISSUE_NUMBER --jq .id)

  # Sub-issueとして紐づけ
  gh api --method POST /repos/{owner}/{repo}/issues/{親issue番号}/sub_issues \
    -F "sub_issue_id=$SUB_ISSUE_ID"

  # 2つ目以降は順序設定
  if [ -n "$PREV_SUB_ISSUE_ID" ]; then
    gh api --method PATCH /repos/{owner}/{repo}/issues/{親issue番号}/sub_issues/priority \
      --input - << EOF
{
  "sub_issue_id": $SUB_ISSUE_ID,
  "after_id": $PREV_SUB_ISSUE_ID
}
EOF
  fi

  PREV_SUB_ISSUE_ID=$SUB_ISSUE_ID
done
```

### ステップ8: GitHub Projects Status設定（オプション）

`gh issue edit`でStatus=planを設定（利用不可時は手動設定を案内）

## 出力フォーマット

完了後、以下を表示:
- 作成されたサブissueリスト（URL、タイトル）
- Sub-issues紐づけ結果
- `ISSYNC_LABELS_AUTOMATION=true`の場合:
  - `issync:plan`ラベル付与確認
  - **auto-planワークフロー自動実行**のため、手動`/issync:plan`実行不要
  - GitHub Actionsタブで実行状況確認可能
- 未設定の場合:
  - 手動で`/issync:plan`実行が必要

## 重要な注意事項

**必須要件**:
- ステップ1で環境変数を確認し、モードフラグを設定（以降のステップで参照）
- 親issueの進捗ドキュメント全体読み込み（`.issync/state.yml`のlocal_fileパス使用）
- タイトル・本文はLLM生成、ユーザー確認必須
- gh CLI使用、内部ID使用（`gh api .../issues/{番号} --jq .id`）
- `ISSYNC_LABELS_AUTOMATION=true`の場合、`issync:plan`ラベル自動付与
  - auto-planワークフローが自動トリガーされ、進捗ドキュメントが自動作成される

**Sub-issues API**:
- 処理順: Issue作成 → 内部ID取得 → Sub-issues紐づけ → 順序設定（`after_id`）
- JSON payload使用、エラー時は処理継続して報告

**その他**:
- 進捗ドキュメント非変更（Tasksセクション削除済み、タスク管理はGitHub Sub-issuesに完全移行）
- エラーハンドリング: `state.yml`/`gh` CLI不在時は終了、Issue作成失敗時は部分成功も記録

## 実行例

**インタラクティブモード**: `/issync:create-sub-issue`
1. タスク概要入力: "Status変更時の自動アクション"
2. LLMがタイトル生成（例: "Status変更時の自動アクション機能を設計"）
3. ユーザー確認 → Issue作成
4. `ISSYNC_LABELS_AUTOMATION=true`の場合:
   - `issync:plan`ラベル付き → auto-planワークフロー自動実行 → 進捗ドキュメント作成

**引数モード**: `/issync:create-sub-issue "自動アクション設計" "/issync:create-sub-issue実装"`
1. 複数タスクを一括作成
2. Sub-issues順序設定で作成順序維持
3. `ISSYNC_LABELS_AUTOMATION=true`の場合:
   - 各サブissueに対しauto-planワークフロー順次実行