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.md
source content

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 は必ず以下のワークフローで行う:

  1. jj git fetch
    でリモートの最新状態を取得
  2. jj bookmark list --conflicted
    で diverge を確認
  3. jj git push --dry-run
    で push 内容を確認(hook で強制)
  4. ユーザー確認後に
    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: ベストプラクティスとトラブルシューティング

高度な操作

参考リンク