让 AI 从被动等待指令转为主动推进目标，支持自主任务执行、进度追踪与状态恢复，适合长期项目管理。
说明：
## 核心用法
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 静默”规则 |
| 目标漂移/范围蔓延 | 强制子任务拆解 + 依赖管理 |
会员专属
