HZL 技能综合评估
HZL 是一款专为 AI Agent 设计的本地优先任务账本工具，核心定位是填补 OpenClaw 缺乏原生任务追踪的空白。与 Claude Code 的 TodoWrite 或 Codex 的 update_plan 不同，OpenClaw 依赖内存和 Markdown 文件追踪工作，HZL 通过持久化存储实现跨会话恢复和多智能体协调。
核心用法
HZL 采用「项目-任务-子任务」三级结构，支持单智能体和多智能体两种部署模式。单智能体使用统一项目（如 openclaw），所有任务集中管理；多智能体场景则按角色划分项目池（research/writing/coding 等），通过 --next 实现无特定代理的任务认领。关键工作流包括：
- 会话启动：
hzl workflow run start自动处理过期租约回收和新任务认领 - 任务生命周期：
add→claim→checkpoint→complete，支持依赖管理和状态流转（backlog/ready/in_progress/done/blocked） - 跨代理委托：
workflow run handoff原子化完成当前任务并创建后续任务，delegate支持带依赖的子任务委托 - 租约机制：
--lease参数防止任务 orphaned，配合hzl task stuck检测和steal回收
显著优点
1. 会话边界免疫：Checkpoint 机制确保工作可精确恢复，解决 Agent 重启或会话中断后的状态丢失问题
2. 多代理协调原生支持：项目池路由、租约过期检测、跨项目依赖追踪，降低分布式协作的认知负荷
3. 本地优先+可选云同步：默认 SQLite 本地存储，支持 Turso/libSQL 云端同步，兼顾隐私与灵活性
4. Hook 回调集成：任务完成时自动触发 webhook，可与 OpenClaw 网关联动实现事件驱动
5. Web Dashboard：内置 hzl serve 提供可视化界面，支持 systemd 常驻部署
潜在局限
- 无自动编排：不主动分配任务或分解需求，需外部编排层驱动
- 无智能调度：仅支持优先级+FIFO 简单排序，无时间预估、负载均衡等高级特性
- 单级子任务限制：
--parent仅支持一层嵌套，复杂工作分解需扁平化处理 - 依赖 CLI 熟练度：工作流涉及 15+ 子命令，初学者易混淆
claim/steal/handoff等场景适用条件 - Hook 需外部调度：回调投递依赖
hzl hook drain周期性执行，无内置 daemon 需配合 cron
适合人群
- 使用 OpenClaw 且需跨会话持久化任务的开发者
- 运行多 Agent 协作系统（如研究-写作-编码分工）的团队
- 需要任务可追溯性和审计日志的合规场景
- 对数据主权敏感、偏好本地存储的用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| **数据销毁** | `init --force` 和 `task prune --yes` 不可逆删除，文档已明确警告 |
| **租约冲突** | 多 Agent 共享数据库时若 `--agent` ID 重复或租约过长，可能导致任务假死 |
| **依赖循环** | 跨项目依赖需手动运行 `hzl validate` 检测，系统不阻止有环图的创建 |
| **Hook 堆积** | 未配置 cron 时 `on_done` 回调仅入队不投递，形成静默失败 |
| **版本兼容性** | `workflow run` 系列命令需 HZL v2+，旧版需回退至手动模式 |
来源可信度说明
HZL 为 GitHub 开源项目（tmchow/hzl），有明确版本发布和文档站点，但安全报告为系统占位符未实际扫描。建议生产环境使用前审计 hzl 二进制或从可信渠道（Homebrew/npm）安装。