用途:把一条新任务加入 mdtodo 任务列表。智能体需先弄清两件事:任务内容是什么、期望结果是什么;若用户描述含糊,应先询问而不得臆测。随后拟定内容:TITLE 为单行简洁任务名;DESCRIPTION 为预期结果与关键细节,可选,可多行;VERSION 为 vX.Y.Z 格式的版本标签,可选,仅在用户明确指定时使用。
用法:运行以下脚本,返回 JSON(status、title、version、mdtodo_file、has_description):
.agents/skills/pflow-task-add/scripts/task-add-run.sh --title "TITLE" [--description "DESCRIPTION"] [--version "VERSION"]
若脚本失败(非零退出,或 JSON 中出现 "status":"error"),应打印 ⚠️ <error.message> 并停止。成功后回复:✅ Task added: <title> 与 File: <mdtodo_file>。
限制与注意:若任务文件不存在,脚本会先创建空文件再添加任务;--description 会在 markdown 文件中以缩进行插入到任务下方,可通过 mdtodo list 查看。资料未提供版本格式以外的校验规则、权限要求或平台限制。