1# hooks/pre_commit.py
2def run_git_command(cmd):
3    result = subprocess.run(cmd, capture_output=True, text=True)
4    return result.stdout.strip()
5
6# hooks/post_merge.py  -- 完全相同
7# hooks/branch_check.py  -- 完全相同
8# hooks/worktree_guardian.py  -- 完全相同

1# 找出重複的函式定義
2grep -rh "^def " .claude/hooks/*.py | sort | uniq -c | sort -rn | head -20
3
4# 範例輸出：
5#    4 def run_git_command(cmd):
6#    3 def get_current_branch():
7#    2 def parse_worktree_line(line):

1.claude/lib/
2├── __init__.py           # 公開介面
3├── git_utils.py          # Git 操作
4├── config_loader.py      # 配置載入
5├── hook_io.py            # 輸入輸出
6└── hook_logging.py       # 日誌系統

 1# lib/git_utils.py
 2"""Git 操作工具模組。"""
 3
 4import subprocess
 5from pathlib import Path
 6from typing import List, Optional
 7
 8def run_git_command(
 9    cmd: List[str],
10    cwd: Optional[Path] = None,
11    check: bool = False
12) -> str:
13    """執行 Git 命令並回傳輸出。
14
15    Args:
16        cmd: Git 命令列表，例如 ["git", "status"]
17        cwd: 工作目錄，預設為當前目錄
18        check: 是否在命令失敗時拋出異常
19    """
20    result = subprocess.run(
21        cmd, capture_output=True, text=True, cwd=cwd, check=check
22    )
23    return result.stdout.strip()
24
25def get_current_branch(cwd: Optional[Path] = None) -> str:
26    """取得當前分支名稱。"""
27    return run_git_command(["git", "branch", "--show-current"], cwd=cwd)

1# hooks/pre_commit.py（重構後）
2from lib.git_utils import run_git_command, get_current_branch
3
4def check_branch():
5    current_branch = get_current_branch()
6    # 使用共用函式，不再重複定義

 1# 重構前：三個檔案各自的版本
 2# hooks/file_a.py
 3def parse_worktree_line(line):
 4    return line[9:]                        # 不 strip
 5
 6# hooks/file_b.py
 7def parse_worktree_line(line):
 8    return line[9:].strip()                # 有 strip
 9
10# hooks/file_c.py
11def parse_worktree_line(line):
12    return line.removeprefix("worktree ")  # 用 Python 3.9+ API
13
14# 重構後：統一實作，支援選項
15WORKTREE_PREFIX = "worktree "
16
17def parse_worktree_line(line: str, strip: bool = True) -> str:
18    """解析 worktree 輸出行。"""
19    result = line.removeprefix(WORKTREE_PREFIX)
20    return result.strip() if strip else result

 1from pathlib import Path
 2from typing import Callable
 3
 4# 重構前
 5def check_all_python_files():
 6    for file in Path(".").glob("**/*.py"):
 7        if validate_python(file): print(f"OK: {file}")
 8
 9def check_all_yaml_files():
10    for file in Path(".").glob("**/*.yaml"):
11        if validate_yaml(file): print(f"OK: {file}")
12
13# 重構後
14def check_files(pattern: str, validator: Callable[[Path], bool]) -> None:
15    for file in Path(".").glob(pattern):
16        if validator(file): print(f"OK: {file}")
17
18check_files("**/*.py", validate_python)
19check_files("**/*.yaml", validate_yaml)

 1# === 步驟 1：替換 import ===
 2# 遷移前
 3from lib.common_functions import setup_hook_logging
 4# 遷移後
 5from hook_utils import setup_hook_logging
 6
 7# === 步驟 2：包裹主函式 ===
 8# 遷移前
 9if __name__ == "__main__":
10    try:
11        main()
12    except Exception as e:
13        logger.error(f"執行失敗: {e}")
14        sys.exit(1)
15# 遷移後
16from hook_utils import run_hook_safely
17if __name__ == "__main__":
18    sys.exit(run_hook_safely(main, "my-hook"))
19
20# === 步驟 3：驗證 ===
21uv run python hook-name.py < /dev/null

1# 遷移前（同目錄）
2from common_functions import hook_output  # OK
3
4# 遷移後（模組移到 lib/，但 import 未更新）
5from common_functions import hook_output  # ModuleNotFoundError!
6
7# 正確的遷移後 import
8from lib.common_functions import hook_output  # OK

1# 1. 列出所有引用舊路徑的檔案
2grep -r "from common_functions import" .claude/hooks/*.py
3
4# 2. 逐一更新每個引用者的 import 路徑
5
6# 3. 逐一驗證（不能只跑其中幾個！）
7for f in .claude/hooks/*.py; do
8    uv run python "$f" < /dev/null 2>&1 | grep -q "Error" && echo "FAIL: $f"
9done

1try:
2    from hook_utils import setup_hook_logging
3except ImportError as e:
4    print(f"[Hook Import Error] {Path(__file__).name}: {e}", file=sys.stderr)
5    sys.exit(1)

 1# file1.py
 2def process_user_data(user):
 3    if not user.get("name"):
 4        return {"error": "缺少姓名"}
 5    if not user.get("email"):
 6        return {"error": "缺少信箱"}
 7    return {"success": True, "data": user}
 8
 9# file2.py
10def process_order_data(order):
11    if not order.get("product"):
12        return {"error": "缺少商品"}
13    if not order.get("quantity"):
14        return {"error": "缺少數量"}
15    return {"success": True, "data": order}