多智能体持久化任务账本与协作中枢

本地优先的多智能体任务账本工具，支持跨会话持久化、项目池路由与协作，适合复杂多步骤工作流管理

基本信息

• 技能名称?HZL
• 中文名称?多智能体持久化任务账本与协作中枢
• 作者?tmchow
• 分类?专业技能
• 版本?3.1.0
• 标签?task-management, multi-agent, cli, local-first, workflow-orchestration, project-coordination

使用方法

使用说明
核心功能
HZL 是一款专为 AI Agent 设计的本地优先任务账本系统，通过 hzl CLI 提供多步骤工作规划、进度检查点和跨会话持久化能力。其核心定位是填补 OpenClaw 缺乏原生任务追踪的空白，支持单 Agent 项目管理和多 Agent 池路由两种模式。
主要特性
任务层级与状态管理 ：支持项目→父任务→子任务三级结构，内置 backlog → ready → in_progress → done → blocked 完整状态流转，支持依赖关系和最大一层嵌套。
多 Agent 协调机制 ：通过项目池（pool routing）实现角色级任务分配——省略 --agent 参数时任务进入公共池，任何监控该池的 Agent 均可认领；指定 --agent 则实现专属路由。结合 --lease 租约机制防止任务孤儿，支持 task steal 回收过期任务。
会话恢复与检查点 ： checkpoint 命令记录关键进度快照，配合 workflow run start 实现跨会话无缝恢复。推荐在工具调用前、子 Agent 派生前、暂停前等关键节点打点。
工作流命令（v2+） ： handoff 实现原子化任务交接， delegate 支持带依赖关系的子任务委派并可暂停父任务，简化多 Agent 协作流程。
显著优点
本地优先架构 ：数据自主可控，支持可选的 Turso/LibSQL 云同步
明确的协作契约 ：租约、依赖、状态机提供清晰的 Agent 间协作语义
灵活的路由策略 ：单共享项目或多项目池模式适配不同团队规模
丰富的可观测性 ： agent status 、 task stuck 、 events NDJSON 流、内置 Web Dashboard
潜在局限
无自动编排 ：不自动派生 Agent 或分解任务，需外部编排层驱动
简单调度策略 ：仅支持优先级+FIFO，无智能负载均衡
钩子延迟 ： on_done 通知通过 cron 轮询（2-5分钟），非实时推送
嵌套限制 ：子任务仅支持单层，复杂层级需扁平化处理
适用场景
适合需要「精确断点续作」的多步骤项目、跨 Agent 工作交接、长期运行可能中断的任务编排。不适合即时单步任务、时间提醒或长文知识库管理。
风险提示
hzl init --force 和 --yes 组合会 无确认删除全部数据 ； task prune --yes 永久清除历史记录，无回滚机制。建议生产环境配合定期备份。