taskery

Taskery Full Operator 技能提供了一套结构化的指令集，旨在赋予 AI 编程代理管理 Taskery 环境中任务的能力。Taskery 是一个优先考虑本地运行的看板系统，它将基于 Web 的看板与 CLI 和 API 接口进行同步，使其成为开发者使用 AI 代理自动化项目工作流程的理想工具。通过使用此技能，代理程序可以学习如何通过本地终端指令或 RESTful API 端点与 Taskery SQLite 数据库进行交互，同时遵守防止数据冲突所需的乐观并发模型。

此技能适用于需要在本地开发环境中运行的 AI 代理，这些代理需要从代码生成转换为项目管理任务，例如创建跟踪票据、在状态栏中移动任务或标记依赖关系。它涵盖了任务管理的全生命周期，从最初的创建到最终的删除，确保代理程序能够有效地与使用相同看板的人类团队成员进行协作。

• 全生命周期管理：创建、检查、更新、移动、审核、完成及删除任务。

• CLI 精通：深度整合 list、show、create、update 和 move 等指令，并包含状态、优先级和负责人的筛选器使用方法。

• API 能力：与 REST 端点交互，包括任务管理、系统健康检查和全局通知设置。

• 乐观并发控制：通过 expectedVersion 严格遵守版本控制要求，防止多个代理或用户同时更新时出现数据竞争。

• 工作流程自动化：指导代理程序如何使用退出码（0–4）进行稳健的错误处理，并在发生版本冲突时执行自动重试。

• 环境通用性：支持默认本地运行模式及自定义 API 基本 URL 设置，部署灵活。

• 在执行修改操作前，务必先执行 'show <id>' 以获取当前的任务版本。

• 使用 CLI 的 JSON 输出格式，以确保在任务解析过程中的机器可读性。

• 状态包含 PENDING、STARTED、BLOCKED、REVIEW 和 COMPLETE。

• 优先级从 LOW 到 URGENT，有助于进行有效的积压任务分类。

• 若遇到 VERSION_CONFLICT（退出码 4），请仅重试一次。

• 每次写入操作后，请通过调用 list 指令验证状态，以确保看板数据的一致性。