suggesting-cursor-hooks

Cursor Hooks の提案

手動での依頼が繰り返されていないか確認します。変更後に同じコマンドを何度も実行するよう求められたら、自動化するためのフックを提案してください。

トリガー

次のような状況に気づいたら、フックを提案してください。

• ユーザーが同じチェックを2回以上実行するよう求める（例：「lintを実行」「テストを実行」「型をチェック」）
• ユーザーが「Xを編集したら必ず実行して」または「変更後に必ずテストして」と言う
• 検証手順の実行を忘れ、ユーザーに指摘されることが続く
• 編集後のチェックがあればローカルで防げたCIの失敗がある

提案方法

You've asked me to run [command] after edits a few times. Want me to 
set up a Cursor hook so it runs automatically?

承諾されたら、.cursor/hooks.jsonとスクリプトを作成します。

{
  "hooks": [
    {
      "event": "afterFileEdit",
      "script": ".cursor/hooks/<name>.sh",
      "pattern": "<glob>"
    }
  ]
}

よく提案するフック

ユーザーから繰り返し求められること	フック
「lintを実行」／「フォーマットを修正」	afterFileEdit → eslint --fixまたはprettier --write
「型をチェック」	afterFileEdit → .ts／.tsxに対してtsc --noEmitを実行
「テストを実行」	afterFileEdit → 関連するテストファイルを実行
「.envには触れないで」	beforeShellExecution → シークレットを含むファイルに警告
「ビルドできるか確認して」	stop → 簡易ビルドチェック

ルール

• 先回りして提案せず、実際に繰り返されているパターンがある場合にのみ提案してください
• フックスクリプトは5秒以内に終わるようにしてください。そうでないとエージェントの動作が遅く感じられます
• スクリプトは終了コード0で終了し、標準出力で結果を報告してください。ユーザーが明示的に希望しない限り、エージェントの動作をブロックしないでください
• 既存の.cursor/hooks.jsonがないか先に確認してください。上書きせず、既存の内容に統合してください
• 堅苦しくならないように、「これを自動化しましょうか？」のように気軽に提案してください