Agent Skill + Webhook：让 AI 响应外部事件

从轮询到事件驱动

轮询（每5分钟查一次）简单但浪费资源。Webhook 是反向的——事件发生时对方主动通知你。

Agent + Webhook = AI 只在需要时才工作。

架构

外部服务 -> Webhook -> Skill 处理 -> Agent 响应

实现：接收 GitHub Webhook

步骤 1：创建接收端点

// api/webhook/github.js
export default async function handler(req, res) {
  const event = req.headers['x-github-event'];
  const payload = req.body;
  
  // 验证签名
  const signature = req.headers['x-hub-signature-256'];
  if (!verifySignature(payload, signature)) {
    return res.status(401).json({ error: '签名验证失败' });
  }
  
  // 处理事件
  if (event === 'pull_request' && payload.action === 'opened') {
    await handleNewPR(payload);
  }
  
  res.status(200).json({ ok: true });
}

步骤 2：触发 Agent

async function handleNewPR(pr) {
  // 调用 Agent Skill 分析 PR
  const analysis = await runSkill('code-reviewer', {
    repo: pr.repository.full_name,
    prNumber: pr.number
  });
  
  // 把分析结果评论到 PR
  await postPRComment(pr, analysis);
}

步骤 3：在 GitHub 中注册 Webhook

Settings -> Webhooks -> Add webhook

• Payload URL: https://your-domain.com/api/webhook/github
• Content type: application/json
• Secret: 你的签名密钥

常见 Webhook 场景

• GitHub：PR/Issue 事件 -> 自动代码审查
• Stripe：支付成功 -> 发送确认消息
• Typeform：表单提交 -> 数据入库 + 通知
• Uptime Robot：服务宕机 -> 告警 + 自动修复

安全要点

• 必须验证 Webhook 签名
• 设置超时防止阻塞
• 幂等处理：同一事件多次触发不重复执行