ship

Ship Skill

Create GitLab Merge Requests from PDCA completion. Uses glab CLI.

Prerequisites

• glab CLI installed and authenticated (glab auth login)
• Git remote configured for GitLab
• PDCA Report completed (recommended, not required)

Arguments

Argument	Description	Example
mr {feature}	Create MR from feature branch	/ship mr uart-dma
mr	Create MR from current branch	/ship mr
release {version}	Create release (tag + MR + changelog)	/ship release v1.2.0
tag {version}	Create annotated tag	/ship tag v1.2.0

Actions

mr {feature} — /mr create 권장

Note: MR 생성은 /mr create를 사용하세요. /mr create는 AI description 자동 생성, 리뷰어 지정, Draft 모드, Conventional Comments 리뷰까지 전체 MR 라이프사이클을 지원합니다. /ship mr은 하위 호환을 위해 유지되지만, 기본 MR 생성만 수행합니다.

Workflow:

1. Pre-flight checks:

   • Verify glab is available (glab --version)
   • Check git status (warn on uncommitted changes)
   • Read PDCA report if available (docs/04-report/{feature}.report.md)

2. Branch management:

   • If not on feature branch: git checkout -b feature/{feature}
   • Stage and commit changes with PDCA-based commit message
   • Push branch: git push -u origin feature/{feature}

3. MR creation:

   • Detect domain (MCU/MPU/WPF) for template selection
   • Fill MR template from templates/ship-mr.template.md
   • Include PDCA report summary (match rate, iterations)
   • Add domain-specific impact section
   • Create MR: glab mr create --title --description --target-branch main

4. Post-creation:

   • Display MR URL: glab mr view --web
   • Create Task: [Ship] MR for {feature}
   • Write audit log: mr_created

Domain-Specific MR Sections:

Domain	Additional Sections
MCU	Flash/RAM delta, peripheral changes, interrupt changes, MISRA compliance
MPU	Kernel ABI impact, driver interface changes (ioctl/sysfs), DT binding changes, library API/ABI compatibility
WPF	NuGet package changes, XAML binding impact, .NET target compatibility

MR Title Format: [{domain}] {feature}: {summary from PDCA report}

Example:

[MCU] uart-dma: Implement DMA-based UART driver with circular buffer

## Summary
DMA-based UART receive/transmit with double-buffering for high-throughput serial communication.

## Changes
- src/driver/uart_dma.c (new)
- src/driver/uart_dma.h (new)
- src/hal/dma_config.c (modified)

## PDCA Report
- Match Rate: 95%
- Iterations: 2
- Report: docs/04-report/uart-dma.report.md

## MCU Impact
- Flash: +2.1KB (78% → 79%)
- RAM: +512B (62% → 63%)
- Peripheral changes: DMA1 Channel 4/5 allocated for UART1
- Interrupt changes: DMA1_Ch4_IRQHandler, DMA1_Ch5_IRQHandler added
- MISRA compliance: 0 Required violations

release {version}

Combines tag creation + MR + changelog generation into a single release workflow.

1. Pre-flight: Verify all active PDCA features are completed (matchRate >= 90%)
2. Changelog: Collect PDCA reports since last tag, generate CHANGELOG.md entry
3. Version bump: Update version in package.json / plugin.json if applicable
4. Tag: Create annotated tag: git tag -a {version} -m "{changelog summary}"
5. Push: Push tag and branch: git push origin {version} && git push
6. GitLab release: glab release create {version} --notes "{changelog}"
7. Post-release: Write audit log: release_created

tag {version}

1. Validate semver format
2. Generate tag message from recent PDCA reports
3. Create annotated tag: git tag -a {version} -m "{message}"
4. Push tag: git push origin {version}
5. Display tag info

glab Commands Used

Command	Purpose
glab auth status	Verify authentication
glab mr create	Create merge request
glab mr view	View MR details
glab mr list	List open MRs

Integration

PDCA Report

Auto-reads PDCA report for MR description. Match rate and iteration count included.

/code-review

Suggest running /code-review before /ship mr if not done.

/security-review

Include security review status in MR checklist if available.

Usage Examples

# Create MR for a completed feature
/ship mr uart-dma

# Create MR from current branch
/ship mr

# Tag a release
/ship tag v1.2.0