By name: jj-vcs-workflow description: "Jujutsu (jj) VCS の総合ガイド。基本コマンド・Git移行・並列開発・履歴操作・PRレビュー・安全な push ワークフローをカバー。以下の場合に使用: (1) jj コマンドの使い方を確認したいとき (2) Git から jj への移行時 (3) 並列開発・履歴書き換え・コンフリクト解消を行うとき (4) PR レビュー対応時 (5) push を実行したいとき" globs: - "/.jj/"
Jujutsu (jj) VCS Workflow
Jujutsu (jj) を使った開発のための総合ガイド。基本操作から高度なワークフローまでをカバーする。
基本概念
- Change: jj の作業単位。Git の「コミット」に相当するが、常に編集可能
- Working Copy (@): 現在編集中の Change。自動的にスナップショットされる（
git add不要） - Bookmark: Git のブランチに相当。主にリモートとの同期ポイントとして使用
- Operation Log: すべての操作履歴を追跡。
jj undoで取り消し可能
クイックリファレンス
| 操作 | コマンド |
|---|---|
| 状態確認 | jj status / jj st |
| 差分表示 | jj diff |
| 履歴表示 | jj log |
| コミット | jj commit -m "メッセージ" |
| 説明編集 | jj describe -m "メッセージ" |
| 新規 Change | jj new |
| 取り消し | jj undo |
| リモート取得 | jj git fetch |
push は必ず safe-push 経由で行う
jj git push の直接実行は禁止されている。push は必ず以下のワークフローで行う:
jj git fetchでリモートの最新状態を取得jj bookmark list --conflictedで diverge を確認jj git push --dry-runで push 内容を確認（hook で強制）- ユーザー確認後に
jj git pushを実行
hook とシェルガードにより、dry-run を経由しない push は自動的にブロックされる。 詳細は safe-push.md を参照。
詳細ドキュメント
基本操作
- commands.md: 主要コマンドの詳細な使い方とオプション
- git-to-jj.md: Git コマンドと jj コマンドの対応表
- revisions.md: リビジョン指定方法（@, @-, revset 式）
ワークフロー
- workflows.md: 新規機能開発・不具合修正のワークフロー
- best-practices.md: ベストプラクティスとトラブルシューティング
高度な操作
- guides/parallel-work.md: 並列開発ワークフロー（
jj new/jj edit） - guides/workspace.md: Workspace を使った並列開発（ファイルシステム分離）
- guides/history-maintenance.md: 履歴の書き換え（squash, split, rebase）
- guides/conflict-collab.md: コンフリクト解消と Git 連携
- guides/pr-review-workflow.md: Bookmark を活用した PR レビュー対応
- guides/safe-push.md: 安全な push ワークフローと hook 設定
参考リンク
- 公式ドキュメント: https://www.jj-vcs.dev/
- CLI リファレンス: https://www.jj-vcs.dev/latest/cli-reference/
- Git コマンド対応表: https://www.jj-vcs.dev/latest/git-command-table/