Kiro CLI + ACP 协议：给飞书接 AI Agent 聊天机器人的实践方案

需求场景

团队想在飞书群里用上 AI 聊天机器人——代码审查、知识库问答、运维查询。从零搭 Agent 运行时工作量太大，需要一个轻量方案。

Kiro CLI 支持 Agent Client Protocol（ACP），可以直接做 Agent 后端。写一层桥接服务翻译飞书消息格式，Agent 推理/工具调用/Session 管理全交给 Kiro CLI。

ACP 协议

跑在 stdio 上的 JSON 通信协议，定义了 Agent 客户端和服务端的交互标准。支持 Session 管理、流式响应、工具调用状态上报。不绑定前端平台。

Custom Agent 示例

~/.kiro/agents/code-review-agent.json：

{
  "name": "code-review-agent",
  "description": "代码审查专用 Agent",
  "prompt": "你是一个代码审查专家，专注于代码质量、安全漏洞和工程实践规范",
  "tools": ["read", "shell"],
  "allowedTools": ["read", "shell"],
  "toolsSettings": {
    "shell": {
      "allowedCommands": [
        "grep", "find", "wc", "head", "tail",
        "cat", "diff", "git diff", "git log"
      ]
    }
  },
  "hooks": {
    "agentSpawn": [
      {
        "command": "git diff --name-only HEAD~1",
        "timeout_ms": 5000
      }
    ]
  }
}

allowedCommands 做权限白名单，hooks 启动时自动获取变更文件。

架构

飞书 WebSocket ←→ 桥接服务 ←→ Kiro CLI (ACP)

飞书话题映射到 ACP Session，一致性哈希路由到固定 Worker。桥接服务内嵌 MCP Server 实现双向集成。

桥接服务配置 config.toml：

log_level = "debug"

[feishu]
app_id = "cli_xxxxxxx"
app_secret = "xxxxxxxxx"

[kiro]
cmd = "kiro-cli"
args = ["acp", "--agent", "code-review-agent"]

踩坑

• 进程池 4-8 个 Worker 够用，别开太多
• 飞书卡片更新攒批（500ms）再刷新
• Session 超时要自动恢复

资源

• Kiro CLI 文档
• 亚马逊云科技官博