名称： cognary-tasks
描述： 通过 cognary-cli 管理任务列表。支持列出、添加、更新、完成、取消完成和删除任务。当用户提及任务、待办事项、任务列表、提醒类任务或行动项跟踪时触发。

Cognary 任务管理

通过 cognary-cli tasks 管理任务。请始终使用 --json 参数以获取可解析的输出。

安装

如果尚未安装 cognary-cli，请先安装：

npm install -g cognary-cli

认证

必须设置 COGNARY_API_KEY 环境变量。如果调用因认证失败而报错，请告知用户：

• 若没有账户或 API 密钥，可前往 https://tasks.cognary.ai 注册
• 登录应用后，进入 设置 菜单，选择 "管理 API 密钥" 以创建新密钥
• 随后提供该密钥以便进行配置

命令

列出任务

cognary-cli tasks list [--status active|completed|all] [--category <cat>] [--priority High|Medium|Low] [--search <query>] [--sort createdAt|updatedAt|dueDate|priority|title] [--order asc|desc] [--limit <n>] [--page <n>] [--active-only] [--completed-limit <n>] --json

默认：列出所有任务，按创建时间降序排序，限制 20 条。

添加任务

cognary-cli tasks add "<title>" [--notes "<notes>"] [--category "<cat>"] [--priority High|Medium|Low] [--due-date "<date>"] --json

获取任务

cognary-cli tasks get <id> --json

更新任务

cognary-cli tasks update <id> [--title "<title>"] [--notes "<notes>"] [--category "<cat>"] [--priority High|Medium|Low] [--due-date "<date>"] --json

完成任务

cognary-cli tasks complete <id> --json

取消完成任务（重新激活）

cognary-cli tasks uncomplete <id> --json

删除任务

cognary-cli tasks delete <id> --json

输出格式

• 列出任务时，以清晰易读的格式呈现（而非原始 JSON）。
• 显示：标题、状态、优先级、分类、截止日期（若设置）和 ID。
• 显示全部任务时，将进行中和已完成的任务分组展示。
• 使用表情符号表示优先级：🔴 高、🟡 中、🟢 低。
• 确认操作（如添加/完成/删除）时，请保持简洁。