git-workstreams

Installation
SKILL.md

Git Workstreams

Goal

识别规范化仓库并默认用隔离 worktree 保护其主工作区;其他仓库在用户明确选择后或创建 PR 请求默认允许时启用 worktree。为依赖改动选择可审阅的 branch/PR 拓扑,把实现类仓库改动默认交付为使用仓库模板的 Draft PR,并把已有 PR 的冲突与 CI 跟到可合并或明确 blocker。GitHub 原生 stack 只是一条执行路线,不接管 workstream 所有权或授权判断。完成时应能给出判定证据、实际拓扑、基准、验证结果、commit/push、所用模板、PR 状态和未获授权的动作。

Choose the topology

  • 当前 checkout:仅在仓库不属于规范化仓库、用户未明确启用 worktree 且未要求创建 PR 时作为默认。规范化仓库不默认在主工作区的当前 checkout 写入;如果当前 checkout 本身就是已确认的 owning worktree,则直接复用。
  • 主工作区git worktree list --porcelain 的主 working tree。发布请求不得把它从默认分支隐式切到临时分支。
  • 独立 workstream:能独立修改、验证和交付的并行任务;用户启用后,每个 workstream 使用一个可写 worktree 和 branch。
  • 依赖 stack:后续改动依赖前一层、但每层都值得独立 review 时,在一个 owning checkout 内维护线性 branch chain;每个 PR 的 base 是下一层靠近 trunk 的 branch。GitHub 仓库默认使用原生 Stacked PRs;stack 本身不要求 worktree 或本地 gh stack CLI。
  • 多个独立 stacks:用户启用后,每个 stack 使用不同 owning worktree;不要把同一 stack 的各层拆到多个可写 worktree。若用户不启用,保持当前 checkout 并串行推进。

Classify a normalized repository

在开始写入前用只读证据判断仓库是否已有需要保护的正式协作或发布生命周期。以下任一强证据成立即可判为规范化仓库:

Installs
4
Repository
zrr1999/skills
First Seen
Jul 29, 2026
git-workstreams — zrr1999/skills