Skip to content

Kiro CLI Agent Hooks 在 2.0.x 版本中完全不触发

问题

kiro-cli v2.0.0 或 v2.0.1 中,配置好的 agent hooks(包括 agentSpawnuserPromptSubmitpreToolUse 等所有事件类型)从未被触发,就像 hooks 不存在一样。

  • .kiro/hooks/ 目录下的 hook 配置文件语法正确
  • 脚本手动执行完全正常
  • TUI 模式和 legacy-ui 模式下均不触发

解决方案

升级到 kiro-cli v2.1.0 或更高版本。

此问题是 v2.0.x 中的 hook dispatch 机制 bug,官方在 v2.1.0 中已修复。

bash
# 查看当前版本
kiro-cli --version

# 通过官方下载页或包管理器升级到 2.1.0+

验证

升级后可以用一个简单的 agentSpawn hook 测试:

json
{
  "hooks": [
    {
      "type": "agentHook",
      "event": "agentSpawn",
      "actions": [
        {
          "type": "runCommand",
          "command": "echo 'hook triggered' >> /tmp/kiro-hook-test.log"
        }
      ]
    }
  ]
}

启动一个 chat 会话,然后检查 /tmp/kiro-hook-test.log 是否有输出。

来源GitHub Issue #7697