git-workflow

name	git-workflow
description	Use when 需要创建分支、准备提交、整理发布流程，或判断本项目 git flow、angular commit、提交确认与 co-author 约束时

git-workflow

Overview

本项目 git 采用 git flow，基础分支为 main 与 dev。此入口只定义触发条件与硬边界，具体操作拆分到 guides、references 与 checklists。

When to Use

• 需要开始新功能、修复、发布或回收分支
• 需要准备 commit，但不确定分支来源、提交格式或确认步骤
• 需要确认本项目 git flow、angular commit、co-author 或提交前检查规则
• 需要处理会默认假设 worktree 的 git 流程场景

Hard Boundaries

• 本项目 git 工作流以 git flow 为准，基础分支固定为 main 与 dev
• commit message 必须遵循 angular commit，不能退化为通用描述风格
• 每次执行 commit 前都必须先获得用户确认，未确认不得提交
• 每次 commit message 都必须附带 Co-authored-by: opencode-agent[bot] <opencode-agent[bot]@users.noreply.github.com>
• 本 skill 不定义上游默认 worktree 流程；如果当前上下文还在沿用该默认前提，先转到 using-git-worktrees 完成一次性重定向，重定向完成后仍回到本 skill 处理分支与提交规则

Navigation

• 开始功能或修复：guides/start-feature.md
• 准备提交：guides/prepare-commit.md
• 发布流程：guides/release-flow.md
• 分支策略：references/branch-strategy.md
• 工作区策略：references/workspace-strategy.md
• 提交规范：references/commit-convention.md
• 提交确认：references/commit-confirmation.md
• co-author 规则：references/co-author-policy.md
• 分支自检：checklists/branch-checklist.md
• 提交前自检：checklists/pre-commit-checklist.md
• 仍在沿用上游默认 worktree 前提时：using-git-worktrees

Escalation

• 无法判断分支应从 dev、main 还是 release/hotfix 衍生时，先查 references/branch-strategy.md
• 需要判断是否应使用独立工作区时, 先查 references/workspace-strategy.md
• 需要真正执行 commit 时，先按 references/commit-confirmation.md 向用户确认
• 需要拼装 commit message 时，先查 references/commit-convention.md 与 references/co-author-policy.md
• 流程仍在沿用上游默认 worktree、隔离工作区、并行工作区或避免污染当前工作区的前提时，先转到 using-git-worktrees 做一次性重定向；完成后回到本 skill 继续处理 branch/commit policy