Proactive Agent

Proactive Agent 是什么

Proactive Agent 是一套面向长期协作代理的架构，重点不是单个工具，而是把记忆、主动检查、上下文恢复和自我改进组织成可持续流程。3.1.0 增加了定时任务选择、实现验证和工具迁移检查。

记忆与上下文恢复

架构使用 SESSION-STATE 保存当前状态，以每日记录和 MEMORY 保存长期信息，并在上下文进入危险区后启用 Working Buffer。WAL 协议要求把纠正、决定和关键细节先写入状态再继续，压缩后则按恢复步骤重新加载上下文。

主动工作模式

它通过心跳、反向提问、跟踪器和 cron 主动发现下一步。定时任务区分 systemEvent 与 isolated agentTurn：前者适合唤醒当前会话，后者适合隔离执行。所有主动动作仍应服从用户授权，不能把“积极”解释为自动发布、删除或扩大权限。

安装、文件与风险

快速开始会把 AGENTS、HEARTBEAT、MEMORY、ONBOARDING、SOUL、TOOLS 和 USER 等模板复制到工作区，并建议运行 shell 安全审计。长期记忆可能保存敏感上下文，定时任务可能持续运行，模板也会影响后续代理行为。ClawHub 当前审计为 Review，启用前应逐文件审查、限定目录并确认隐私边界。

上线方式与治理

建议先在独立工作区安装模板，比较它对现有 AGENTS、MEMORY 和 HEARTBEAT 的影响，再选择性合并。长期记忆应规定允许保存和必须排除的内容，并提供删除、更正和过期机制。定时任务先以低频、只读、静默方式运行；确认结果可信后才逐步增加通知或写操作，同时保留停用开关。

来源与许可

本条目依据 ClawHub halthelobster/proactive-agent 3.1.0 详情、完整 SKILL.md 和安全审计脚本整理，来源页声明 MIT-0。包内还含旧版备份和草稿，实际使用应以当前 SKILL.md 为准。

常见问题

1. 它怎样让代理更主动？

通过心跳、反向提问、跟踪器和定时任务，定期发现可推进事项。实际使用时还应结合当前版本、权限、输入数据和运行环境复核结果，并在重要任务中保留人工确认。

2. 记忆体系包含什么？

包含 SESSION-STATE、每日记录、长期 MEMORY 和上下文高占用时的 Working Buffer。实际使用时还应结合当前版本、权限、输入数据和运行环境复核结果，并在重要任务中保留人工确认。

3. WAL 协议解决什么问题？

先记录关键决定和纠正，再继续行动，减少压缩或中断导致的信息丢失。实际使用时还应结合当前版本、权限、输入数据和运行环境复核结果，并在重要任务中保留人工确认。

4. 什么时候使用 Working Buffer？

当上下文使用量超过约 60% 后，用它记录后续交流和状态变化。实际使用时还应结合当前版本、权限、输入数据和运行环境复核结果，并在重要任务中保留人工确认。

5. 会创建定时任务吗？

架构支持并区分两类 cron，但创建与频率仍需用户明确授权。实际使用时还应结合当前版本、权限、输入数据和运行环境复核结果，并在重要任务中保留人工确认。

6. 安装会改哪些文件？

会把多份代理、记忆、心跳和用户模板复制到当前工作区。实际使用时还应结合当前版本、权限、输入数据和运行环境复核结果，并在重要任务中保留人工确认。

7. 包含哪些安全规则？

包括不把外部内容当指令、删除前确认、不经批准对外发布等边界。实际使用时还应结合当前版本、权限、输入数据和运行环境复核结果，并在重要任务中保留人工确认。

8. 为什么仍需人工审查？

页面为 Review，且长期记忆、模板和自动任务影响范围较广，应逐项核验。实际使用时还应结合当前版本、权限、输入数据和运行环境复核结果，并在重要任务中保留人工确认。