Skip to content

feat(#108): /tickets-batch skill — bulk-file structured tickets in one flow#127

Merged
atlas-apex merged 1 commit into
devfrom
feature/GH-108-tickets-batch-skill
Apr 25, 2026
Merged

feat(#108): /tickets-batch skill — bulk-file structured tickets in one flow#127
atlas-apex merged 1 commit into
devfrom
feature/GH-108-tickets-batch-skill

Conversation

@atlas-apex

Copy link
Copy Markdown
Collaborator

User Story

As a Chief-of-Staff or tech lead kicking off a piece of work that decomposes into 5–20 tickets, I want a skill that files them all in one flow — without the slow interactive path (/feature × 20 = ~100 turns) or the non-conformant fast path (raw gh issue create with whatever shape the agent invents).

Summary

New skill /tickets-batch at .claude/skills/tickets-batch/SKILL.md. Bulk-files a numbered/bulleted list (or markdown file) of ticket titles by:

  1. Resolving the repo (session marker → registry → ask).
  2. Asking SHARED-CONTEXT questions once for the whole batch: default priority, optional epic, optional area labels, repo confirmation.
  3. Per ticket, a 3-question micro-interview: type (Feature/Bug/Chore/Refactor/Testing/CI/Docs), one-line purpose, optional clarification when the inferred body is low-confidence.
  4. Showing the full batch summary table for confirmation.
  5. Filing each via gh issue create — output conforms to .ticket.required_sections (from [Chore] Make ticket-prefix whitelist + schema project-configurable (not hardcoded) #109 + [Chore] validate-issue-structure.sh — config-driven PreToolUse hook for gh issue create #107) by construction.
  6. On first failure: stop, surface the validator error, ask retry/skip/edit/abort.

The skill replaces the bypass scenario where an agent files 10 tickets via raw gh issue create with bespoke bodies (the failure mode that triggered apexyard#107 + the related skill-discipline memory). Now the happy path matches the team standard.

Schema source: .ticket.prefix_whitelist, .ticket.label_priority_scheme, and .ticket.required_sections from project config — no hardcoding, so future schema rolls forward without touching the skill.

Testing

Skills are markdown specs — no shell test fixture. Behaviour is exercised by the agent following the spec. Conformance is enforced at file time by validate-issue-structure.sh (#107) — the skill produces output that passes that hook.

Smoke check on conformance:

# Spec must reference required_sections per type — verified by inspection
grep '## Required body shape' .claude/skills/tickets-batch/SKILL.md
# Spec must call gh issue create per-ticket (not batch-API), so the validator runs per-issue
grep 'gh issue create' .claude/skills/tickets-batch/SKILL.md

Real dogfood will be the next batch-file moment (e.g. a project kickoff with 5+ tickets) — the spec is followable as-is, and any rough edges surface there.

Scope — what this does NOT do

Glossary

Term Definition
Bulk-file flow Filing 5+ tickets in one user intent. Without /tickets-batch, agents had to choose between slow interactive (~10 questions × N) or non-conformant raw gh issue create.
Shared-context questions Asked ONCE at the start: priority, epic, areas, repo. Apply to every ticket in the batch.
Per-ticket micro-interview Capped at 3 questions (type, purpose, optional clarification). Inference from purpose generates the body, which conforms to .ticket.required_sections by construction.
Conformance by construction The skill's output matches the validator's schema because the skill knows the schema, not because output is checked post-hoc.

Closes #108

Loading
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants