cursor-hook-authoring

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Cursor Hook 設計

Cursor Hook 设计

発火タイミング

触发时机

Cursor Cloud Agent 環境で Git hook を追加・変更する
```
Co-authored-by:
```
の自動付与と除去の連鎖を設計する
lefthook 等の既存 hook と Cursor 管理 hook の共存を整理する

在 Cursor Cloud Agent 环境中添加或修改 Git hook
设计
```
Co-authored-by:
```
自动添加和移除的链
整理 lefthook 等现有 hook 与 Cursor 管理的 hook 之间的共存关系

Git hook と Cursor Cloud の commit-msg 連鎖

Git hook 与 Cursor Cloud 的 commit-msg 链

実行順

执行顺序

Cursor Cloud Agent は

.git/hooks/<hook-name>

を

.dispatcher

経由で差し替える。

commit-msg

の実行順は次のとおり:

ユーザー hook —
```
.cursor-original-hooks-path
```
が指すパス（通常
```
.git/hooks
```
）に同名 hook があれば先に実行
Cursor 管理 hook —
```
$HOOKS_DIR/$HOOK_NAME.cursor*
```
をファイル名の辞書順で順次実行

commit-msg

の典型例:

順序	ファイル名	役割
1	`commit-msg.cursor`	シークレットスキャン（commit ブロック）
2	`commit-msg.cursor.co-author`	`Co-authored-by:` を自動付与
3	`commit-msg.cursor.co-author-strip`	`Co-authored-by:` 行を除去（プロジェクト strip hook）

MUST: strip hook のベース名は

commit-msg.cursor.co-author-strip

とし、

commit-msg.cursor.co-author

より辞書順で後になる命名にする。NEVER:

commit-msg.cursor.strip-co-author

等、co-author より前に実行される名前を使用する。

Cursor Cloud Agent 通过

.dispatcher

替换

.git/hooks/<hook-name>

。

commit-msg

的执行顺序如下：

用户 hook — 如果
```
.cursor-original-hooks-path
```
指向的路径（通常为
```
.git/hooks
```
）中存在同名 hook，则先执行
Cursor 管理的 hook — 按照文件名的字典序，依次执行
```
$HOOKS_DIR/$HOOK_NAME.cursor*
```

commit-msg

的典型示例：

顺序	文件名	作用
1	`commit-msg.cursor`	secret 扫描（commit 内容块）
2	`commit-msg.cursor.co-author`	自动添加 `Co-authored-by:`
3	`commit-msg.cursor.co-author-strip`	移除 `Co-authored-by:` 行（项目 strip hook）

必须：strip hook 的 basename 必须设为

commit-msg.cursor.co-author-strip

，并确保其命名在字典序上位于

commit-msg.cursor.co-author

之后。绝不能：使用

commit-msg.cursor.strip-co-author

等会在 co-author 之前执行的名称。

strip hook 実装

strip hook 实现

MUST: 除去ロジックは
```
.cursor/hooks/strip-co-authored-by.sh
```
に置く
MUST:
```
commit-msg.cursor.co-author-strip
```
は当該スクリプトを呼び出す薄いラッパーとする
MUST: strip 対象は
```
Co-authored-by:
```
/
```
Co-Authored-By:
```
行（大文字小文字不問）および直前の空行
NEVER: コミットメッセージ本体（件名・説明）を削除しない

参考実装（

.cursor/hooks/strip-co-authored-by.sh

）:

bash

#!/usr/bin/env bash
set -euo pipefail

COMMIT_MSG_FILE="${1:?commit message file required}"

if [ ! -f "$COMMIT_MSG_FILE" ]; then
  exit 0
fi

tmp="$(mktemp)"
trap 'rm -f "$tmp"' EXIT

awk '
  BEGIN { skip_blank = 0 }
  /^[Cc]o-[Aa]uthored-[Bb]y:/ { skip_blank = 1; next }
  skip_blank && /^[[:space:]]*$/ { next }
  { skip_blank = 0; print }
' "$COMMIT_MSG_FILE" > "$tmp"

mv "$tmp" "$COMMIT_MSG_FILE"
trap - EXIT

必须：将移除逻辑放在
```
.cursor/hooks/strip-co-authored-by.sh
```
中
必须：
```
commit-msg.cursor.co-author-strip
```
必须仅作为调用该脚本的轻量 wrapper
必须：移除目标包括
```
Co-authored-by:
```
/
```
Co-Authored-By:
```
行（不区分大小写）以及紧邻的空行
绝不能：删除 commit message 主体（主题和详细说明）

参考实现（

.cursor/hooks/strip-co-authored-by.sh

）：