菜单
Create GitHub pull requests using the gh CLI. Use when the user wants to create a new PR, submit code for review, or open a pull request. Trigger keywords - create PR, pull request, new PR, submit for review, code review, open PR.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/socktainer/socktainer --skill create-github-pr命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
基于 SOC 职业分类
| name | create-github-pr |
| description | Create GitHub pull requests using the gh CLI. Use when the user wants to create a new PR, submit code for review, or open a pull request. Trigger keywords - create PR, pull request, new PR, submit for review, code review, open PR. |
Create pull requests on GitHub using the gh CLI, following project conventions.
gh CLI must be authenticated (gh auth status).git commit --signoff).make fmt
Verify no formatting drift:
git diff --exit-code
If formatting changes are needed, stage and commit them (with --signoff).
Run the test suite:
make test
All tests must pass before opening a PR.
Tests/socktainerTests/ following the existing directory structure.Not on main — never create PRs directly from main:
git branch --show-current # Should NOT be "main"
Push your branch:
git push -u origin HEAD
Every commit in the PR must have a Signed-off-by trailer. The DCO Probot app enforces this. Check with:
git log --format='%h %s | %b' origin/main..HEAD | grep -c 'Signed-off-by'
If any commits are missing sign-off, amend them:
git rebase --signoff origin/main
PR titles must follow the Conventional Commits format:
<type>(<scope>): <description>
| Type | Meaning |
|---|---|
feat | New feature or new API endpoint |
fix | Bug fix |
docs | Documentation only |
refactor | Code restructuring, no behavior change |
test | Adding or updating tests |
chore | Maintenance (CI, build, dependencies) |
perf | Performance improvement |
deps | Dependency updates |
build | Build system changes |
ci | CI/CD pipeline changes |
Scopes typically match the affected component: routes, containers, images, healthcheck, dns, build, volumes, labels, stats, context, attach, app, archive, builder.
feat(healthcheck): implement Docker healthcheck supportfix(attach): stream output for non-interactive docker runfix(labels): normalize label keys for Apple Container compatibilitydocs: update README with volume sync optionsrefactor(routes): use native pull/pushdeps: bump apple/container to 1.0.0PR descriptions should follow the template in .github/PULL_REQUEST_TEMPLATE.md:
## Summary
<!-- 1-3 sentences: what this PR does and why -->
## Related Issue
<!-- Fixes #NNN or Closes #NNN -->
## Changes
<!-- Bullet list of key changes -->
## Testing
- [ ] `make fmt` passes (no formatting drift)
- [ ] `make test` passes
- [ ] Unit tests added or updated (required for features and bug fixes)
- [ ] Manual testing performed (if applicable)
## Checklist
- [ ] Follows Conventional Commits
- [ ] All commits are signed off (DCO)
Basic command:
gh pr create --title "<title>" --body "<body>"
gh pr create \
--title "feat(healthcheck): implement Docker healthcheck support" \
--body "$(cat <<'EOF'
## Summary
Implement Docker healthcheck support so containers can define HEALTHCHECK
instructions and socktainer tracks their status. Closes #214
## Related Issue
Closes #214
## Changes
- Added `HealthCheckManager` to run periodic health probes inside containers
- Added `ClientHealthCheckService` for healthcheck state management
- Container inspect now returns `.State.Health` with current status and log
- Healthcheck loops resume automatically on socktainer restart
## Testing
- [x] `make fmt` passes (no formatting drift)
- [x] `make test` passes
- [x] Unit tests added for `HealthCheckManager` and `ClientHealthCheckService`
- [x] Manual testing with `docker run --health-cmd` verified
## Checklist
- [x] Follows Conventional Commits
- [x] All commits are signed off (DCO)
EOF
)"
Use Closes #<issue-number> or Fixes #<issue-number> in the body to auto-close the issue when merged.
For work-in-progress that is not ready for review:
gh pr create --draft --title "feat(dns): add inter-container DNS"
gh pr create --title "Title" --label "bug"
Default target is main. To target a different branch:
gh pr create --base "1.0.x"
| Option | Description |
|---|---|
--title, -t | PR title (use conventional commit format) |
--body, -b | PR description |
--reviewer, -r | Request review from user |
--draft | Create as draft (WIP) |
--label, -l | Add label (can use multiple times) |
--base, -B | Target branch (default: main) |
--head, -H | Source branch (default: current) |
--web | Open in browser after creation |
The command outputs the PR URL and number.
Display the URL using markdown link syntax so it's easily clickable:
Created PR [#123](https://github.com/socktainer/socktainer/pull/123)
The PR CI runs formatting check, unit tests, release build, installer build, and integration tests:
gh run watch