フック開発

フックは環境イベントで発火する shell コマンドです。オペレーターの介入なしに 適合性を強制し、コンテキストを注入し、品質ゲートを実行します。

フックイベント

フックメッセージファイル

各フックには src/apothem/hooks/messages/<event>-<name>.md に対応する メッセージファイルがあり、フックが発火した瞬間にアシスタントへコンテキストを 提供します。

フックの登録

フックコマンドを settings.json に追加します。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "python src/apothem/hooks/my-check.py"
          }
        ]
      }
    ]
  }
}

フックディスパッチャー

すべてのフックは src/apothem/hooks/dispatch.py を経由します。これは任意の フックエラーをフェイルオープンのエンベロープに変換するため、フックが環境を ブロックすることは決してありません。