任务持久化追踪

技能简介

HZL 是 OpenClaw 的持久化任务数据库，为代理提供跨会话边界的任务追踪能力。它采用本地优先架构（可选云端备份），支持项目与任务的层级管理、进度检查点记录，以及通过租赁机制实现多代理协调。

能做什么

• 将多步骤工作规划为项目+任务结构
• 创建进度检查点，确保工作跨越会话边界后仍可恢复
• 通过租赁机制协调子代理或多个编码工具
• 生成可靠的状态报告（已完成 vs 待完成）
• 提供 Web 仪表盘供人工查看（hzl serve）

使用说明

安装方式（二选一）：

# Homebrew 安装
brew install hzl

# npm 安装
npm install -g hzl-cli

基础使用流程：

1. 初始化数据库：hzl init（首次使用）
2. 确认项目存在：hzl project list，OpenClaw 场景建议使用单一 openclaw 项目
3. 添加父任务：hzl task add "任务名称" -P openclaw
4. 添加子任务：hzl task add "子任务" --parent <父任务ID>
5. 获取下一项工作：hzl task next
6. 更新进度：hzl checkpoint add <任务ID> "进度描述"
7. 完成任务：hzl task done <任务ID>

核心原则：单一项目 + 父任务模式，避免项目泛滥；任何非琐碎的多步骤任务或可能跨会话的工作都应使用 HZL。

输入与输出

见下方输入与输出表格。

风险提示

• hzl init --force：永久删除全部数据，会提示确认
• hzl init --force --yes：无确认直接删除全部数据，极度危险
• hzl task prune ... --yes：永久删除已完成的旧任务及其事件历史
• 以上操作均无撤销功能，无备份则无法恢复
• AI 代理仅在用户明确要求删除数据时才可执行上述命令

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/tmchow/hzl/SKILL.md
来源类型：GitHub 仓库