create-issue

create-issue

Create GitHub Issues in a parent-child structure.

Prerequisites

gh The CLI is installed and authenticated
gh auth status can be checked with

Flow

Step 1: Analyze the task content

Extract the following from the user's description:

Overview of the feature/fix
Background/motivation
Acceptance criteria
Breakdown into individual tasks

Step 2: Create the parent Issue

gh issue create \
  --title "feat: 機能名" \
  --body "$(cat <<'EOF'
## 概要
...

## 背景
...

## 受け入れ条件
- [ ] 条件1
- [ ] 条件2

## 関連
- Figma: ...
- 関連 Issue: #...
EOF
)"

The title should be in Conventional Commits format: feat:, fix:, chore: , etc.

Step 3: Create child Issues

Create each individual task as a child Issue:

gh issue create \
  --title "feat: タスク名" \
  --body "..."

Step 4: Link them as Sub-issues

gh api Use this to add child Issues to the parent's sub-issues:

gh api \
  --method POST \
  repos/{owner}/{repo}/issues/{parent_number}/sub_issues \
  -f sub_issue_id={child_number}

Step 5: Return the Issue URLs

List the URLs of the created parent Issue and child Issues.

Notes

Issue titles are recommended to use the Conventional Commits format
Child Issues should be granular enough to be completed independently
If labels or milestones are needed, confirm with the user