sg-ship

name	sg-ship
description	Use this when the milestone is ready to be shipped — resolves the current phase and invokes gsd-ship to complete delivery.
argument-hint	[phase] - optional. Defaults to STATE.md current phase.

Detect the user's input language and respond in that language throughout this skill's output. - Korean input → respond in Korean - English input → respond in English - Mixed input → match the dominant language Resolve the target phase then invoke gsd-ship to complete and ship the milestone.

<execution_context> Self-contained. Reads .planning/STATE.md for phase resolution when no argument provided. Delegates shipment to gsd-ship Skill (terminal action). </execution_context>

1. **Resolve phase.** If `$ARGUMENTS` is non-empty, use it as the phase identifier. Otherwise, extract the current phase from `.planning/STATE.md`: ```bash if [ -n "$ARGUMENTS" ]; then PHASE_NUM="$ARGUMENTS" else Read .planning/STATE.md, then extract the Phase: value from the YAML frontmatter. Set PHASE_NUM to the extracted value. fi if [ -z "$PHASE_NUM" ]; then echo "Could not resolve current phase. Pass phase number explicitly: /super-gsd:sg-ship " exit 1 fi ```

1.5. Record HANDOFF.md row (ship stage) — before invoking the Skill.

HANDOFF_FILE=".planning/HANDOFF.md"
if [ ! -f "$HANDOFF_FILE" ] || ! grep -q "Timestamp.*Phase.*From.*To.*Plan Hash" "$HANDOFF_FILE" 2>/dev/null; then
  mkdir -p "$(dirname "$HANDOFF_FILE")"
  printf '| Timestamp | Phase | From | To | Plan Hash | User |\n| --- | --- | --- | --- | --- | --- |\n' > "$HANDOFF_FILE"
fi
TS=$(date -u +%Y-%m-%dT%H:%M:%SZ)
Read .planning/HANDOFF.md, then extract the To column (5th pipe-delimited field) from the last row that starts with "| " followed by a 4-digit year. Set FROM_STAGE to the extracted value (default "review" if empty).
PHASE_PAD=$(printf "%02d" "$PHASE_NUM" 2>/dev/null || echo "$PHASE_NUM")
PHASE_SLUG=$(ls -d .planning/phases/${PHASE_PAD}-* 2>/dev/null | head -1 | xargs basename 2>/dev/null || echo "${PHASE_PAD}")
GIT_USER=$(git config user.name 2>/dev/null || echo "-")
[ -z "$GIT_USER" ] && GIT_USER="-"
echo "| $TS | $PHASE_SLUG | $FROM_STAGE | ship | - | $GIT_USER |" >> "$HANDOFF_FILE"

2. Before calling Skill, replace $PHASE_NUM with the actual resolved value (e.g. 3). Session control transfers to the skill; no steps execute after this point:

   Skill(skill="gsd-ship", args="$PHASE_NUM")  # replace $PHASE_NUM
   

<success_criteria>

1. gsd-ship Skill is invoked exactly once with the resolved phase number.
2. $ARGUMENTS is used as phase number when provided.
3. .planning/HANDOFF.md gains a ship row immediately before the Skill is invoked.
4. If phase cannot be resolved, the command exits with the prescribed error message and does not invoke the Skill. </success_criteria>