smallnest/pigo/ship-it
- community
Checking that the SKILL.md file is still in the repository.
Code commit, PR creation, merge, and issue closure workflow via GitHub CLI (gh). Triggers after a goal (GitHub Issue) implementation is complete — commit code, push branch, create PR, merge, then close the issue. Use when the user says "提交代码", "commit and merge", "创建PR", "合入", "关闭issue", "ship-it", or when a goal implementation is done and code needs to be shipped.
Install
npx vskill@latest install smallnest/pigo/ship-itSKILL.md
The same SKILL.md was published earlier as smallnest/goal-workflow/ship-it.
After-Goal: 代码提交、PR 合入、Issue 关闭工作流(GitHub)
完成 GitHub Issue 实现后的标准收尾流程:提交代码 → 推送分支 → 创建 PR → 合入 → 关闭 Issue。
前置条件
- 当前 git 仓库有已实现的代码变更
- 已知 Issue 编号(如
#42) - gh CLI 已登录(
gh auth status可验证)
工作流
Step 1: 提交代码
关键规则:
- commit message 中包含
#issue-number以关联 Issue - 只暂存当前 Issue 相关的文件,不要混入其他变更
Step 2: 推送分支
分支命名建议:feat/issue-42-short-desc 或 fix/issue-42-short-desc
Step 3: 创建 PR
关键规则:
- PR body 中写
Closes #N或Fixes #N,合入后 GitHub 自动关闭 Issue - title 简洁,不超过 70 字符
Step 4: 合入 PR
参数说明:
--squash: 压缩为单个 commit 合入(推荐)--rebase: rebase 合入--merge: 普通 merge commit--delete-branch: 合入后删除远程分支
Step 5: 添加实现总结评论
PR 合入后,始终在 Issue 上添加实现总结评论,方便后续直接从 Issue 回溯代码变更。
关键规则:
- 无论是 auto-close 还是手动 close,都必须添加此评论
- 评论内容从 PR body 的 Summary 部分提取,保持简洁(3-5 条 bullet)
- 附加 PR 编号和 commit hash,方便直接跳转
Step 6: 手动关闭 Issue(仅当未自动关闭时)
如果 PR body 中已写 Closes #N,合入后 Issue 会自动关闭,跳过此步。否则手动关闭:
错误处理
| 场景 | 处理方式 | |
|---|---|---|
gh pr checks 有失败项 | 查看失败原因,修复后追加 commit 推送 | |
| PR 有 merge conflict | git fetch origin main && git rebase origin/main,解决冲突后 force push | |
gh pr merge 被 branch protection 阻止 | 确认 required reviews 已满足,或请 reviewer approve | |
| Issue 合入后未自动关闭 | 确认 PR body 包含 Closes #N,或执行 Step 6 手动 gh issue close |
完整示例
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckinginternal/builtinskills/skills/ship-it/SKILL.md
Popularity
- Repository stars
- 459
- Repository forks
- 63
- 7-day trend score
- 31
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/smallnest/pigo/ship-it)