HZL

核心用法

HZL 是一款 CLI 驱动的任务账本工具，设计目标是为 OpenClaw 等缺乏原生任务跟踪能力的智能体框架提供持久化工作流支持。其核心使用模式围绕「项目-任务-子任务」三级结构展开，通过 hzl task add、hzl task claim、hzl task checkpoint、hzl task complete 四个基础命令完成工作的全生命周期管理。

会话启动流程：智能体首先运行 hzl workflow run start（HZL v2+）或手动检查 hzl agent status 与 hzl task stuck 来恢复过期租约的任务，随后通过 --next 参数认领下一个可用任务。任务执行过程中，应在关键里程碑前调用 hzl task checkpoint 记录进度快照，确保其他智能体可在会话中断后无缝恢复。

多智能体协调：HZL 采用「项目池」模式实现路由——将任务分配给项目而非特定智能体，任何监控该池的智能体都可通过 --next 认领。租约机制（--lease 30）防止任务被遗弃，结合 hzl task steal --if-expired 实现故障转移。

显著优点

1. 会话边界生存：与 Claude Code 的 TodoWrite 或 Codex 的 update_plan 不同，HZL 的数据持久化在本地 SQLite，重启后状态完整保留
2. 多智能体原生支持：项目池路由、跨项目依赖、hzl workflow run handoff/delegate 等命令专为协作设计
3. 防御性设计：显式区分破坏性命令（--force --yes 需用户确认），租约机制避免任务孤儿问题
4. 可选云同步：通过 Turso 的 libsql 协议实现多端同步，同时保持本地优先架构
5. Web 仪表盘：hzl serve 提供实时可视化，支持 systemd 后台常驻

潜在局限

• 无自动编排：不主动派生智能体或自动分解任务，需外部编排层介入
• 调度逻辑简单：纯优先级+FIFO，无智能负载均衡或时间预估
• 通知机制有限：仅 on_done 支持 webhook，其他状态变化需轮询
• 依赖 OpenClaw 的 exec 工具：本身不内置 LLM 交互能力，需通过框架调用

适合人群

• 使用 OpenClaw 且需要跨会话持续工作的开发者
• 构建多智能体系统的团队，需要明确任务交接与故障恢复机制
• 偏好本地优先、避免供应商锁定的工作流用户
• 需要将「计划-执行-检查-恢复」流程显式化的复杂项目管理场景

常规风险

1. 数据丢失风险：hzl init --force --yes 会无确认删除全部数据，且不可撤销
2. 租约过期误判：若智能体崩溃未正常释放租约，其他智能体需等待过期或手动 steal
3. 依赖循环：跨项目依赖可能形成环路，需定期运行 hzl validate 检查
4. hook 延迟：on_done 通知非实时，依赖 cron 周期的 hzl hook drain，紧急流程不宜强依赖
5. 并发冲突：虽租约机制缓解，但共享数据库场景下仍可能出现竞态条件，需确保 --agent ID 唯一性

核心功能

HZL 是一款本地优先的任务账本 CLI 工具，专为 AI 代理协作场景设计，解决 OpenClaw 缺乏原生任务追踪的痛点。它通过 hzl 命令行提供完整的项目管理能力，包括多步骤任务规划、跨会话断点续作、代理间工作委派与池化路由。

显著优点

1. 会话持久化：任务状态存储在本地数据库（~/.hzl/），工作进度可跨会话保留，支持"精确续作"
2. 多代理协调：通过 Project Pool 路由和 Lease 机制实现任务分配，支持 stuck 检测与任务窃取恢复
3. 原子化工作流：workflow run handoff/delegate 实现任务交接的原子操作，避免状态不一致
4. 依赖管理：支持任务间依赖关系（--depends-on），可查询跨项目阻塞项
5. 轻量无侵入：纯 Markdown Skill（T-MD 分类），无动态代码，通过 exec 调用外部 CLI

潜在局限

1. 无自动编排：不自动派生代理或分配任务，需配合外部编排层
2. 无智能分解：不自动拆解任务，依赖人工或上层代理规划
3. 通知延迟：生命周期 hooks 非实时，依赖 cron 轮询（2-5分钟延迟）
4. T3 来源风险：维护者为个人开发者（tmchow），虽仓库活跃（12个月/50 stars）但无组织背书
5. 破坏性操作：--force 初始化会清空数据，误操作风险需警惕

适合人群

• OpenClaw 用户：弥补其缺乏 TodoWrite/update_plan 的原生缺陷
• 多代理团队：需要跨代理协调、任务池路由、故障恢复的场景
• 长周期项目：任务可能跨多次会话完成，需要精确断点续作
• CLI 偏好者：习惯命令行操作、追求本地优先数据控制的开发者

常规风险

| 风险类型 | 说明 |

|---------|------|

| 数据丢失 | `hzl init --force` 会删除全部数据，建议定期备份 `~/.hzl/` |

| 任务冲突 | 多代理环境需正确配置 lease 时长，避免并发认领 |

| 依赖循环 | 虽支持 `hzl validate` 检查，但需主动运行 |

| 来源可信度 | T3 级别，生产环境建议额外人工审查 |

版本要求

• HZL v2+ 支持 workflow run 命令
• 旧版本需使用 manual fallback 模式

综合建议：适合作为 OpenClaw 生态的任务追踪补充，尤其推荐多代理协作场景；单代理短期任务可酌情简化使用。