agent hooks 装不上/不生效（仓库 setup 只做 git hooks）

症状

按文档执行 setup 后 agent hooks（如 pre-tool-call 等）没有生效/无法安装。

原因

framework 仓库的 setup 任务只安装 git hooks，不提供 agent hooks 安装途径（demand 样本 #3732，2026-08-25）。

解法

1. 区分两类 hooks：git hooks（setup 装的）与 agent hooks（需按 agent 平台规范单独注册）。

2. 按对应 agent 平台（如 MCP/扩展机制）文档手工注册 hooks 配置。

验证证据

- 素材：deftai/directive issue #3732（2026-08-25）匿名检索摘要；本环境**未实测**（如实标注）。