用途:把某个功能的 PRD 和技术规格(tech-spec)拆解成详细的任务清单,属于 spec-driven 工作流的第三步,任务文件随后由 ai-execute-task 读取与执行。
主要能力:从 vault 读取 engineering/<project>/workplans/<feature>/prd.md 与 tech-spec.md,按 references/tasks-template.md 生成 tasks.md 汇总,并按 references/task-template.md 为每个主任务生成 NN-task.md(编号如 01-task.md),细化子任务、成功标准以及单元/集成测试;每个任务须是独立可完成的功能性增量交付物,且带保证功能与业务目标的测试。
使用方式:先解析项目基路径(git rev-parse --show-toplevel,取 basename 作为项目名;非 git 仓库则与用户确认名称),基路径为 engineering/<project>。用户给出 feature 标识则直接使用,否则列出 workplans 目录让用户选择;缺少 PRD 或 tech-spec 时停止并提示先运行 ai-create-prd / ai-create-techspec。生成任何文件前必须先向用户展示高层任务列表并获得批准,随后写入文件并维护 index(feature、project、engineering 根三层,append-if-missing、不重复链接),最后在 vault 根执行提交推送:git -C "$V" add -A && git -C "$V" commit -m "<message>" && git -C "$V" push。
适用场景:已有 PRD 与技术规格,需要拆解为带依赖顺序(后端先于前端,两者先于 E2E)、可并行标记明确的任务清单,供后续执行步骤使用。
限制:本步骤不实现任何代码;输出写入用户 Obsidian vault(默认 $HOME/Documents/obsidian/obsidian,可指定其他绝对路径),不使用 MCP,直接写本地文件;主任务建议不超过 10 个,编号用 X.0 / X.Y;任务文件应指向同目录 PRD 与技术规格而非复述;若暂存区为空、无 origin 或推送失败(离线)需简要报告但不中断技能。