返回资讯中心
外部精选
软件工程
#开发者实时流

新工具 jj-stack 发布:用 Jujutsu 管理 GitHub 堆叠式 PR

来源标题:jj-stack: stacked GitHub pull requests for Jujutsu

jj-stack 正式发布,用于在 Jujutsu 中快速、安全地管理 GitHub 堆叠式 pull request。该工具让本地 jj 提交历史直接对应 GitHub 上的 PR 堆栈,用户可在本地编辑、重排、拆分或压缩变更后重新提交以更新对应的 PR。每个本地变更对应一个 PR,每个 PR 展示相对于下一层变更的差异。

Hacker News 最新tangled2026/11/18 · 今天29 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

我很高兴地宣布推出 jj-stack,这是一个用 Jujutsu 快速、安全地管理堆叠式 GitHub pull request 的新工具。

堆叠式变更让你(或你的 agent)可以把一大批工作拆分成多个小而独立、可单独审查的变更,而不必等每一个都审查或合并完才能继续。

我做这个工具,是因为我想要那种已经习惯了的堆叠式审查工作流,同时又想保留 Jujutsu 里让我觉得非常愉快的本地编辑体验。

有了 jj-stack,你的 jj 历史就决定了 GitHub 上堆栈的形状:你可以在本地编辑、重排、拆分或压缩变更,然后重新运行 submit 就能安全地更新对应的 PR。

--- config: block: padding: 32 --- block-beta columns 3 L["Local jj"] space G["GitHub"] C["C: UI"] space P3["PR #3"] B["B: API"] space P2["PR #2"] A["A: model"] space P1["PR #1"] T["trunk()"] space M["main"] T --> A A --> B B --> C M --> P1 P1 --> P2 P2 --> P3 A -.-> P1 B -.-> P2 C -.-> P3 style L fill:none,stroke:none style G fill:none,stroke:none 每个本地变更对应一个 pull request。每个 PR 显示的是相对于它下面那个 PR 所做的改动。jj-stack 主页可以帮你快速上手。这篇文章讲的是我为什么做它、我做了哪些取舍,以及一些把我引到这里的版本控制往事。

几分钟即可上手 用 uv 安装: uv tool install jj-stack 如果你已经用 gh 工具登录了 GitHub 命令行,jj-stack 可以直接复用那个登录来认证。在你的 jj 仓库里运行 jj-stack doctor --fix,它会检查你的配置,并正确配置它的 PR 记账信息。(举个例子说明 doctor 会做哪些检查:它会检查推送权限,因为 GitHub 堆栈目前只在你对远程仓库有推送权限时才能工作。)

核心的 stack 命令只有几个:

submit 把你线性的 jj 变更作为一个堆栈提交到 GitHub 上审查。修改完堆栈后,重新运行 submit 就会更新 GitHub 上的对应内容。 list 显示 jj-stack 在该仓库中知道的所有堆栈,view 则详细展示其中一个。(如果你的终端支持,pull request 会显示为可点击的超链接。) merge 在审查通过、检查全绿之后把你的工作合入 GitHub。之后如有需要(比如 squash merge 之后),它会 rebase 你的本地变更。如果 GitHub 已经替你完成了合并——通过 auto-merge、merge queue 或 UI 上的合并按钮——那么 sync 会在本地做清理。 下载终端录屏 滚动查看完整文字记录 # Create pull requests for A → B → C ❯ jj-stack submit Selected: C: add UI (nvwmrnsq) Submitted changes: ○ nvwmrnsq C: add UI: PR #3 │ ○ orqklzrw B: add API: PR #2 │ ○ knmwrzxz A: refactor shared model: PR #1 │ ◆ trsrmlvw base │ Top of stack: PR #3 Created GitHub stack #1. # Amend C in the scratch working copy ❯ printf 'keyboard navigation\n' >> ui.py ❯ jj squash Working copy (@) now at: xmqkktrn dac2361c (empty) (no description set) Parent commit (@-) : nvwmrnsq f6a098d7 C: add UI # Update the same pull requests ❯ jj-stack submit Selected: C: add UI (nvwmrnsq) Submitted changes: ○ nvwmrnsq C: add UI: pushed, PR #3 unchanged │ ○ orqklzrw B: add API: already pushed, PR #2 unchanged │ ○ knmwrzxz A: refactor shared model: already pushed, PR #1 unchanged │ ◆ trsrmlvw base │ Top of stack: PR #3 提交三个变更、编辑其中一个、再提交一次:每个 pull request 始终与正确的 jj 变更保持关联。融入你的工具链 安装 jj-stack 后,你可以把它配置成一个 jj 别名。用 jj config edit --user 把下面这段加到你的配置里:

[aliases] stack = ["util", "exec", "--", "jj-stack"] 然后你就可以运行 jj stack submit 了。该工具支持主流 shell 的命令行补全,包括作为 jj 别名使用时的补全。对于 Zsh,在 compinit 以及已有的 jj 补全设置之后,把下面这行加到 ~/.zshrc:

The --jj-alias option means "this is installed under a jj alias named stack" eval "$(jj-stack completion zsh --jj-alias stack)" 安装配套的 agent skill 也很简单(详情见下文):

gh skill install bos/jj-stack jj-stack jj-stack 有自己的明确主张:与其他工具的比较 GitHub 允许堆栈里的每个 PR 包含多个 commit。jj-stack 选择了一个更简单的模型:一个 jj 变更对应一个 PR。这给工作流带来一条简单规则:你本地变更的顺序,就是 GitHub PR 的顺序。

jj-stack 还会创建并管理维持这些 PR 所需的 GitHub 分支。你在 jj 里处理变更,它把这些记账用的分支藏在你看不到的地方。

这些取舍不会适合所有人。如果你需要多 commit 的 PR,或者想自己管理和命名每一个 PR 分支(但何必呢?),别的工具可能更合适。作为交换,jj-stack 提供了更小的思维模型,并替你管理完整的堆栈生命周期。

jj-spr jj-spr 是最接近的替代品。两个工具都把 jj 变更映射到 PR,并在你修改或 rebase 变更时保留该 PR。jj-spr 会在 GitHub 上为你的堆栈创建一份平行的、合成的、只追加的历史,这样审查者可以通过 GitHub 的 commit 列表和审查 UI 跟踪每个 PR 的每次更新。jj-spr 目前与 GitHub 原生堆栈不兼容。

jj-stack 更新每个变更的当前版本,并把相互依赖的 PR 归组为 GitHub 原生堆栈。它管理完整的生命周期(重排、整体提交堆栈、合并、同步本地历史、清理),而不需要第二份平行的 commit 历史。审查者可以通过 PR 历史评论里的链接比较一个 PR 的不同版本,但 GitHub 的「Changes since your last review」视图目前对原生 GitHub 堆栈是空的。(这又是 GitHub 的一个短板……)

jj-gh jj-gh 提供一组聚焦于 GitHub 的辅助功能,契合 bookmark 驱动的工作流,包括能感知 PR 的日志、多 commit PR、CI 重试和 auto-merge。当你想要自己拼装工作流时,这种灵活性很有价值。jj-stack 更为主张明确,也承担了更多工作:它管理 PR 分支,把堆栈作为一个整体提交,并处理合并与清理。它并不取代 jj-gh 在日志和 CI 方面的便利。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →