JIRA
Interact with Mozilla JIRA via scripts/extract_jira.py.
Prerequisites
export JIRA_API_TOKEN="your-api-token" # From https://id.atlassian.com/manage-profile/security/api-tokens
export JIRA_EMAIL="your@email.com"
Optional: JIRA_OUTPUT_DIR, JIRA_DEFAULT_PROJECT. Precedence: CLI args > env vars > config.toml > defaults.
Usage
uv run ~/.claude/skills/jira/scripts/extract_jira.py [options]
| Operation | Command |
|---|---|
| Query current sprint | --current-sprint --summary |
| Query your issues | --my-issues |
| Query specific issue | --jql "key = RELOPS-123" |
| Create issue | --create --create-summary "Title" |
| Modify issue | --modify RELOPS-123 --set-status "In Progress" |
| Append description | --modify RELOPS-123 --append-description "New notes" |
| Edit comment | --modify RELOPS-123 --edit-comment 1242534 --comment-body "Updated content" |
| Link issues | --modify RELOPS-123 --link-issue RELOPS-456 |
| Output to stdout | --stdout --quiet |
Markdown Formatting
Use standard Markdown for descriptions and comments. The tool automatically converts Markdown to Atlassian Document Format (ADF).
DO NOT use old Jira wiki markup syntax like [text|url] - it will not render correctly.
| Element | Correct (Markdown) | Wrong (Wiki Markup) |
|---|---|---|
| Links | [text](https://url) | [text|https://url] |
| Bold | **text** | *text* |
| Lists | - item or 1. item | * item or # item |
| Code | `code` or code | {code}code{code} |
| Headings | ## Heading | h2. Heading |
Creating Stories
When creating JIRA stories, follow this workflow:
- Draft the story - Create the summary and description based on requirements
- Humanize the description - Use
/humanizerto remove AI writing patterns from the description text - Submit the story - Use the humanized description with
--create
Example Workflow
# 1. Draft description (you do this in memory)
# 2. Run humanizer on the description
# 3. Create story with humanized description
uv run ~/.claude/skills/jira/scripts/extract_jira.py --create \
--create-summary "Implement new feature" \
--description "The feature adds capability to process tasks. It handles edge cases and provides error handling." \
--epic-create RELOPS-2019
Use /humanizer to remove AI writing patterns from story descriptions before submitting.
Resources
- Full examples: references/examples.md
- All options:
uv run ~/.claude/skills/jira/scripts/extract_jira.py --help - Output:
~/moz_artifacts/jira_stories.json(default)