メニュー
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.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| 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: 新增包时，同样必须通过 PRLLVM 全平台分包（sub-packaging）规范 / 设计方案 / SOP。把上游单体 LLVM 工具链 carve 成两个自包含包——`llvm`（slim 自包含工具链 = 编译器 + lld + binutils + libc++ + compiler-rt）与 `llvm-tools`（clang-format/tidy/clangd）——并发布到 xlings-res 双镜像（GitHub gh + GitCode gtc）。用于新增/对齐某平台的 llvm 包、升级版本、保证 linux/macosx/windows 三平台一致。
在 xim-pkgindex 中创建/更新 xpkg 包（V1），遵守 xlings subos 隔离规范，补齐 tests，并在本地与测试集验证通过后再提交 PR。