# Shiiman Github:issue Create

> GitHub Issue を作成する。タスクは Issue 本文内でチェックボックスに分割。「Issue 作成」「Issue を作って」「タスクを Issue に」「Issue 追加」「チケット作成」「Issue を切る」「タスクを分割して Issue」などで起動。「ブランチも」「worktree も」と伝えれば作成後にブランチ/worktree も用意する。

- Skill: `shiiman/shiiman-github-issue-create` (Agent Skill)
- Install (CLI): `npx skillmds@latest add shiiman/shiiman-github-issue-create`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shiiman/shiiman-github-issue-create/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: shiiman (https://skillmd.com/u/shiiman)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/shiiman/shiiman-github-issue-create

---


# Create Issue

GitHub Issue を作成します。タスクは Issue 本文内でチェックボックスに分割します。

## Help

`$ARGUMENTS` に `--help` が含まれる場合、以下を表示して終了:

```text
/shiiman-github:issue-create - Create Issue

概要:
  GitHub Issue を作成します。
  タスクは Issue 本文内でチェックボックスに分割します。
  「ブランチも」「worktree も」と伝えれば作成後にブランチ/worktree も用意します。

使用方法:
  /shiiman-github:issue-create [タスク説明]

オプション:
  --help  このヘルプを表示

後続作成の伝え方（フラグの代わり）:
  「ブランチも作って」    → Issue 作成後にブランチを作成
  「worktree も」         → Issue 作成後に worktree を作成（gtr 使用）
  指定なし                → 作成後にブランチ/worktree を作るか確認

例:
  /shiiman-github:issue-create                    # Issue を作成
  「Issue を作ってブランチも切って」               # Issue 作成後にブランチも作成
  「Issue を作って worktree も用意して」           # Issue 作成後に worktree も作成

内部呼び出し用:
  --no-confirm  ユーザー確認をスキップして即座に作成（workflow から渡される）
```

## ワークフロー

### 1. タスクの確認

ユーザーから作成したいタスクの概要を聞く。

### 2. タスクの分割

タスクを Issue 本文内のチェックボックスに分割:

- 1 タスク = 具体的なアクション（「〜を追加」「〜を修正」「〜を削除」）
- 依存関係がある場合は順番に並べる
- テストやドキュメント更新も個別タスクとして記載

### 3. Issue 内容の確認

**`--no-confirm` なしの場合**:

作成する Issue の内容をユーザーに提示して確認:

```
以下の Issue を作成します:

タイトル: [{scope}] {title}
ラベル: {labels}

本文:
## 概要
{description}

## タスク
- [ ] {task1}
- [ ] {task2}
- [ ] {task3}

## 完了条件
- {condition1}
- {condition2}

よろしいですか？
```

**`--no-confirm` 指定時**:

ユーザー確認をスキップして即座に Issue を作成する。

### 4. Issue 作成

承認後（または `--no-confirm` 指定時は即座に）、`gh issue create` で Issue を作成。

**コマンドテンプレート**:

```bash
gh issue create \
  --title "[{scope}] {title}" \
  --body "## 概要

{description}

## タスク

- [ ] {task1}
- [ ] {task2}
- [ ] {task3}

## 完了条件

- {condition1}
- {condition2}
" \
  --label "{labels}"
```

### 5. 結果報告

作成した Issue の結果を報告:

```
Issue を作成しました:

- 番号: #{number}
- タイトル: [{scope}] {title}
- ラベル: {labels}
- URL: {issue_url}
```

### 6. ブランチもしくは worktree 作成（フラグの代わり）

引数・発話から後続作成の要否を判定する。

**「ブランチも」と判定した場合**:

作成した Issue の番号で `branch-create` の手順に従いブランチを自動作成する。

**「worktree も」と判定した場合**:

作成した Issue の番号で `worktree-create` の手順に従い worktree を自動作成する。

**発話に明示がない場合**:

`AskUserQuestion` で 1 回だけ確認する（読み取りではなく作成を伴うため）。

```text
question: "ブランチまたは worktree を作成しますか？"
options:
  - ブランチを作成: 作成した Issue の番号で branch-create を実行
  - worktree を作成: 作成した Issue の番号で worktree-create を実行
  - 作成しない: Issue 作成のみで終了
```

`--no-confirm` での内部呼び出し時（workflow など）は、呼び出し側の指定に従い、確認をスキップして指定された後続作成のみ行う。

## Issue タイトルの形式

`[{scope}] {title}`

- scope: 機能名や対象コンポーネント
- title: 具体的なタスク内容

## ラベルの自動判定

| 内容             | ラベル          |
| ---------------- | --------------- |
| 新機能           | `enhancement`   |
| バグ修正         | `bug`           |
| テスト           | `enhancement`   |
| ドキュメント     | `documentation` |
| リファクタリング | `improvement`   |

## 重要な注意事項

- ✅ タスクは Issue 本文内のチェックボックスで管理
- ✅ 完了条件を明確にする
- ✅ 具体的なアクションを記述
- ❌ 曖昧なタスク記述
- ❌ ブランチと worktree の同時作成はしない（どちらか一方のみ。両方求められた場合は worktree を優先して確認）