Hooks 是 Kiro 的自动化工作流引擎，让 Agent 在特定事件发生时自动执行任务。随着项目扩大，hooks 数量也会增加，掌握基本的管理操作——开关、编辑、删除、手动触发——是保持工作流整洁高效的基础。本文介绍通过 Kiro 面板对 hooks 进行全生命周期管理的具体操作方式。

Hooks 随项目演进而积累，合理管理才能保持自动化流程清晰可控。所有 hooks 操作都在 Kiro 面板的 Agent Hooks 区域完成。

启用与禁用 hooks

临时关闭某个 hook 时无需删除，直接切换开关即可：

• 快速切换：在 Agent Hooks 面板中，点击 hook 名称旁边的眼睛图标
• 从 hook 详情页切换：选中 hook 后，在右上角使用 Hook Enabled 开关

关闭后，该 hook 的配置完整保留，随时可以重新开启。

编辑现有 hooks

在 Agent Hooks 面板中选中要修改的 hook，然后调整以下任意设置：

• 触发类型（trigger type）
• 文件匹配模式（file patterns）
• 执行指令（instructions）
• 描述（description）

修改保存后立即生效，不需要重启。

删除 hooks

1. 在 Agent Hooks 面板中选中目标 hook
2. 点击底部的 Delete Hook 按钮
3. 确认删除

注意：此操作不可撤销。 确认前请先检查是否有其他 hook 依赖该逻辑。

手动触发 hooks

对于触发类型为 Manual Trigger 的 hooks，有两种执行方式：

• 快速运行：在 Agent Hooks 面板中，点击 hook 名称旁边的播放按钮（▷）
• 从详情页执行：选中 hook 后，点击右上角的 Start Hook

手动触发常用于按需代码审查、文档生成、安全扫描等场景，不受自动事件限制。

常见问题

Q：禁用 hook 后再重新启用，原来的配置会丢失吗？

不会。禁用只是暂停触发，所有配置（触发类型、文件模式、指令）都完整保留，重新开启后立即恢复工作。

Q：可以同时管理多个 hooks 吗，比如批量删除？

目前 Kiro 面板只支持逐个操作。如果需要批量清理，可以直接编辑 .kiro/hooks/ 目录下的配置文件（JSON 格式）。

Q：修改 hook 触发条件后需要重启 Kiro 吗？

不需要。对 hook 配置的任何修改都会立即应用，下一次满足触发条件时就会使用新配置执行。