## 一、Skill 定位

`Proactive-Agent` 的重点不是“你问我答”，而是“在正确时间主动做事”。  
它通常与事件、时间、状态变化联动，帮助团队把关键动作前置。

## 二、适用场景

1. 每日站会前自动推送昨天进展与风险。
2. 发布窗口前自动检查关键依赖状态。
3. SLA 超时前自动预警并通知责任人。
4. 周期性巡检后自动汇总异常。

## 三、安装与准备

### 1) 安装命令

```bash
clawhub install proactive-agent
clawhub sync --all
```

### 2) 配置建议

1. 打通消息通知通道（如 Slack/Telegram/邮件）。
2. 先定义事件触发条件，避免“无意义提醒轰炸”。
3. 每个提醒必须有明确接收人与处置动作。

## 四、使用方法

### Step 1：定义触发规则

示例规则：

1. 每天 09:30 自动发送前一日异常汇总。
2. 发布前 30 分钟执行 Checklist，失败则拦截。

### Step 2：配置任务指令

```text
/skill proactive-agent
每天 9:30 自动汇总昨日错误日志 Top5，并推送到项目群，附修复负责人建议。
```

### Step 3：联动定时器

可配合 OpenClaw 的 cron/hook 能力触发执行，形成稳定闭环。

### Step 4：增加升级策略

提醒未处理时二次通知，仍未处理则升级到值班负责人。

## 五、注意事项

1. **提醒必须可执行**：只报问题不提供动作，价值很低。
2. **控制通知噪音**：同类告警要聚合，不要刷屏。
3. **设置静默窗口**：夜间与节假日策略要单独处理。
4. **失败重试要有限制**：避免异常时无限循环触发。
5. **留审计日志**：记录触发时间、对象、执行结果。

## 六、常见问题

1. 提醒延迟：检查时区设置和任务队列积压。
2. 重复提醒：确认去重键是否正确（任务 ID + 时间窗）。
3. 内容空洞：增加“背景、影响、下一步”三段式输出模板。

## 七、落地清单

1. 选 2 个业务高价值提醒先试点。
2. 建立提醒等级（普通/重要/紧急）。
3. 每周复盘触发准确率与处理闭环率。
4. 对无效提醒持续下线，保持轻量高效。

## 八、参考资料

1. Proactive-Agent Skill：https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/proactive-agent
2. OpenClaw Skills 文档：https://docs.openclaw.ai/skills