用途:add-task 技能用于按照 taskmd 规范创建新的任务文件,适用场景是用户希望向项目添加新任务时。它会解析用户输入中的任务标题(必填)、可选模板名(如 bug、feature、chore 或自定义模板),以及可选参数 --priority、--effort、--tags、--group、--depends-on、--parent、--owner、--slug、--phase,再调用 taskmd add 命令生成任务文件。
主要能力与用法:可按任务领域选择 --group,可选值为 cli(CLI 命令、Go 后端、终端功能)与 web(Web 前端、UI、React 组件);跨领域、基础设施、文档或不确定领域时省略 --group。基本用法示例:taskmd add "Fix the login bug" --group cli;带模板:taskmd add "Login fails on Safari" --template bug --group cli;带额外参数:taskmd add "Dark mode support" --template feature --priority high --tags ui,frontend --group web;自定义 slug:taskmd add "Fix the login bug" --slug fix-login --group cli;带阶段:taskmd add "Add phase filtering" --phase core-cli --group cli。模板可用 taskmd templates list 列出,内置模板包括 bug、feature、chore,项目也可在 .taskmd/templates/ 中定义自定义模板。涉及阶段、里程碑或冲刺时,需检查 .taskmd.yaml 中配置的阶段并使用匹配的阶段 id;若阶段不存在,应先在 .taskmd.yaml 中添加,阶段需包含 id、name,可选 description 与 due。
创建后需读取生成文件,将占位内容(HTML 注释、TODO、1. ... 等)替换为根据用户描述生成的真实内容,填写 Objective、Tasks、Acceptance Criteria 及模板特有的部分,避免保留占位符。最后运行 taskmd validate 校验任务文件,验证失败则修复问题,并向用户确认创建的文件路径与 ID。
限制:必须依赖 taskmd CLI 与 taskmd 规范;--phase 的值必须匹配 .taskmd.yaml 中已配置的阶段 id,否则需先添加阶段。其他细节暂未提供。