⑤ 配置第一个事件触发器

目标

配置一个 Event Trigger：GitHub 上有新 PR 就自动触发代码审查 Agent。

前置条件

• 已完成教程 ③，能手工跑审查
• 有一个 GitHub 仓库的管理员权限

步骤

Step 1：准备 Trigger 配置（5 分钟）

工作台 → Event Trigger → 创建触发器：

• 名称：github-pr-auto-review
• 事件源：GitHub Webhook
• 过滤规则：
  • repo = myorg/myrepo
  • event_type = pull_request
  • action ∈ [opened, synchronize]
• 目标 Session 策略：按 repo/pr_number 复用（同一个 PR 进同一个 Session）

Step 2：绑定目标技能与提示词（10 分钟）

Trigger 落到 Session 后的提示词：

有一个 PR 事件：{{payload.pull_request.html_url}}
动作是 {{payload.action}}。
请调用 /code-review 审查该 PR，按 MISRA-C:2012 规则集，回帖到 PR 评论。

注意：触发器只管投递，Agent 按提示词决定做什么——想改成"审查 + 跑测试"只需改提示词。

Step 3：配置 GitHub Webhook（5 分钟）

系统会生成一个 Webhook URL，类似：

https://combo-agent.example.com/webhooks/{tenant}/gh-pr-auto-review
Secret: <HMAC key>

在 GitHub 仓库 → Settings → Webhooks → 添加：

• Payload URL = 以上 URL
• Content type = application/json
• Secret = 以上 Key
• Events = Pull requests

Step 4：触发测试（5 分钟）

在你的仓库里提一个小 PR。观察：

1. GitHub 显示 webhook 调用成功（200）
2. 工作台 → Trigger 日志 显示事件被接收
3. 对应 Session 自动创建，Agent 开始审查
4. PR 评论区出现 AI 审查结果

Step 5：调优（5 分钟）

根据实际情况调整：

• Debounce — 同一 PR 一分钟内多次 push 合并为一次触发
• ConflictPolicy — 同一 Session 上次审查未完成前，新事件是 skip / queue / parallel
• Filter 规则 — 过滤 Draft PR、过滤特定文件路径

验收清单

• ✅ 新建 PR 会自动产生一次 AI 审查
• ✅ 连续多次 push 不会重复触发审查（debounce 生效）
• ✅ Agent 审查结果已出现在 PR 评论区
• ✅ Trigger 日志完整可查

下一步

• 完整的 Event Trigger 机制
• Cron 定时调度 — 如果你想要"定时触发"而不是"事件触发"
• Webhook 集成参考
• Webhook 事件清单

常见问题

Q：触发器失败了怎么排查？ A：工作台 → Trigger 日志，每次投递都有完整记录。失败事件会进入死信队列。

Q：能让多种事件复合触发吗？ A：可以，用 Compound Trigger。例如"PR 打开 且 CI 通过"才触发审查。