SuperAPI AI 工具集

mdtask-add

通用与其它

查看项目

更新于 10-16 06:41

技能介绍

用途:把用户提出的功能、缺陷或想法转成可跟踪的 Markdown 任务,写入项目已有的 spec 文件或新建 spec。适合“add a task”“create a task”“new task”以及描述某个待跟踪事项的请求。

主要流程:先听取用户描述;信息不足时提出问题澄清(归属 CLI/任务/新领域、预期结果、依赖、优先级、缺陷还是功能),不靠假设推进;再决定任务属于已有 spec 还是需要新建 spec。新建时,按项目配置的 spec 目录(.mdtaskrc 路径或现有 spec 所在位置)提出新 spec 与短的 ID 前缀 <NAME>(大写),并与用户确认;创建前需确认文件不存在、前缀未被占用。

提交与保存:任务先不带 ID 撰写,由 mdtask ids 在保存后分配。头部形式包括无 ID、种子前缀(仅用于全新 spec 文件)、完整 ID(仅在有理由时手写)。提案会展示将保存的内容并询问“Save?”,批量任务在同一文件下列出全部任务,得到明确同意后才执行保存。已有 spec 用 mdtask ids --path <file>(文件无前缀来源时加 --prefix <PREFIX>);新建 spec 则先建文件与 # Tasks 段,再用 mdtask ids --path <file> --prefix <PREFIX>,随后显示分配到的 ID 与位置,并按项目习惯询问是否提交。

元数据:#tag 表示类别,!priority 谨慎使用,未标即 medium;@blocked_by:XXX-NNN 表示依赖,@status:in-progress 表示已开始,@iter:mvp 表示迭代。任务格式需加载 mdtask 技能,以其为唯一来源。

限制:不编造元数据;不跳过确认直接保存;前缀与文件冲突需先核对。