jira-syntax

📁 netresearch/jira-skill 📅 10 days ago
15
总安装量
4
周安装量
#22469
全站排名
安装命令
npx skills add https://github.com/netresearch/jira-skill --skill jira-syntax

Agent 安装分布

opencode 3
github-copilot 2
claude-code 2
replit 1
amp 1
openclaw 1

Skill 文档

Jira Syntax Validation Skill

Provides Jira wiki markup syntax validation, templates, and formatting guidance. For API operations, use the jira-communication skill.

Quick Syntax Reference

Jira Syntax Purpose NOT this (Markdown)
h2. Title Heading ## Title
*bold* Bold **bold**
_italic_ Italic *italic*
{{code}} Inline code `code`
{code:java}...{code} Code block java “`
[text|url] Link [text](url)
[PROJ-123] Issue link
[~username] User mention @username
* item Bullet list - item
# item Numbered list 1. item
||Header|| Table header |Header|

See references/jira-syntax-quick-reference.md for complete syntax documentation.

Available Templates

Bug Report

Path: templates/bug-report-template.md

Sections: Environment, Steps to Reproduce, Expected/Actual Behavior, Error Messages, Technical Notes

Feature Request

Path: templates/feature-request-template.md

Sections: Overview, User Stories, Acceptance Criteria, Technical Approach, Success Metrics

Syntax Validation

Run before submitting to Jira:

scripts/validate-jira-syntax.sh path/to/content.txt

Validation Checklist

  • Headings: h2. Title (space after period)
  • Bold: *text* (single asterisk)
  • Code blocks: {code:language}...{code}
  • Lists: * for bullets, # for numbers
  • Links: [label|url] or [PROJ-123]
  • Tables: ||Header|| and |Cell|
  • Colors: {color:red}text{color}
  • Panels: {panel:title=X}...{panel}

Common Mistakes

❌ Wrong ✅ Correct
## Heading h2. Heading
**bold** *bold*
`code` {{code}}
[text](url) [text|url]
- bullet * bullet
h2.Title h2. Title

Integration with jira-communication Skill

Workflow:

  1. Get template from jira-syntax
  2. Fill content using Jira wiki markup
  3. Validate with scripts/validate-jira-syntax.sh
  4. Submit via jira-communication scripts (e.g., uv run scripts/workflow/jira-create.py)

References

  • references/jira-syntax-quick-reference.md – Complete syntax documentation
  • templates/bug-report-template.md – Bug report template
  • templates/feature-request-template.md – Feature request template
  • scripts/validate-jira-syntax.sh – Automated syntax checker
  • Official Jira Wiki Markup