hiro-task-manager-cli

Hiro Task Manager CLI

当用户希望通过 hirotm CLI 使用 Hiro Task Manager 管理任务、任务列表和任务看板时，请使用此技能。

适用场景

• 创建、更新和删除任务。
• 创建、更新和删除任务列表。
• 管理看板。
• 列出、搜索和筛选任务、列表和看板。
• 管理 Hiro Task Manager 服务，以便操作任务、列表和看板。
• 删除、彻底清除或恢复任务、列表和看板（参见破坏性操作）。

破坏性操作

以下命令具有破坏性，当前轮次中若用户没有明确、无歧义地提出请求，绝对不得调用：

• tasks purge、lists purge、boards purge — 永久删除，无法恢复。

只有在满足以下条件后，才允许软删除（tasks delete、lists delete、boards delete）：

1. Agent 已向用户展示目标实体（通过 show、describe 或 list），并确认目标无误。
2. 用户明确、无歧义地表示要删除该特定实体。

如果实体被误删，始终优先检查回收站并使用 restore，而不是重新创建该实体。

对于任何支持此选项的破坏性命令，先使用 --dry-run 运行；只有在用户确认后，才使用 --yes 再次运行。

默认操作工作流

1. 导航到目标工作区根目录。
2. 首先确认 Hiro Task Manager 服务正在运行。
3. 查找需要操作的看板、列表或任务。
4. 使用搜索或列表／筛选功能，缩小范围并确定目标实体。
5. 使用（身份标识）在所有命令中标明自己的身份。
6. 使用所有可用数据，执行风险最小的变更。
7. 变更后展示结果状态。

核心规则

• 所有操作都使用 hirotm CLI 命令。
• 使用 --help 获取任何命令或子命令的帮助，例如 boards --help、boards describe --help。
• 需要示例或文档链接时，优先查看 hirotm --help 和子命令帮助。
• 从目标工作区根目录运行命令。
• 变更前检查当前状态。
• 对分页读取或搜索，如果只需要先获取数量，优先使用 --count-only。
• 对会修改数据的命令使用 --client-name，以便追踪变更来源。
• 将删除、彻底清除和结构变更视为敏感操作。
• 删除、彻底清除和看板结构变更，优先先使用 --dry-run；准备就绪后，才使用 --yes 再次运行。
• 单次运行中，如果纯文本输出更便于检查，请使用 --no-color。

身份标识

在所有命令中使用 --client-name <your-name> 标明自己的身份。名称应体现 Agent 名称，例如：Cursor Agent、Github Copilot Agent、Claude Code Agent、Open Code Agent。 如果不确定，请使用通用名称“AI Agent”。

发现

• 使用 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 查找任务。
• 如果方便，可以使用 limit、offset、fields 或 quiet 选项来调整输出内容和格式。
• 添加任务时：
  • 使用优先级、任务组、版本等任何可用信息。
  • 设置合适的标题（最多 80 个字符），并且仅在适用时添加 Emoji。
  • 如果任务正文较详细，使用结构清晰的 Markdown 描述。
  • 如果任务包含设计图，或用户提出要求，请使用 mermaid 图表。
  • 如果要链接到工作区中的较长文档，请确保使用从工作区根目录开始的正确链接。

访问权限

如果因 CLI 访问控制而无法访问某个实体或执行某项操作，请说明情况，并建议用户授予你所需的权限。切勿尝试绕过 CLI 访问控制。

错误

• 优先使用机器可读的 stderr code，而不是解析 error 文本。
• 如果 stderr 包含 hint，请将其作为下一步恢复操作。
• HTTP/API 故障通常比本地参数验证故障提供更有用的 hint 指引。

服务操作

• 使用 server status 检查服务状态
• 使用 server start --background 启动服务
• 使用 server stop 停止服务

参考资料

• 服务命令 - 启动、停止和检查服务状态。
• 看板命令 - 创建、更新、删除、列出、描述和配置看板。
• 列表命令 - 列出、显示、添加、更新、移动、删除、恢复和清除看板列表。
• 任务命令 - 列出、显示、添加、更新、移动、删除、恢复和清除任务。
• 版本命令 - 列出、显示、添加、更新、删除和设置默认版本。
• 回收站命令 - 检查已移至回收站的看板、列表和任务。
• 状态命令 - 列出工作流状态及其含义。
• 搜索命令 - 使用 query search 全文搜索任务。
• CLI 访问策略 - 将命令映射到 cliPolicy 要求以及读取／写入权限。
• 错误和退出码 - 退出码、stderr 字段和常见机器可读代码。

安全注意事项

• 优先采用先检查再操作的工作流。
• 如果可能存在重复内容，请先搜索再创建。
• 只能通过 hirotm CLI 操作，不得以任何其他方式绕过 CLI。
• 遇到权限和策略错误时，应遵守限制，不要以不安全的方式绕过。
• 对于破坏性命令，请参阅破坏性操作。

参考资料

• 在线文档