audit-workitem-for-spark

Decompose work items into small verifiable tasks for Codex Spark sessions.

Updated Dec 20, 2025
One-click install
npx skills add https://github.com/koala-man-64/helpful-scripts --skill audit-workitem-for-spark-koala-man-64
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit-workitem-for-spark
Source: https://github.com/koala-man-64/helpful-scripts/tree/main/.codex/skills/audit-workitem-for-spark
Command: npx skills add https://github.com/koala-man-64/helpful-scripts --skill audit-workitem-for-spark-koala-man-64

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large or ambiguous work items from Azure DevOps, Jira, or GitHub are hard to hand to a fast interactive coding agent. This Skill audits a work item, inspects the relevant repository areas, and breaks it into small, independent, verifiable implementation tasks sized for Codex Spark. ## Core Features & Use Cases - Work-item audit: Reads title, description, acceptance criteria, comments, and linked artifacts, then inspects affected code boundaries and test coverage to establish evidence. - Spark suitability test: Classifies each task against criteria like one-sentence outcomes, narrow file scope, simple verification commands, and low blast radius, flagging long-horizon or human-decision work separately. - Structured backlog output: Produces a dependency-ordered task table with goals, scope, acceptance checks, and ready-to-send Spark prompts, plus an execution order with parallelizable tasks. - Use Case: Paste a Jira story asking to add a new API endpoint and receive a breakdown separating contract definition, implementation, focused tests, and documentation, each with its own Spark prompt. ## Quick Start Ask the agent to audit this work item and break it into Spark-sized implementation tasks with acceptance checks and prompts.

Frequently Asked Questions about audit-workitem-for-spark

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

FAQPage Schema
How do I break a work item into tasks for Codex Spark?▼

Provide the work item text or link and ask for a Spark breakdown. The Skill inspects the relevant repository areas, applies a suitability test, and returns a dependency-ordered task table with goals, scope, acceptance checks, and ready-to-send Spark prompts.

What makes a task suitable for Codex Spark?▼

A task is Spark-suitable when it has a one-sentence outcome, a narrow bounded set of files, no unresolved product or architecture decisions, a simple verification command or test, and a low blast radius with a safe reviewable diff.

Can this Skill audit Jira or Azure DevOps work items?▼

Yes, it accepts Azure DevOps, Jira, GitHub, or plain-text work items. It reads the title, description, acceptance criteria, comments, and linked artifacts before inspecting the affected repository areas.

When should a task not be assigned to Codex Spark?▼

Avoid Spark for ambiguous stories, multi-service architecture, broad refactors, database migrations, security-sensitive changes, and cross-repository coordination. The Skill marks these as long-horizon or human-decision items with the boundary to resolve first.

Does the Skill implement the code changes itself?▼

No, it only audits and decomposes the work item into an execution plan. It does not implement code or alter the work item unless explicitly asked.