// Use for ALL code changes — every modification to pkgs/, tests/, or scripts/ MUST go through a PR with CI verification before merging. No direct pushes to main. Covers branch creation, PR submission, CI monitoring, and merge rules.
| name | pr-workflow |
| description | Use for ALL code changes — every modification to pkgs/, tests/, or scripts/ MUST go through a PR with CI verification before merging. No direct pushes to main. Covers branch creation, PR submission, CI monitoring, and merge rules. |
所有代码变更必须通过 PR + CI 验证后才能合并到 main。禁止直接 push 到 main。
这条规则没有例外——无论是新增包、版本升级、bug 修复、测试变更还是 skill 文件修改。
git fetch origin main
git checkout -b <type>/<scope> origin/main
分支命名规范：
feat/<pkg-name> — 新增包feat/<pkg-name>-<version> — 版本升级fix/<pkg-name>-<description> — 修复feat/spec-<name> — 规范/测试变更git add <specific-files>
git commit -m "<type>(<scope>): <description>"
commit message 规范：
feat(mcpp): bump to 0.0.20 for all platformsfix(vc6): fix uninstall, register package.namefeat(spec): add D1 spec check不要 git add .，只添加相关文件。
git push -u origin <branch>
gh pr create --title "<commit-style title>" --body "..." --base main
PR body 必须包含：
gh pr checks <pr-number>
CI 必须全部通过才能合并。包含：
static-and-isolation — 静态分析 + 隔离合规（pytest）index-registration — 包索引注册测试linux-test / windows-test / macos-install-test — 多平台测试CI 失败时：
CI 全绿后，通过 GitHub UI 或 CLI 合并：
gh pr merge <pr-number> --squash
| 操作 | 为什么禁止 |
|---|---|
git push origin main | 绕过 CI 验证 |
gh pr merge 时 CI 未通过 | 引入未验证的变更 |
| 一个 PR 混合不相关的变更 | 难以 review、难以 revert |
| force push 到已有 review 的 PR | 丢失 review 上下文 |
如果一次工作涉及多个不相关的变更（例如：版本升级 + spec 检测 + bug 修复），拆成多个 PR：
feat/mcpp-0.0.20 → PR #1: mcpp 版本升级
feat/vc6-chinese → PR #2: vc6 中文版 + 卸载修复
feat/xpkg-spec-d1 → PR #3: spec 检测规则
每个 PR 独立基于最新 main，独立通过 CI，独立合并。
即使是紧急修复也必须走 PR：
git checkout -b hotfix/<description> origin/main
# ... 修复 ...
git push -u origin hotfix/<description>
gh pr create --title "fix: ..." --base main
# 等 CI 通过后合并
如果 CI 环境本身有问题导致无法通过，需要在 PR 中记录证据（日志截图/链接），经 maintainer 确认后才能合并。
xpkg-updater: 更新包版本时，自动走本 PR 流程（见其 references/pr-ci-loop.md）xpkg-creater: 新增包时，同样必须通过 PR