SuperAPI AI 工具集

qjudge-github-workflow-owner

部署与运维

查看项目

更新于 10-16 02:16

技能介绍

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)。

主要能力与快速开始

技能提供以下快速开始步骤:

  1. 先同步 dev:git switch dev && git fetch origin main && git merge --ff-only origin/main。
  2. 从 dev 开分支:git switch -c codex/<topic>。
  3. 提交:bash .codex/skills/qjudge-github-workflow-owner/scripts/commit-changes.sh "type: message"。
  4. 开 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 命令细节。其具体执行效果、是否收费、支援平台等资讯暂未提供。