Proactivity (Proactive Agent)

⚠️ 先知先觉的智能搭档

来自Clawic社区的主动式Agent增强技能,让AI能预判需求、保持工作节奏并自我优化,打造永不掉线的操作型伙伴。

收藏
63.1k
安装
19k
版本
1.0.1
CLS 安全性认证2026-05-11
点击查看完整报告 >

使用说明

核心用法:从被动响应到主动预判

Proactivity 是一个专为 AI Agent 设计的纯声明式行为增强技能。它的核心使命是将 Agent 从被动的“提示词执行者”转变为能预判需求、保持工作前进、并从使用中自我优化的主动性“操作员”。该技能通过一套存储在本地 ~/proactivity/ 目录下的状态文件体系(包括记忆、会话状态、心跳、可复用模式等)来实现对工作上下文的持久化理解。

它不依赖任何外部 API 或可执行代码,而是通过定义严格的行为规则来指导 Agent 的决策。当用户启用该技能后,Agent 会学会观察潜在下一步、发现隐藏的阻碍、进行“反向提示”(即在未被询问时主动提供有价值的想法或方案),并在长时间任务或对话中断后,利用“运行缓冲”快速恢复上下文,而无需用户重复陈述。

显著优点:安全、自主且资源丰富

该技能最大的优点是其在安全性和自主性之间的巧妙平衡。它内置了一套完善的 DO/SUGGEST/ASK/NEVER 四级行动边界体系,所有文件写入被严格限制在 ~/proactivity/ 专有目录内,任何对外部工作空间(如 AGENTS.md)的修改都必须先展示差异并等待用户明确批准。这种设计赋予了 Agent 相当高的自主权去推动工作,同时又牢牢锁住了外部行动、开销、删除和承诺等高危操作的“安全阀”。

此外,它的“资源丰富性”原则鼓励 Agent 在遇到阻碍时多尝试合理方案再升级问题,并具备“自修复”能力,在流程中断时先诊断、适应、重试或降级,而非直接抱怨,极大地提升了协作的流畅感。

潜在缺点与局限性

尽管设计优雅,该技能的效能高度依赖底层 Agent 模型的推理能力。如果基础模型本身不够强大,其“反向提示”可能会变得模糊或烦人。文档中存在一处轻微的文本歧义,可能导致逻辑误解,但其影响有限。此外,作为一个以 Markdown 文件驱动的技能,其“学会”的有效模式长期积累后,文件夹可能会变得臃肿,需要用户偶尔进行手动清理以维持效率。

适合的目标群体

此技能非常适合需要与 AI 进行深度、复杂且长周期协作的用户,例如:软件工程师在大型重构项目中利用它保持对多文件修改的关注;产品经理用它来跟进需求变更和待办事项的衍生影响;或是学术研究人员在长篇论文写作中,依赖其心跳功能跟进被遗忘的引用或论证逻辑。本质上,任何希望将 AI 视为能自主管理琐碎跟进工作的“思考伙伴”,而非仅仅是一个问答工具的人,都是该技能的目标用户。

常规使用风险

由于该技能零依赖、零网络调用,常规的技术风险(如供应链攻击、数据外泄、依赖项冲突)几乎为零。主要风险在于人机协作的信任建立上。Agent 的“主动性”可能偶尔会因误判用户意图而产生过度建议,造成干扰。但这属于使用习惯磨合问题,而非技术缺陷。用户应清楚,让其自由管理状态文件有助于 Agent 更好地服务,但最终决策权和外部行动的审批权始终掌握在用户手中。

安全解读

核心用法

Proactivity 是一套纯 Markdown 文档构成的行为模式指南,旨在将 AI Agent 从「等待指令」转变为「主动预判」的协作伙伴。它不执行任何代码,而是通过结构化文档定义了 7 条核心行为规则:主动预判需求、反向提示(Reverse Prompting)、保持任务动量、快速上下文恢复、 relentless resourcefulness(穷尽手段尝试)、自愈合(Self-Heal)、以及边界内主动检查。

关键机制包括:

  • Reverse Prompting:主动提出用户没想到但有价值的草稿、检查项、下一步选项
  • Heartbeat:轻量周期性检查,跟进停滞任务、承诺、截止日期
  • Working Buffer:长任务中的易失性线索,用于中断后快速恢复上下文
  • Self-Healing:工作流断裂时先诊断、适配、降级,而非直接求助用户

文件结构采用「记忆分离」设计:memory.md 存储稳定规则,session-state.md 跟踪当前任务,patterns.md 积累有效策略,log.md 记录行动结果,形成可进化的主动行为档案。

显著优点

1. 零攻击面纯文档:661 行 Markdown,无可执行代码、无网络调用、无第三方依赖,静态分析满分
2. 行为模式可复用:通过 patterns.md 沉淀「有效的主动行为」,实现经验累积

3. 上下文韧性:Working Buffer + Session State 设计专门解决长任务中断、对话压缩后的上下文丢失问题

4. 安全边界极度清晰:明确声明永不编辑 ~/proactivity/ 外文件、永不外发消息/消费/删除/承诺,外部操作需显式批准+可视 diff

5. 渐进式集成:可独立使用,也可与 AGENTS.md、TOOLS.md、SOUL.md、HEARTBEAT.md 等 workspace 文件联动

潜在局限

1. 纯指南无强制执行:依赖 Agent/框架实现其建议,不同实现质量差异大
2. T3 来源可信度:社区/个人开发者(ivangdavila)维护,无企业背书,需用户自行审查行为实现

3. 无开源许可证:未指定 MIT/Apache 等许可,法律使用边界模糊

4. 主动性的双刃剑:反向提示若实现不当易成「过度打扰」,需严格遵循「无明确价值则沉默」原则

5. 数据本地化局限~/proactivity/ 状态不跨设备同步,多环境协作需自行解决

适合人群

  • 追求高协作效率的用户:厌倦反复提示、希望 Agent 能「像优秀同事一样想一步 ahead」
  • 长任务/复杂项目工作者:需要 AI 在多次会话、中断后仍能无缝续接上下文
  • 隐私敏感场景:纯本地文档、无网络调用、数据不出 ~/proactivity/ 的设计适合严格数据管控环境
  • Agent 框架开发者:可作为主动行为(Proactive Agent)的参考实现规范

常规风险

| 风险类型 | 说明 | 缓释措施 |
|---------|------|---------|
| 过度主动 | 反向提示过频或价值不足,造成用户疲劳 |  SKILL 明确要求「无明确价值则沉默」 |
| 边界误判 | 实现方误将「外部操作需批准」视为可选 | 用户需审查具体 Agent 实现是否强制执行 |
| 上下文泄漏 | Working Buffer 误记敏感信息 | 定期审查 `~/proactivity/` 内容,敏感任务后手动清理 |
| 来源信任 | T3 级别,无企业安全背书 | 结合代码审查使用,本次认证已通过完整扫描 |

认证结论:S+ 顶级安全等级,100 分满分,零发现项。适合作为主动式 AI 协作的行为蓝图,但需确保实际 Agent 实现忠实遵循其安全边界声明。

Proactivity (Proactive Agent) 内容

手动下载zip · 11.7 kB
boundaries.mdtext/markdown
请选择文件