split-issue

Create and wire child GitHub issues from an approved split plan.

11|Updated Dec 28, 2024
One-click install
npx skills add https://github.com/wadvanced/aurora_uix --skill split-issue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: split-issue
Source: https://github.com/wadvanced/aurora_uix/tree/main/.claude/skills/split-issue
Command: npx skills add https://github.com/wadvanced/aurora_uix --skill split-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns an already-defined split plan into real GitHub child issues, keeping all related context in sync and making progress visible through issue linkages and labels.

Core Features & Use Cases

  • Executes an approved split plan by reading the parent issue’s evaluation block and the chosen split strategy recorded by evaluate-issue.
  • Creates and links child issues idempotently (reuses existing open issues when possible; otherwise creates missing ones and records the mapping).
  • Slices the parent’s enriched spec into scoped scope-briefs so each child contains only the relevant Summary, ACs, files, and conventions.
  • Wires parent ↔ children state by updating the parent’s split-children task list and writing a Created children mapping back into the evaluation block.
  • Optionally auto-enriches children by running improve-issue sequentially on newly created issues.
  • Supports two test-ownership strategies (parent-owned integrated tests vs sibling-owned integrated tests with a synthetic test child).

Quick Start

Run /skill split-issue with the parent issue number (or URL) that already contains a Chosen split plan from evaluate-issue.

Frequently Asked Questions about split-issue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I split a GitHub issue into tracked child work?

To split a GitHub issue into tracked child work, you execute a previously-approved split plan that reads the parent issue's enriched spec and creates scoped child issues with correct labels, acceptance criteria, and parent-child linkages.

What is the best way to automate GitHub issue splitting from a spec?

Automating GitHub issue splitting requires executing an approved split strategy that slices the parent's enriched spec into scoped child briefs, creating missing issues idempotently while updating the parent's split-children task list and evaluation mappings.

Do I need a pre-approved split plan before creating child GitHub issues?

Yes, you need a pre-approved split plan. The workflow requires the parent issue to contain an evaluation block with a chosen split strategy specifying titles, acceptance criteria, files, dependencies, and model tiers for each child before creation begins.

Can I reuse existing open issues when splitting a parent GitHub issue?

Yes, the splitting process handles child issues idempotently by reusing existing open issues when possible, otherwise creating missing ones and recording the mapping back into the parent's evaluation block.

How does issue splitting handle test ownership for child issues?

Issue splitting supports two test-ownership strategies: parent-owned integrated tests where the parent retains test responsibility, and sibling-owned integrated tests utilizing a synthetic test child issue for coverage.

Can child GitHub issues be automatically enriched after splitting?

Yes, newly created child issues can be auto-enriched by sequentially running an improve-issue process on them, adding further context and detail to the scoped child briefs generated during the split.