Files
claude-engineering-plugin/plugins/compound-engineering/skills/ship-it/SKILL.md
John Lamb a7b15298e0
Some checks failed
CI / pr-title (push) Has been cancelled
CI / test (push) Has been cancelled
Release PR / release-pr (push) Has been cancelled
Release PR / publish-cli (push) Has been cancelled
Merge step (b): carry in local-only files at original paths
Brings 47 local-only files from backup-local-main into the merge-upstream
branch at their pre-rename paths. Subsequent steps will rename these to
the ce-* convention and port shared-file merges.

Includes:
- Custom skills: john-voice, jira-ticket-writer, hugo-blog-publisher,
  weekly-shipped, proof-push, ship-it, story-lens, sync-confluence,
  excalidraw-png-export, python-package-writer, fastapi-style,
  upstream-merge
- Custom agents: design-conformance-reviewer, tiangolo-fastapi-reviewer,
  zip-agent-validator, python-package-readme-writer, lint
- Custom commands: essay-edit, essay-outline, pr-comments-to-todos,
  resolve_todo_parallel, workflows/{plan,review,work}
- Local mods to ce-review/SKILL.md + review-output-template.md (will be
  ported to ce-code-review in a later step)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-24 12:40:27 -05:00

3.2 KiB

name, description
name description
ship-it This skill should be used when the user wants to ticket, branch, commit, and open a PR in one shot. It creates a Jira ticket from conversation context, assigns it, moves it to In Progress, creates a branch, commits changes, pushes, and opens a PR. Triggers on "ship it", "ticket and PR this", "put up a PR", "let's ship this", or any request to package completed work into a ticket + PR.

Ship It

End-to-end workflow: Jira ticket + branch + commit + push + PR from conversation context. Run after a fix or feature is done and needs to be formally shipped.

Constants

  • Jira cloudId: 9cbcbbfd-6b43-42ab-a91c-aaaafa8b7f32
  • Jira project: ZAS
  • Issue type: Story
  • Assignee accountId: 712020:62c4d18e-a579-49c1-b228-72fbc63186de
  • PR target branch: stg (unless specified otherwise)

Workflow

Step 1: Gather Context

Analyze the conversation above to determine:

  • What was done — the fix, feature, or change
  • Why — the problem or motivation
  • Which files changed — run git diff and git status to see the actual changes

Synthesize a ticket summary (under 80 chars, imperative mood) and a brief description. Do not ask the user to describe the work — extract it from conversation context.

Step 2: Create Jira Ticket

Use /john-voice to draft the ticket content, then create via MCP:

mcp__atlassian__createJiraIssue
  cloudId: 9cbcbbfd-6b43-42ab-a91c-aaaafa8b7f32
  projectKey: ZAS
  issueTypeName: Story
  summary: <ticket title>
  description: <ticket body>
  assignee_account_id: 712020:62c4d18e-a579-49c1-b228-72fbc63186de
  contentFormat: markdown

Extract the ticket key (e.g. ZAS-123) from the response.

Step 3: Move to In Progress

Get transitions and find the "In Progress" transition ID:

mcp__atlassian__getTransitionsForJiraIssue
  cloudId: 9cbcbbfd-6b43-42ab-a91c-aaaafa8b7f32
  issueIdOrKey: <ticket key>

Then apply the transition:

mcp__atlassian__transitionJiraIssue
  cloudId: 9cbcbbfd-6b43-42ab-a91c-aaaafa8b7f32
  issueIdOrKey: <ticket key>
  transition: { "id": "<transition_id>" }

Step 4: Create Branch

Create and switch to a new branch named after the ticket:

git checkout -b <ticket-key>

Example: git checkout -b ZAS-123

Step 5: Commit Changes

Stage and commit all relevant changes. Use the ticket key as a prefix in the commit message. Follow project git conventions (lowercase, no periods, casual).

git add <specific files>
git commit -m "<ticket-key> <short description>"

Example: ZAS-123 fix candidate email field mapping

Include the co-author trailer:

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Step 6: Push and Open PR

Push the branch:

git push -u origin <ticket-key>

Use /john-voice to write the PR title and body. Create the PR:

gh pr create --title "<PR title>" --base stg --body "<PR body>"

PR body format:

## Summary
<2-3 bullets describing the change>

## Jira
[<ticket-key>](https://discoverorg.atlassian.net/browse/<ticket-key>)

## Test plan
<bulleted checklist>

Step 7: Report

Output the ticket URL and PR URL to the user.