# 克劳德代码的柔术（jj）使用指南本文档指示 Claude Code 使用 `jj` (Jujutsu) 而不是 `git` 进行版本控制操作。 jj 是一个与 Git 兼容的 VCS，提供更简单的心智模型和强大的历史编辑功能。 ## 核心概念 ### 与 Git 的主要区别 1. **没有暂存区域** \- 每个更改都会自动成为工作副本提交的一部分 2. **工作副本是一次提交** \- `@` 符号代表您当前的工作副本提交 3. **匿名分支** \- 提交不需要分支名称；需要推送时使用“书签” 4. **冲突就是价值观** \- 冲突不会阻碍运营；它们会被跟踪并可以稍后解决 5. **自动变基** \- 当您修改历史记录时，后代提交会自动变基 ### 术语映射 git | git杰杰 ---|--- `分支` | `书签` `头` | `@`（工作副本） `结帐` | “编辑”或“新建” `藏匿` |不需要（只需创建新的提交） `分期/索引` |不适用 `提交--修改` |只需编辑，更改就会自动应用到“@” ## 常用操作 ### 观看状态 # 显示当前状态（如 git status） jj状态 jj st # 简写形式 # 显示提交日志（如 git log --graph） jj日志 jj log -r 'all()' # 显示所有提交 # 显示工作副本的差异 jj diff --git # 显示特定提交的差异 jj diff --git -r <提交> # 显示提交详细信息 jj 显示<提交> ### 创建提交 # 描述当前工作副本提交 jj描述-m“壮举：添加新功能” jj desc -m "feat: 添加新功能" # 简短形式 # 在当前提交之上创建一个新的空提交杰杰新 jj new -m“壮举：开始新工作”# 带有消息 # 在特定提交之上创建新提交 jj 新<提交> jj new main # 基于 main 的新提交 ### 编辑历史记录 # 编辑现有提交（将 @ 移动到该提交） jj 编辑 <提交> # 将当前提交压缩到父级中 jj 壁球 -m“组合消息” # 将特定提交压缩到其父级中 jj squash -r <提交> -m“组合消息” # 交互式地分割提交 jj分裂 # 将更改吸收到适当的祖先提交中 jj吸收 # 变基提交 jj rebase -r -d # 单次提交 jj rebase -s -d # 提交和后代 jj rebase -b -d # 整个分支 ### 使用书签（分支） # 列出书签 jj 书签列表 # 在当前提交处创建书签 jj 书签创建<名称> jj bookmark create -r # 在特定提交处 # 将书签移动到当前提交 jj 书签集<名称> # 删除书签 jj 书签删除<名称> # 跟踪远程书签 jj 书签曲目 <名称>@origin ### 远程操作 # 从远程获取 jj git 获取 jj git fetch --远程来源 # 将书签推送到远程 jj git push --书签 <名称> jj git push -b # 缩写形式 # 推送当前提交的书签 jj git 推送 # 一步创建并推送（如果书签存在） jj 书签设置 feature-x && jj git push -b feature-x ### 处理冲突 # 冲突不会阻止操作 - 检查它们 jj log -r '冲突()' # 解决工作副本中的冲突 # 只需编辑文件，删除冲突标记，保存 # 解决后，提交自动更新 jj status # 验证已解决 ### 撤消和恢复 # 显示操作日志 jj操作日志 # 撤消上一次操作 jj 操作撤消 # 恢复到具体操作 jj op 恢复 <操作 ID> ## 工作流程模式 ### 开始新的工作当开始实质性的新工作（功能、错误修复、重构）时，首先创建一个新的提交： # 从main开始新的工作 jj new main -m“壮举：作品描述” # 或者从当前位置开始 jj new -m“修复：修复的描述” 这可以使更改保持隔离并使其更容易： * 了解特定工作的变化 * 合并前检查更改 * 恢复或修改特定工作而不影响其他更改 ### 做出改变 # 只需编辑文件 - 它们会被自动跟踪 # 准备好完成提交消息时： jj描述-m“壮举：完成实施” # 开始下一项工作 jj new -m“壮举：下一步” ### 推送前清理 # 壁球修复提交给他们的父母 jj 南瓜 -r <修复提交> # 或者使用absorb来自动分发更改 jj吸收 # 重新调整到最新的 main jj git 获取 jj 变基 -d main ### 创建拉取请求 # 确保书签存在 jj 书签创建我的功能 # 推送到远程 jj git push -b 我的功能 # 或者推送并创建书签跟踪 jj git push --书签我的功能 ### 审核后更新 PR # 编辑需要更改的提交 jj 编辑 <提交> # 进行更改（直接应用） # 后代自动变基 # 返回处理提示 jj new <提示提交> # 强制推送更新的书签 jj git push -b 我的功能 ## 最佳实践 ### 提交消息 * 使用常规提交：`feat:`、`fix:`、`chore:`、`refactor:`、`docs:`、`test:` * 描述工作完成时的提交，而不是开始时的提交 * 使用“jj描述”随着工作的进展更新消息 ### 历史卫生 * 在推送之前使用 `jj squash` 来合并 WIP 提交 * 使用“jj吸收”将评论反馈合并到原始提交中 * 保持提交的原子性和重点 ### 书签命名推送到 GitHub 时，请使用描述性书签名称： jj 书签创建修复/issue-123-auth-bug jj 书签创建壮举/用户仪表板 jj 书签 create claude/- # 用于 Claude 代码会话 ### 推送前检查清单 # 1.检查冲突 jj log -r '冲突()' # 2. 确保清洁状态 jj状态 # 3. 重新定位到最新的 main jj git fetch && jj rebase -d main # 4.审查更改 jj log -r '::@ ~ ::main' # 5. 推 jj git push -b <书签> ## 与 Git 共存 jj 可以与 git 共存于同一个存储库中： # 在现有的 git 仓库中初始化 jj jj git init --colocate # jj 和 git 现在共享同一个 .git 目录 # 您可以使用任一工具，但在日常工作中更喜欢使用 jj 当并置时： * `jj git fetch` 更新 jj 和 git 引用 * `jj git push` 通过 git 推送 * 如果边缘情况需要，git 命令仍然有效 ## 避免交互式编辑器组合或编辑提交消息时，默认情况下，“squash”、“describe”、“commit”和“split”等 jj 命令会打开交互式编辑器。由于法学硕士无法与编辑互动： * **始终传递`-m "message"`** 以内联提供提交消息 * `jj squash -m "message"` — 不打开编辑器进行挤压 * `jj squash --into -m "message"` — 无需编辑器即可压缩到目标 * `jj describe -m "message"` — 无需编辑器即可设置描述 * 切勿使用`jj split`（需要交互式选择） ## 命令快速参考行动|命令 ---|--- 状态 | `jj st` 日志| `jj 日志` 差异| `jj diff --git` 描述提交 | `jj desc -m "消息"` 新提交 | ‘jj新’ 编辑旧提交 | `jj 编辑 ` 挤入父级| `jj 南瓜 -m <消息>` 变基| `jj rebase -d <目标>` 创建书签 | `jj 书签创建<名称>` 获取| `jj git fetch` 推 | `jj git push -b <名称>` 撤消 | `jj 操作撤消` ## 错误恢复如果出现问题： # 看看发生了什么 jj操作日志 # 撤消上一次操作 jj 操作撤消 # 或者恢复到已知的良好状态 jj op 恢复 <操作 ID> jj 的操作日志意味着您始终可以从错误中恢复 - 没有任何东西真正丢失。

柔术

包含技能