核心能力
proactive-tasks 是一套目标与任务管理系统,将传统"等待指令"的 AI 助手转变为"主动推进"的协作伙伴。其核心机制包括:
- 目标-任务层级管理:通过 CLI 将宏大目标拆解为 15-60 分钟可完成的原子任务
- 心跳驱动自治:配合 cron 定时触发,每 30 分钟自动检查并执行待办任务
- 智能状态流转:pending → in_progress → completed / blocked / needs_input 的完整生命周期
- 人机异步协作:完成里程碑或遇阻时主动向人类发送更新,无需实时在线
显著优点
1. 突破对话上下文限制:长期项目不再依赖人类持续输入,AI 在会话间隙持续推进
2. 结构化进度追踪:JSON 持久化存储、依赖关系管理、优先级自动排序
3. 低侵入集成:纯 CLI 工具 + 文件存储,无外部 API 依赖,与任何工作流兼容
4. 抗遗忘机制:心跳模板明确禁止"推断或重复旧任务",避免幻觉式回溯
潜在局限
- 单用户本地存储:
data/tasks.json基于文件系统,无多用户同步或网络协作能力 - 缺乏可视化界面:纯命令行操作,复杂项目管理依赖人类手动维护
- 心跳配置门槛:需用户自行配置 cron 和 HEARTBEAT.md,技术门槛较高
- 无冲突解决机制:并发编辑或目标调整时缺乏版本控制或合并策略
适合人群
- 需要 AI 长期自主执行 复杂项目的开发者/技术用户
- 希望 AI 在异步模式下工作(非实时对话)的场景
- 已有本地开发环境、习惯 CLI 工作流的用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 权限失控 | 心跳周期内 AI 可能执行未预期的任务,需严格限制脚本权限 |
| 状态漂移 | 手动编辑 tasks.json 或异常中断可能导致数据损坏 |
| 消息泛滥 | 配置不当可能导致高频无意义更新,建议遵循"里程碑/阻塞才汇报"原则 |
| 目标误解 | 自主拆解任务时可能对原始意图理解偏差,需人类定期校准 |
使用建议
优先用于研究型、探索型、构建型长期项目(如硬件开发、技术调研),避免用于需高频实时决策的紧急任务。建议结合 git 版本控制 tasks.json,并设置每日/每周人工复盘节点。