Awesome-omni-skill jj-vcs-workflow
Jujutsu (jj) VCS の総合ガイド。基本コマンド・Git移行・並列開発・履歴操作・PRレビュー・安全な push ワークフローをカバー。以下の場合に使用: (1) jj コマンドの使い方を確認したいとき (2) Git から jj への移行時 (3) 並列開発・履歴書き換え・コンフリクト解消を行うとき (4) PR レビュー対応時 (5) push を実行したいとき
install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/tools/jj-vcs-workflow" ~/.claude/skills/diegosouzapw-awesome-omni-skill-jj-vcs-workflow && rm -rf "$T"
manifest:
skills/tools/jj-vcs-workflow/SKILL.mdsource content
Jujutsu (jj) VCS Workflow
Jujutsu (jj) を使った開発のための総合ガイド。基本操作から高度なワークフローまでをカバーする。
基本概念
- Change: jj の作業単位。Git の「コミット」に相当するが、常に編集可能
- Working Copy (@): 現在編集中の Change。自動的にスナップショットされる(
不要)git add - Bookmark: Git のブランチに相当。主にリモートとの同期ポイントとして使用
- Operation Log: すべての操作履歴を追跡。
で取り消し可能jj undo
クイックリファレンス
| 操作 | コマンド |
|---|---|
| 状態確認 | / |
| 差分表示 | |
| 履歴表示 | |
| コミット | |
| 説明編集 | |
| 新規 Change | |
| 取り消し | |
| リモート取得 | |
push は必ず safe-push 経由で行う
jj git push の直接実行は禁止されている。push は必ず以下のワークフローで行う:
でリモートの最新状態を取得jj git fetch
で diverge を確認jj bookmark list --conflicted
で push 内容を確認(hook で強制)jj git push --dry-run- ユーザー確認後に
を実行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/