用途:该技能用于通过 hirotm 命令行工具操作 Hiro Task Manager,管理任务、任务列表和任务看板。
主要能力:创建、更新、删除任务;创建、更新、删除任务列表;管理看板;列出、搜索和过滤任务、列表与看板;管理 Hiro Task Manager 服务器;删除、清除或恢复任务、列表与看板。
使用方式:所有操作使用 hirotm CLI 命令,可在任意命令或子命令后加 --help 获取帮助,例如 boards --help、boards describe --help。建议在目标工作区根目录运行命令,变更前先检查当前状态。分页读取或搜索时,若只需数量可先用 --count-only。变更类命令使用 --client-name 标识操作者,名称应反映 Agent 名称,如 Cursor Agent、Github Copilot Agent、Claude Code Agent、Open Code Agent,不确定时用 AI Agent。需要纯文本输出时可加 --no-color。
发现与查找:用 boards list 列出所有看板;用 boards describe <id-or-slug> 查看看板详情;用 tasks list --board <board-id-or-slug> 列出并过滤看板中的任务;已知全局 id 时用 tasks show <task-id> 或 lists show <list-id> 查看单条记录。查找已有任务可用 tasks list 配合过滤、tasks show 或 query search。
服务器操作:用 server status 检查状态,server start --background 后台启动,server stop 停止。
限制与安全:tasks purge、lists purge、boards purge 为永久删除且不可恢复,绝不能在无明确用户请求时调用。软删除(tasks delete、lists delete、boards delete)需先向用户展示目标实体并确认意图明确。支持时先运行 --dry-run,用户确认后再用 --yes。误删时优先检查回收站并恢复,而非重建。若因 CLI 访问控制无权限,应说明情况并建议用户授权,不得绕过访问控制。错误处理优先使用机器可读的 stderr 代码,并参考其中的提示。