菜单
Use when finishing a feature or fix and ready to release — runs lint, tests, docs check, personal data audit, version bump, changelog, commit, tag, merge to main, and push to origin.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | ship |
| description | Use when finishing a feature or fix and ready to release — runs lint, tests, docs check, personal data audit, version bump, changelog, commit, tag, merge to main, and push to origin. |
Cascade checklist that validates, versions, commits, and pushes a Ferry release. Works from main (direct push) or from a feature branch (merge to main, then push).
NEVER create a branch, switch branches, or run git checkout/git switch during /ship.
This is a production machine running Dokku + Cloudflare Tunnel. Branch switches can destroy gitignored runtime config files (like tunnels/providers/cloudflare/config.yml), causing cascading Docker failures that take the entire tunnel offline.
/shipFrom main (most common):
main → lint → test → docs → audit → version → changelog → commit → tag → push
From a feature branch (only if already on one):
feature-branch → lint → test → docs → audit → version → changelog → commit → merge main → tag → push
Check which branch you're on. Do NOT switch or create branches.
current=$(git branch --show-current)
git status --short # must be clean or have only expected changes
If on main: proceed directly — steps 9 (merge) and 12 (cleanup) are skipped. If on a feature branch: the full flow including merge applies.
make lint
Must exit 0. Also run:
bash -n ferry.sh
Run all test suites and confirm pass counts:
bats test/unit/
bats test/integration/
bats test/generators/all_generators.bats
All must pass. Report total count. If Docker tests are included (runtime HTTP 200), they may take a few minutes — run them.
Verify version consistency:
FERRY_VERSION in ferry.sh (line 9) matches the intended release versionCHANGELOG.md has an entry for this version at the topgrep 'FERRY_VERSION=' ferry.sh | head -1
head -6 CHANGELOG.md
CRITICAL for this public repo. Scan staged/changed files for personal data:
git diff --cached --name-only | xargs grep -il 'gastonmorixe\.com\|kitekite\|bedhero\|gooseup\|ledsport\|multifiesta\|shieldsdev\|rails-fields\|5ac59747' 2>/dev/null
Also check for:
gastonmorixe/ferry which is intentional)If anything found, STOP and ask the user before proceeding.
If not already bumped, determine the next version:
Update FERRY_VERSION in ferry.sh script. Always run date -Iseconds for timestamps.
Add entry at top of CHANGELOG.md with:
Stage specific files (never git add -A):
git add ferry.sh CHANGELOG.md [other changed files...]
Commit with a detailed message using heredoc:
git commit -m "$(cat <<'EOF'
Ferry v{VERSION} — {one-line summary}
{detailed description of changes}
EOF
)"
Only if you're on a feature branch. If on main, skip to step 10.
git checkout main
git merge --no-ff {feature-branch} -m "Merge {feature-branch}: {summary}"
If conflicts, stop and resolve with user.
git tag v{VERSION}
git push origin main
git push origin v{VERSION}
Ask user if they want to delete the feature branch:
git branch -d {feature-branch}
| Step | Command | Must pass |
|---|---|---|
| Branch | git branch --show-current | Note which branch (do NOT switch) |
| Lint | make lint | exit 0 |
| Syntax | bash -n ferry.sh | exit 0 |
| Unit tests | bats test/unit/ | all pass |
| Integration | bats test/integration/ | all pass |
| Generator | bats test/generators/ | all pass |
| Version | grep FERRY_VERSION ferry.sh | matches release |
| Changelog | head CHANGELOG.md | has version entry |
| Data audit | grep for personal data | nothing found |
| Commit | git commit | clean message |
| Merge (feature branch only) | git merge --no-ff | no conflicts |
| Tag | git tag v{VERSION} | created |
| Push | git push origin main | success |
| Push tag | git push origin v{VERSION} | success |