什么是Proactivity (Proactive Agent)
Proactivity（Proactive Agent）是一个把“主动性”做成可持续工作机制的代理技能，目标不是单次回答得更完整，而是让代理在连续任务里更像一位会提前思考、能保持推进节奏的协作伙伴。它围绕一个本地状态目录 `~/proactivity/` 组织信息，把长期稳定的边界和偏好、当前会话进度、周期性检查、可复用模式、最近动作记录，以及长任务中的临时线索分开保存。这样做的重点，是让代理在任务被打断、上下文变长或用户暂时没有继续发话时，依然能判断下一步该做什么，而不是退回到被动等待。
从设计上看，这个工具强调“先想一步”，但又明确限制主动性的边界。它鼓励代理识别缺失步骤、潜在阻塞、过时假设和明显需要跟进的事项，并通过草稿、检查项、备选方案等方式，把下一步有价值的动作提前准备出来。不过这种主动并不等于擅自行动：对于外部沟通、花费、删除、排期和承诺等行为，仍然必须先征得用户同意；任何对 `~/proactivity/` 之外文件的修改，也需要在当前会话中得到明确批准，并先展示可见的拟议改动。
证据包里最值得注意的一点，是它把“恢复上下文”和“自我修复流程”放在了核心规则里。遇到长任务、中断或上下文压缩时，代理应先利用 session state 和 working buffer 重建最近工作，而不是直接要求用户把前情再说一遍；当流程失效时，也应先尝试诊断、调整、重试或降级处理，而不是一遇到问题就上抛。再配合 heartbeat 这种轻量的周期检查，Proactivity 更像是在本地为代理建立了一套持续推进的操作台：既保留记忆，又留下节奏，还能把有效做法沉淀成以后可复用的模式。
核心功能特点
- 用 `~/proactivity/` 维护本地主动状态，把长期规则、当前任务、心跳检查、成功模式和行动记录分层保存
- 强调“反向提示”能力，在时机明确且确有价值时，主动补出检查、草稿和下一步，而不是机械等待新指令
- 支持长任务恢复，通过 session state 与 working buffer 快速重建上下文，尽量避免让用户重复说明已做工作
- 要求持续保持推进，在完成一段工作后留下下一步可执行动作，优先给出进展包、修订草案或准备好的选项
- 内置清晰边界与安全约束：不默认对外发送、不花费、不删除、不承诺，且未经批准不修改 `~/proactivity/` 之外内容
- 不依赖网络即可工作，主动性主要通过本地操作笔记和周期性检查来实现，便于在受控环境中使用
适用场景
它最适合那些不是一句话就能结束、而是需要多轮推进的工作场景。比如用户希望代理承担更强的“项目助理”角色：不仅回答当前问题，还要顺着目标继续往前推，发现还缺哪些步骤、哪些地方可能卡住、哪些承诺或截止时间需要回看。在这类任务里，Proactivity 的价值不在于生成更多内容，而在于让代理在每一轮结束后都能留下一个清晰的下一动作，从而减少流程停摆的空档。
另一个典型场景是长上下文和易中断任务。用户可能在几次会话里反复处理同一件事，中间还会被别的问题打断。如果没有专门的状态管理，代理很容易表现得“失忆”，重新向用户追问已知信息。Proactivity 通过 session-state、log 和 working-buffer 这类本地文件保留当前目标、最近决策和恢复线索，更适合需要连续跟进的整理、分析、排查、方案迭代等工作。即便上下文变脆弱，它的默认思路也是先恢复、再确认缺口，而不是把恢复成本转嫁给用户。
对于希望代理“更主动但不能越界”的团队或个人，这个工具也有现实意义。很多人需要的并不是一个会私自替自己做决定的自动化系统，而是一个懂得在边界内提醒、跟进和补位的协作者。Proactivity 明确把外部沟通、花钱、删除数据、做出承诺等行为排除在默认主动范围之外，同时要求所有超出本地状态目录的修改都先获得批准并展示拟议差异。这让它更适合对可控性、审计性和信任边界要求较高的使用环境。