核心用法
Proactive Tasks 是一套面向 AI 代理的主动式任务管理系统，通过 CLI 工具与心跳机制实现「目标拆解 → 自主执行 → 状态同步 → 人机协同」的闭环。
典型工作流：
1. 用 add-goal 创建长期目标，附加优先级与背景上下文
2. 用 add-task 拆解为可 15-60 分钟完成的子任务，设置依赖关系
3. 心跳触发时执行 next-task 获取当前最高优先级可执行任务
4. 自主工作 10-15 分钟后，用 mark-progress、complete-task 或 mark-needs-input 更新状态
5. 关键节点（完成、阻塞、重大发现）主动推送消息给人类
生产级可靠性机制（v1.2.0）：
- WAL 协议：关键操作先写日志再改数据，防上下文截断丢数据
- SESSION-STATE.md：作为"RAM"实时保存当前任务状态，截断后秒级恢复
- Working Buffer：60%-100% 上下文危险区自动追加操作记录
- Health Check：自检修复 5 类常见数据异常（孤儿任务、状态冲突等）
- VBR 原则：标记完成前必须端到端验证，杜绝"代码写了=功能好了"的幻觉
显著优点
- 真正自主：心跳驱动无需人工催办，适合长周期项目持续推进
- 抗上下文截断：多层恢复机制确保会话重启后无缝衔接
- 防幻觉设计：VBR 强制验证、WAL 持久化、health-check 自修复三位一体
- 人机边界清晰：明确区分"自主执行"与"需要人类决策"的触发条件
- 轻量可嵌入：纯 CLI + JSON 存储，无外部依赖，易于集成到现有工作流
局限与风险
- 依赖心跳配置：若未正确设置 cron/heartbeat，退化为被动工具
- 无内置并发控制：多代理同时操作同一任务可能产生竞态（需外部协调）
- 时间估算偏乐观：
actual_time与estimate偏差需人工复核 - 消息策略需调教：默认"不 spam"原则下，新手代理可能过于保守或过于活跃
适合人群
- 需要 AI 长期自主跟进复杂项目的深度用户
- 对"上下文截断丢进度"有痛点的 Claude/Claude Code 用户
- 愿意配置心跳 cron 的技术型用户（非开箱即用）
- 追求"代理即伙伴"而非"代理即工具"的理念采纳者
常规风险
| 风险场景 | 缓解措施 |
|---------|---------|
| 上下文截断导致状态丢失 | WAL + SESSION-STATE + Buffer 三层恢复 |
| 代理误报任务完成 | VBR 强制端到端验证 |
| 数据文件损坏 | health-check 自动修复 4/5 类问题 |
| 心跳 spam 干扰人类 | HEARTBEAT.md 明确"HEARTBEAT_OK 静默"规则 |
| 目标漂移/范围蔓延 | 强制子任务拆解 + 依赖管理 |