Imported from ymymssss/ohmyopenagent (src/hooks/AGENTS.md). Install upstream with npx skills add ymymssss/ohmyopenagent --skill hooks. Copyright stays with the author.

src/hooks/ — 48 个生命周期钩子

生成时间： 2026-03-06

概述

48 个钩子分布在独立模块和单文件中。三层组合：核心钩子(39) + 延续钩子(7) + 技能钩子(2)。所有钩子遵循 createXXXHook(deps) → HookFunction 工厂模式。

钩子层级

第一层：会话钩子（23）— create-session-hooks.ts

结构

hooks/
├── atlas/                      # 主编排（757 行）
├── anthropic-context-window-limit-recovery/ # 自动摘要
├── anthropic-effort/            # 推理努力级别调整
├── anthropic-image-context/     # Anthropic 图像上下文处理
├── auto-slash-command/         # 检测 /command 模式
├── auto-update-checker/        # 插件更新检查
├── background-notification/    # 系统通知
├── beast-mode-system/          # Beast 模式系统提示注入
├── category-skill-reminder/    # 提醒类别技能
├── claude-code-hooks/          # settings.json 兼容层
├── comment-checker/            # 防止 AI 垃圾内容
├── compaction-context-injector/ # 压缩时注入上下文
├── compaction-todo-preserver/  # 压缩时保留 todo
├── delegate-task-retry/        # 重试失败的委托
├── directory-agents-injector/  # 自动注入 AGENTS.md
├── directory-readme-injector/  # 自动注入 README.md
├── edit-error-recovery/        # 从失败中恢复
├── hashline-edit-diff-enhancer/ # hashline 编辑的增强 diff 输出
├── hashline-read-enhancer/     # 为 Read 输出添加 LINE#ID 哈希
├── interactive-bash-session/   # Tmux 会话管理
├── json-error-recovery/        # JSON 解析错误纠正
├── keyword-detector/           # ultrawork/search/analyze 模式
├── model-fallback/             # 提供商级模型回退
├── no-hephaestus-non-gpt/      # 阻止 Hephaestus 使用非 GPT
├── no-sisyphus-gpt/            # 阻止 Sisyphus 使用 GPT
├── non-interactive-env/        # 非 TTY 环境处理
├── prometheus-md-only/         # Planner 只读模式
├── question-label-truncator/   # 自动截断问题标签
├── ralph-loop/                 # 自引用开发循环
├── read-image-resizer/         # 调整图像大小以提高上下文效率
├── rules-injector/             # 条件规则
├── runtime-fallback/           # API 错误时自动切换模型
├── session-recovery/          # 自动从崩溃中恢复
├── sisyphus-junior-notepad/    # Sisyphus Junior 记事本
├── start-work/                 # Sisyphus 工作会话启动器
├── stop-continuation-guard/    # 守护停止延续
├── task-reminder/              # 任务系统使用提醒
├── task-resume-info/           # 取消任务的重启信息
├── tasks-todowrite-disabler/   # 任务系统激活时禁用 TodoWrite
├── think-mode/                 # 动态思考预算
├── thinking-block-validator/   # 确保 <thinking> 块有效
├── todo-continuation-enforcer/ # 强制完成 TODO
├── unstable-agent-babysitter/  # 监控不稳定智能体行为
├── write-existing-file-guard/  # 要求写前先读
└── index.ts                    # 钩子聚合与注册

第二层：工具守卫钩子（12）— create-tool-guard-hooks.ts

第三层：转换钩子（4）— create-transform-hooks.ts

第四层：延续钩子（7）— create-continuation-hooks.ts

第五层：技能钩子（2）— create-skill-hooks.ts

关键钩子（复杂）

anthropic-context-window-limit-recovery（31 文件，约 2230 行）

达到上下文限制时的多策略恢复。策略：截断、压缩、摘要。

atlas（17 文件，约 1976 行）

boulder 会话的主编排器。决策门：会话类型 → 中止检查 → 失败计数 → 后台任务 → 智能体匹配 → 计划完整性 → 冷却（5s）。在 session.idle 时注入延续提示。

ralph-loop（14 文件，约 1687 行）

通过 /ralph-loop 命令的自引用开发循环。状态保存在 .sisyphus/ralph-loop.local.md。检测 AI 输出中的 <promise>DONE</promise>。默认最多 100 次迭代。

todo-continuation-enforcer（13 文件，约 2061 行）

"Boulder" 机制。强制智能体在 todo 未完成时继续。2s 倒计时吐司 → 延续注入。指数退避：30s 基准，失败 ×2，最多 5 次连续失败后暂停 5 分钟。

keyword-detector（约 1665 行）

从用户输入检测模式：ultrawork、search、analyze、prove-yourself。注入模式特定的系统提示。

rules-injector（19 文件，约 1604 行）

从 AGENTS.md、配置、技能规则的条件规则注入。评估条件以确定适用的规则。

独立钩子（位于 src/hooks/ 根目录）

如何添加钩子

1. 在 src/hooks/{name}/index.ts 创建 createXXXHook(deps) 工厂
2. 在适当的层级文件注册（src/plugin/hooks/create-{tier}-hooks.ts）
3. 将钩子名称添加到 src/config/schema/hooks.ts HookNameSchema
4. 钩子接收 (event, ctx) — 返回值取决于事件类型

（文件结束 — 共 167 行）