AgentSkillsCN

epic.decompose

epic.decompose

SKILL.md

epic.decompose

Take an Epic (as Markdown) and decompose it into user stories. Analyzes Epic document and identifies major deliverables, grouping them by persona or capability.

Overview

Purpose: Take an Epic (as Markdown) and decompose it into user stories. Analyzes Epic document and identifies major deliverables, grouping them by persona or capability.

Command: /epic/decompose

Usage

Basic Usage

bash
python3 skills/epic/decompose/epic_decompose.py

With Arguments

bash
python3 skills/epic/decompose/epic_decompose.py \
  --epic_file_(string,_required):_path_to_the_epic.md_file_to_decompose "value" \
  --max_stories_(integer,_optional):_maximum_number_of_stories_to_generate_(default:_5) "value" \
  --output_path_(string,_optional):_where_to_save_the_stories.json_file_(default:_./stories.json) "value" \
  --output-format json

Inputs

  • •epic_file (string, required): Path to the epic.md file to decompose
  • •max_stories (integer, optional): Maximum number of stories to generate (default: 5)
  • •output_path (string, optional): Where to save the stories.json file (default: ./stories.json)

Outputs

  • •stories.json: Structured JSON list of story summaries with persona, goal, benefit, and acceptance criteria

Artifact Metadata

Consumes

  • •agile-epic

Produces

  • •user-stories-list

Examples

  • •python3 skills/epic.decompose/epic_decompose.py --epic-file ./epic.md --max-stories 5

Permissions

  • •filesystem:read
  • •filesystem:write

Implementation Notes

Parse Markdown structure to extract Epic components. Use NLP techniques to identify distinct user stories. Ensure stories are independent and testable (INVEST criteria). Generate meaningful acceptance criteria. Validate output against JSON schema. Include metadata for traceability to source Epic.

Integration

This skill can be used in agents by including it in skills_available:

yaml
name: my.agent
skills_available:
  - epic.decompose

Testing

Run tests with:

bash
pytest skills/epic/decompose/test_epic_decompose.py -v

Created By

This skill was generated by meta.skill, the skill creator meta-agent.

Part of the Betty Framework