# Qjudge Github Workflow Owner

> QJudge 的 GitHub 全責工作流。當任務涉及 branch 策略、commit、PR 建立、review gate、release（dev->main）時使用。只處理 Git/PR 決策，不定義 UI 或架構規範細節。

- Skill: `quan0715/qjudge-github-workflow-owner` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add quan0715/qjudge-github-workflow-owner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/quan0715/qjudge-github-workflow-owner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: quan0715 (https://skillmd.com/u/quan0715)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/quan0715/qjudge-github-workflow-owner

---


# QJudge GitHub Workflow Owner

## Quick start
- 先同步 `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`

## 參考文件
- 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`。

## Portable notes
- 可移植原則：保留 `feature branch -> integration branch -> release branch` 三段流。
- 若非 QJudge 專案，替換 base 分支名與 lint 指令即可沿用。