QJudge GitHub Workflow Owner 是一个面向 QJudge 专案的 GitHub 全责工作流技能,用于在任务涉及分支策略、commit、PR 建立、review gate、release(dev->main)时提供统一的决策与操作流程。它的范围仅限于 Git/PR 决策,不定義 UI 或架构规范细节。
用途
该技能用于处理与 Git 和 Pull Request 相关的决策,包括分支命名、commit 粒度、PR 的 base 与 head、PR 描述与标籤策略、release 流程(dev -> main),以及 merge 前的流程 gate(检查是否有跑 quality scripts)。
主要能力与快速开始
技能提供以下快速开始步骤:
- 先同步 dev:git switch dev && git fetch origin main && git merge --ff-only origin/main。
- 从 dev 开分支:git switch -c codex/<topic>。
- 提交:bash .codex/skills/qjudge-github-workflow-owner/scripts/commit-changes.sh "type: message"。
- 开 PR:bash .codex/skills/qjudge-github-workflow-owner/scripts/create-pr.sh --base dev --title "title"。
责任边界(Owner Scope)
该技能负责:branch 命名、commit 粒度、PR base/head、PR 描述与标籤策略;release 流程(dev -> main);merge 前流程 gate(检查是否有跑 quality scripts)。
该技能不负责:不定義 import boundaries(交给 qjudge-architecture-owner);不定義 Carbon/UI 规范(交给 qjudge-ui-carbon-owner);不定義 compose 命令细节(交给 qjudge-env-compose-owner)。
执行规则
执行规则包括:仅允许 codex/* -> dev 或 dev -> main;不在 main 直接 commit;PR 应小而可审,建议 <= 20 档、<= 400 行增删(特殊情况需在 PR 说明理由);开 PR 前最少要跑以下两个品质检查:
node .codex/skills/qjudge-quality-gates-owner/scripts/lint-naming.js --root frontend/src node .codex/skills/qjudge-quality-gates-owner/scripts/lint-architecture.js --root frontend/src
参考文件与 Cross-skill handoff
参考文件:PR policy / labels 见 references/pr-policy.md。
Cross-skill handoff:涉及层级责任或路径归属,先切到 qjudge-architecture-owner;涉及 UI/Storybook/overflow,切到 qjudge-ui-carbon-owner;涉及容器指令或 migrate/test 执行,切到 qjudge-env-compose-owner。
可移植性
可移植原则:保留 feature branch -> integration branch -> release branch 三段流。若非 QJudge 专案,替换 base 分支名与 lint 指令即可沿用。
限制
该技能只处理 Git/PR 决策,不涉及 UI、架构或 compose 命令细节。其具体执行效果、是否收费、支援平台等资讯暂未提供。