SuperAPI AI 工具集

complete-task

通用与其它

查看项目

更新于 10-16 05:06

技能介绍

用途:complete-task 用于将某个任务标记为已完成,适合用户希望把任务标记为 done 或 complete 时使用。

主要能力:通过 taskmd CLI 完成状态变更。流程包括:从 $ARGUMENTS 获取任务 ID(如 077);若为空或没有任务 ID,则从对话上下文推断当前正在处理的任务;仍无法确定时询问用户要完成哪个任务。随后运行 taskmd get <ID> 读取任务内容,识别任务正文中的所有子任务清单(- [ ] / - [x])以及验收标准部分,逐项确认工作已完成、验收条件已满足,并把已完成但未勾选的项改为 - [x]。若有未完成项,应报告用户并询问如何处理,不得标记为已完成。

工作日志:仅当 .taskmd.yaml 中显式设置 worklogs: true 时才追加带时间戳的完成摘要,日志文件位于 tasks/<group>/.worklogs/<ID>.md 或 tasks/.worklogs/<ID>.md。

状态设置:查看 .taskmd.yaml 的 workflow 模式。若为 workflow: pr-review,使用 taskmd set $ARGUMENTS --status in-review,该模式下任务通过合并 PR 完成,而非直接设置状态;否则(默认 solo 模式)运行 taskmd set $ARGUMENTS --status completed --verify,--verify 会在应用状态变更前运行任务中定义的验证检查,验证失败需向用户报告。最后向用户确认状态变更。

限制与安全注意:绝不能在 taskmd 写入前 cd。所有 taskmd set … 命令(包括 --verify 和 in-review 分支)都应在当前工作目录运行,不要先 cd /path/to/repo 或进入所谓主工作目录:在 git worktree 中该路径是不同分支的另一份检出,而 shell 中的 taskmd 写入不受 worktree 隔离保护,cd 后会静默改错检出。taskmd 从当前目录解析任务目录,原地运行才能保证写入本 worktree。在多 worktree 仓库中,若任务只存在于同级 worktree,taskmd set 会拒绝写入并提示在对应 worktree 运行;遇到该错误说明处于错误检出,不要用 cd 绕过,应到拥有该任务的 worktree 中运行命令。

适用场景:任务收尾、核对子任务与验收标准、按 solo 或 pr-review 工作流更新任务状态。

暂未提供:具体安装方式、依赖版本、CLI 参数全集及验证检查的配置细节。