| name | jj-new |
| description | Trigger BEFORE the first file edit of any new logical task — when starting a new feature, beginning a bug fix, switching to an unrelated change, beginning a refactor, or when the previous commit description is "done" and you are about to work on something different. Advances @ to a new empty commit so the previous commit stays clean. Skip only when not in a jj repo, when @ already has no description, or when the work directly continues the previous commit's concern (e.g. fixing a bug in code you just wrote there). When unsure, invoke. |
jj-new
新しい作業を始める前に @ を空コミットに進めて、前タスクのコミットに変更が混ざるのを防ぐよ〜！
When to invoke
MUST invoke before the first file edit (Write/Edit/NotebookEdit) of any new task.
- 新しい機能の実装を始めるとき
- バグ修正を始めるとき
- リファクタや別関心事の作業に切り替えるとき
- ユーザーが明示的に「新しいタスク」を指示してきたとき
判断に迷ったら default to invoking (副作用は空コミット 1 個分だけ、低コスト)。/clear やセッション境界を「新タスク」の判定材料にしない — 同じ会話の続きでも別タスクの可能性があるし、/clear 後に同じタスクを続けることもあるから。
When to skip
- カレントディレクトリが jj リポジトリじゃない (
jj root が失敗する)
@ が既に空コミット (description が空)- 現在の作業が直前のコミットの直接の継続 (例: たった今書いたコードのバグ修正、同じ機能のテスト追加など)
Procedure
-
Check context — まず現状を確認
jj root >/dev/null 2>&1 || { echo "not in jj repo, skipping"; exit 0; }
jj log -r '@-::@' --limit 2
jj status
-
Decide — 上の出力から skip 判定
@ の description が空 → skip- jj リポじゃない → skip
- それ以外 → 進める
-
Run — jj new を実行
jj new
-
Acknowledge in transcript — 何をしたか（しなかったか）を必ず一言伝える
- 実行した場合: 「
jj new で @ を空コミットに進めたよ。前タスクの <commit description> は確定したから、ここから新タスクで作業するね！」
- skip した場合: 「
@ は既に空（or jj 管理外）だから skip。そのまま進めて OK！」
この acknowledgement が監査ログ になる。silent に実行しない。
Why this exists
jj は 暗黙スナップショット をするモデル。任意の jj コマンド実行時に working copy が @ に取り込まれる。だから @ のコミットメッセージが既に確定（前タスクの内容）してても、新しい編集をするとそのコミットに混ざる。前タスクと新タスクを別コミットに分けたいなら、編集を始める前に @ を新しい空コミットに進める必要がある。
このスキルは .claude/rules/vcs.md の「新しい作業を始める前に必ず jj new を実行する」ルールを具体的なアクションとして実行可能にしたもの。
Failure modes
- 既に
@ を進めずに編集を始めてしまった場合 → jj split で後から分離可能 (jj skill 参照)
- 同じファイルに前タスクと新タスクの変更が混ざった場合 →
jj split -i でインタラクティブ split
