Git-Jira Integration Skill

Bridges Git workflows with Jira project management. Provides consistent naming, validation, and context generation to maintain traceability between code and issues.

Allowed Operations

•Link Git repositories to Jira projects
•Generate branch names from Jira issues
•Validate commit messages against conventions
•Generate PR context from Jira specifications
•List linked repositories

Forbidden Operations

These are NOT performed by this skill - agents have their own Git tools:

•Execute Git commands (clone, pull, push, commit)
•Create/merge Pull Requests directly
•Modify repository settings
•Access repository files or code

MCP Tools

Tool	Purpose
`devflow_git_link_repo`	Link repository to Jira project
`devflow_git_get_repos`	List linked repositories
`devflow_git_branch_name`	Generate branch name from issue
`devflow_git_validate_commit`	Validate commit message format
`devflow_git_pr_context`	Generate PR title, body, checklist

Constraints

•Branch names follow pattern: {type}/{issueKey}-{slug}
•Commit messages should follow Conventional Commits
•Commit messages should include issue key reference
•PR context requires existing Jira issues

Quick Reference

Branch Naming

Generate branch name:

code

devflow_git_branch_name(issueKey: "PROJ-123")

Result: feature/proj-123-add-user-authentication

Commit Validation

Validate commit message:

code

devflow_git_validate_commit(
  message: "feat(auth): add login page\n\nRefs: PROJ-123",
  projectKey: "PROJ",
  requireIssueKey: true
)

PR Context

Generate PR context:

code

devflow_git_pr_context(
  issueKeys: ["PROJ-123", "PROJ-124"],
  includeAcceptanceCriteria: true
)

For detailed conventions, see BRANCH-CONVENTIONS.md.

For commit message format, see COMMIT-MESSAGE-FORMAT.md.

For PR templates, see PR-TEMPLATES.md.

Example Workflow

•

Start work on issue:

code

# Get branch name from Jira issue
devflow_git_branch_name(issueKey: "PROJ-123")
# Agent creates branch with their git tools

•

Validate commits:

code

# Before committing, validate message
devflow_git_validate_commit(message: "feat: add login")

•

Create PR:

code

# Get PR context from Jira
devflow_git_pr_context(issueKeys: ["PROJ-123"])
# Agent creates PR with their gh/git tools

Repository Linking

Link a repository to get project-specific defaults:

code

devflow_git_link_repo(
  projectKey: "PROJ",
  repositoryUrl: "https://github.com/company/project",
  defaultBranch: "develop",
  branchPattern: "{type}/{key}-{slug}"
)

List linked repositories:

code

devflow_git_get_repos()
devflow_git_get_repos(projectKey: "PROJ")