用于智能体协调的持久任务账本。规划多步骤工作,跨会话边界记录检查点进度,并协调多个智能体。

安装

概览

什么是HZL

HZL(https://hzl-tasks.com)是一个专为智能体协作设计的本地优先任务账本系统,用于管理多步骤工作的规划与执行。它通过将复杂项目分解为可追踪的任务层级结构,帮助团队在多会话、多智能体环境中保持工作连续性。与传统的内存或Markdown文件记录方式不同,HZL提供持久化存储和结构化状态管理,确保即使会话中断或智能体切换,也能精确恢复进度。其核心理念是‘断点续做’——在关键节点创建检查点,使其他智能体能够无缝接手未完成的工作,特别适合需要跨角色协作或长期运行的项目场景。 该系统支持单代理和多代理两种部署模式。在单代理场景中,所有工作集中于一个共享项目下,便于集中管理;而在多代理环境中,则采用‘项目池路由’机制,每个职能角色(如研究、写作、开发)对应独立项目,任务可被任意具备资格的代理领取,实现负载均衡与职责分离。同时,HZL允许指定特定代理处理敏感任务,兼顾灵活性与控制力。通过引入租约(lease)机制,系统能自动检测并回收被遗弃的任务,防止数据丢失或重复劳动。 此外,HZL强调轻量级集成与可扩展性。它不替代编排引擎,而是作为可靠的中间层,配合外部调度器使用。虽然目前仅支持Webhook形式的生命周期钩子(如`on_done`),但已足够支撑大多数自动化流程。用户可通过命令行界面直接操作任务状态流转(待办→就绪→进行中→完成/阻塞),并结合依赖关系图避免循环阻塞。整体设计注重实用性而非过度抽象,适合追求高效协作又不失可控性的AI辅助开发环境。

核心功能特点

  1. 支持多步骤项目的任务规划与父子任务嵌套结构
  2. 跨会话边界保存检查点进度,实现精准恢复能力
  3. 基于项目池的路由机制协调多个智能体间的任务分配
  4. 通过租约系统自动识别和处理卡死任务,保障工作流健壮性
  5. 提供依赖关系管理与循环验证功能,防止逻辑冲突
  6. 内置Web仪表盘实时监控任务状态与代理活动

适用场景

HZL最适用于那些具有明确阶段划分、可能跨越多个会话或涉及不同智能体角色协作的复杂项目。例如,在一个产品迭代周期中,前端开发完成后需交由后端服务联调,再由测试团队验证——这类需要交接且不能丢失上下文的情境正是HZL的优势所在。当某个智能体因外部因素暂停工作时,另一个代理可通过查看最新检查点快速理解当前进展,继续推进而不必重新分析需求文档。对于大型知识库构建、自动化测试流水线搭建等长期任务,HZL的检查点机制能有效降低重启成本,提升整体效率。 在企业级AI团队协作场景下,HZL的多代理支持尤为突出。假设存在专门负责信息搜集的研究员代理、专注内容创作的写手代理以及擅长代码实现的工程师代理,他们各自维护独立的项目池。此时,一条‘调研竞品定价策略’的任务会被放入research项目,任何空闲的研究员均可领取;而一旦生成报告,后续撰写分析报告的任务则转入writing项目,等待下一位可用写手接手。这种松耦合但有序的协作模式既避免了资源争抢,又保证了任务流向清晰可控。此外,若某位代理意外终止,系统会自动标记其持有的租约为过期状态,其他代理可安全接管,极大增强了容错能力。 值得注意的是,HZL并不适合一次性、无分支的小任务。比如‘回复用户邮件’这类即时响应型工作,更适合用即时消息工具处理。同样,纯时间提醒类需求应交给专门的定时任务系统(如OpenClaw Cron)。HZL的价值体现在‘不确定性’较高的场景中:当你无法确定本次会话能否完成某项工作,或者该工作需要多人接力时,就应该启用HZL来建立可靠的工作记忆。简言之,只要存在‘稍后继续’的可能性,就该考虑使用HZL进行结构化跟踪。