核心用法
HZL（HZL Tasks）是一款专为 AI Agent 设计的本地优先 CLI 任务管理工具，弥补 OpenClaw 缺乏原生任务追踪的短板。核心工作流围绕项目-任务-子任务三层结构展开，支持通过 hzl workflow run start 快速进入工作状态，或手动执行 hzl task claim --next 认领队列中的下一项任务。
关键操作路径：
- 单 Agent 场景：创建统一项目（如
openclaw），所有任务集中管理 - 多 Agent 场景：按角色分池（
research/coding/writing等），通过--project路由实现弹性扩缩 - 任务委托：使用
hzl workflow run handoff/delegate实现原子化工作交接，支持依赖阻断和租约传递 - 断点恢复：通过
hzl task checkpoint记录关键里程碑，结合--lease租约机制防止任务孤儿化
显著优点
1. 会话边界穿透：任务状态持久化至本地 SQLite，Agent 重启后可精确恢复至上次断点
2. 多 Agent 安全协作：租约（lease）机制防止任务重复认领，--stale 检测识别卡死任务
3. 灵活路由策略：支持显式 Agent 绑定（--agent kenji）和隐式池路由（仅指定 --project）
4. 依赖图管理：原生支持跨项目依赖，hzl dep list --cross-project-only 洞察协作瓶颈
5. 云同步可选：通过 Turso/libSQL 实现团队级状态同步，本地优先不强制联网
潜在局限
- 无自动编排：不主动分配任务或分解需求，需上层协调逻辑
- 仅支持单层子任务：
--parent嵌套深度受限，复杂 WBS 需平铺设计 - Hook 覆盖有限：仅
on_done触发 webhook，其他状态变化需轮询检测 - CLI 依赖较重：相比 TodoWrite 等 IDE 集成方案，交互链路更长
适合人群
- 长期运行任务：需跨多次对话/会话完成的复杂项目
- 多 Agent 团队：研究、开发、写作等角色分离的协作场景
- 可靠性敏感场景：不能容忍"幻觉遗忘"关键步骤的严肃工作流
常规风险
- 数据破坏命令：
hzl init --force --yes和hzl task prune --yes不可逆删除数据，需用户显式授权 - 租约过期：未及时处理
--stale任务可能导致协作死锁 - Agent ID 冲突：多个会话使用相同
--agent标识将引发租约竞争 - 同步延迟：云模式下
hzl sync非实时，高频协作需配合轮询策略