用途:向 backlog 注册新任务或想法,也可在开发中新增需求,或在已有父任务下创建子任务。
主要能力:一次性收集标题(必填)、正文、标签、优先级(critical/high/medium/low,默认 medium)、父任务 ID、分支。标签取自规范列表:bug、security、improvement、test、performance、refactor、docs。
使用方式:单行正文可直接作参数执行 agkan task add "<title>" "<body>" --priority <value>;多行正文必须先用 Write 工具写入临时文件,再用 --file 传入,例如 agkan task add "<title>" --file /tmp/task_body.md,之后删除临时文件;禁止使用 $'...' 或 \n 传递多行内容。提供 Branch 时加上 --branch <name>,留空则省略,由 agkan-subtask 或 agkan-subtask-direct 在实现阶段自动生成。创建后记下返回的任务 ID;依次用 agkan tag attach <task-id> <tag-name> 挂标签、agkan task update-parent <task-id> <parent-id> 设父任务、agkan task block add <blocker-id> <task-id> 设阻塞依赖(blocker-id 为需先完成的任务)。最后用 agkan task get <task-id> 取回并汇总展示 ID、标题、状态、标签、优先级、父任务。
适用场景:新任务登记、开发中涌现的需求、子任务创建。
限制:任务默认始终为 backlog 状态,不移动到 ready(由 agkan-planning 处理);设置父任务前需确认其存在;标签不确定时应询问用户而非猜测。资料未提供安装方式与更多限制。