Add Ticket Comment

Add a comment to a Jira ticket. Comments support markdown formatting.

When to Use

• User wants to add an update to a ticket
• User wants to ask a question on a ticket
• User wants to document a decision
• User wants to communicate progress or blockers

How to Execute

Run:

aide jira comment TICKET-KEY "comment text" [--format text|json|markdown]

Or read from file:

aide jira comment TICKET-KEY --file ./comment.md

Flags

Output Includes

1. Comment ID
2. Creation timestamp
3. Author name

Common Patterns

# Add a simple comment
aide jira comment PROJ-123 "Started working on this task"

# Add a detailed comment with markdown
aide jira comment PROJ-123 "## Progress Update

- Completed initial implementation
- Tests passing locally
- Ready for code review

**Next steps:** Create PR and request review"

# Add comment from file (for longer content)
aide jira comment PROJ-123 --file ./status-update.md

Use Cases

Best Practices

• Use markdown for formatted comments (headers, lists, code blocks)
• For long comments, write to a file first and use --file
• Reference other tickets with their keys (e.g., "Related to PROJ-456")
• Include relevant details for future reference

Next Steps

After adding a comment:

• Use ticket-comments skill to see all comments
• Use ticket-transition skill to change status if appropriate