[Shinogasa]

概要

worktreeに閉じ込めたセッションでgitを使えなくなる問題を回避する。linked worktreeでgitの語を含むコマンドだけ、rtkの書き換えを省く。

背景

rtk hook claude は git status を rtk git status に書き換える。Claude Code本体のworktree分離チェックは、書き換えた後のコマンドを見て「rtkが何を実行するか読めない」と判定し、拒否する。そのため、worktreeのセッションでは git status も git commit も通らず、PR #80 のコンフリクトをそのセッションから解けなかった。

上流では既知の不具合で、どれもまだ直っていない（2026-10-13時点）。

• Worktree-isolation guard refuses plain git commands after a PreToolUse hook wraps them in a launcher (rtk) anthropics/claude-code#99895（OPEN、bug / has repro）
• fix(hooks): leave git unrewritten in Claude Code managed worktrees rtk-ai/rtk#3879、fix(hooks): detect linked worktrees by .git shape, not path convention rtk-ai/rtk#4490（どちらも未マージ）

見送った案は2つある。rtkの hooks.exclude_commands にgitを足す案は、全セッションでgitがrtkを通らなくなる。worktreeでは書き換えを全コマンドで止める案は、worktreeでrtkが効かなくなる。

主な変更点

• hooks/rtk-rewrite.py を足した。payloadの cwd から上へ .git を探す。.git がファイルで、gitdir: が worktrees/<名前> を指せばlinked worktreeとみなす。その中でコマンドにgitの語を含むなら、何も出さずに終える。それ以外は rtk hook claude の出力と終了コードをそのまま返す
  • submoduleの .git もファイルだが、modules/ を指すので対象外にした
  • grep git のような語も省く。分離チェックがこれらも拒否するため
  • rtkが無ければ、書き換えずに通す
• settings.json.template の rtk hook claude を、他のフックと同じ「ファイルが無ければ表示して通す」形に置き換えた。timeoutはClaude Codeの既定と同じ60秒にした
• 配線のテスト（tests/test_jp_doc_review_wiring.py）から、rtkだけtimeoutを除外していた例外を外した
• backlogに「上流が直ったらラッパーを外す」項目を足した

テスト

• tests/test_rtk_rewrite_hook.py（新規）は、偽のrtkをPATHに置き、実物のgitで作ったworktreeとsubmoduleで判定を確かめる
• bash tests/run.sh --all: 937 passed（a6f3a51 で記録済み）
• 実物のrtkで確かめた。worktreeの git status は書き換えず無出力になり、本体の git status は rtk git status に書き換わる

マージ後に bash setup.sh --claude を実行して、生成済みの ~/.claude/settings.json に反映する。そのうえで、新しいworktreeセッションで git status が通ることを確かめる。

関連

• Worktree-isolation guard refuses plain git commands after a PreToolUse hook wraps them in a launcher (rtk) anthropics/claude-code#99895
• PR chore: unittest discoverが止まる件を調査して閉じ、並列実行の不安定なテストをbacklogに足す #80（この不具合のためにコンフリクトをworktreeから解けなかった。本体のセッションから解いた）

🤖 Generated with Claude Code