用途：为 autoresearch 会话编写迭代边界钩子。钩子对运行循环的智能体透明，效果体现为磁盘文件或 steer 消息。
主要能力：两个可选脚本 .auto/hooks/before.sh（每次迭代前触发）和 after.sh（每次 log_experiment 后触发）。无执行位的文件会被静默忽略。before.sh 的 stdin 为一行 JSON，含 event、cwd、next_run、last_run（新会话为 null）、session（metric_name、metric_unit、direction、baseline_metric、best_metric、run_count、goal）。after.sh 的 stdin 含 event、cwd、run_entry（刚记录的运行）与 session。
输出与限制：stdout 最多 8 KB，作为下一轮的 steer 消息；为空则静默。stderr 加非零退出会作为错误 steer。超时 30 秒硬杀并在可观测条目中标记。.auto/** 在自动回滚后仍保留，旧版 autoresearch.* 路径同样保留。
使用方式：先读 .auto/prompt.md 了解目标与指标，参考 .auto/measure.sh；从 examples/ 中选最接近的脚本复制到 .auto/hooks/<stage>.sh 并适配，然后 chmod +x。示例：mkdir -p .auto/hooks；cp "<skill-dir>/examples/before/external-search.sh" .auto/hooks/before.sh；chmod +x .auto/hooks/before.sh。可用 jq 构造模拟输入做管道测试。
适用场景：外部搜索、qmd 文档搜索、防抖动、想法轮换、假设反思、上下文轮换；学习日志、新最优的 macOS 通知、为获胜提交自动打标签。
规则：读取智能体自然写入的字段（asi.hypothesis、asi.next_focus、asi.learned、description），不要自造 hook 输入字段；默认静默；用提前退出做守卫；每个脚本只关注一件事；不使用环境变量，全部从 stdin 用 jq 提取。