tapd-story-tasks

name	tapd-story-tasks
slug	tapd-story-tasks
version	3.0.0
description	迭代执行流水线任务生成阶段。基于 plan.md / research.md 调用 /speckit.tasks 生成全量任务， 随后调用 /speckit.analyze 验证产物合规。两段命令通过两次 subagent 隔离执行。 命令与报告模板详见 ../references/subagent-prompt-template.md §2.3 + §2.4。

需求实现任务

前置条件

• 当前需求 phase 为 researched
• ${WORKDIR}/plan.md、research.md、data-model.md（如有）已存在
• pipeline 主编排已按 references/context-and-meta-template.md 重写当前阶段的 context.md

输入

• ${WORKDIR}/meta.yaml（读取 attempts）
• 当前需求 ID（由 pipeline 主编排传入）
• ${WORKDIR}/plan.md / research.md / data-model.md
• ${WORKDIR}/context.md
• ${WORKDIR}/iteration-patches/attempt-${N}.md（若为回退重入，必读）

执行流程

本阶段由 pipeline 主编排先后渲染两份 SUBAGENT_PROMPT，分别拉起两个 subagent：

1. 第一段：按 ../references/subagent-prompt-template.md §2.3 Tasks-Generate 模板 渲染，调用 speckit-tasks 生成 tasks.md。
2. 第二段：按 §2.4 Tasks-Analyze 模板渲染，调用 speckit-analyze 验证产物合规 并产出 tasks-report.md。

拆成两段的理由：speckit-analyze 是独立skill，需要在 tasks.md 落盘后重新拉起 agent 进程。

渲染填充：${ID} / ${VERSION} / ${WORK_DIR} / attempts / round； 若 attempts > 1，附上 iteration-patches/attempt-${attempts}.md 摘要。

两段的 shell 命令、tasks-report.md 统一模板、Verdict 判定规则（四态归因） 均在 subagent-prompt-template.md §2.3 + §2.4 中定义，本子 skill 不重复。

消费 subagent 回传 JSON

第一段失败（status=fail）按 references/error-handling.md 处理，通常升级为回退重入。

第一段成功后进入第二段。按第二段 compliance.verdict 分支：

Verdict	主会话动作
pass	进入"更新状态"推进 phase
needs_fix	同 attempt 内 round +1，重新跑第一段 + 第二段（最多 3 个 round）
plan_insufficient	整理 findings 为 attempt-${N+1}.md，target_phase_to_re_enter=plan，走回退重入
spec_insufficient	同上，target_phase_to_re_enter=specify

更新状态

compliance.verdict=pass 时：

• 更新 meta.yaml.phase 为 tasks-generated
• meta.yaml.history 追加成功记录，清空 meta.yaml.last_failure

可重入约定

通用规则见 ../references/shared-reentry-conventions.md。本阶段差异：

• round 重试触发条件：compliance.verdict=needs_fix，同 attempt 内最多 3 个 round
• 两段 subagent 均追加重入增量段（subagent-prompt-template.md §2.3 + §2.4）
• 报告文件不做快照：tasks-report.md 每轮覆盖重写，历史可经 process.log 回溯

幂等性、产物保留、process.log 仅追加等通用约束见 ../references/reentry-protocol.md。

信息不足回退（回退重入入口）

verdict=plan_insufficient 或 spec_insufficient 时，attempt-${N+1}.md 必须明确：

• failed_phase: tasks
• root_cause：可直接复用 tasks-report.md 中对应 Finding 的根因字段
• target_phase_to_re_enter: plan 或 specify（按归因最深处确定）

参考资料

• SUBAGENT_PROMPT（tasks-generate + tasks-analyze 模板 + 报告模板）：../references/subagent-prompt-template.md §2.3 + §2.4
• 通用回传 JSON Schema：../references/subagent-prompt-template.md §1.3
• 上下文与元数据模板：../references/context-and-meta-template.md
• 可重入协议：../references/reentry-protocol.md
• 错误处理：../references/error-handling.md

产出

• ${WORKDIR}/tasks.md — 全量任务清单
• ${WORKDIR}/tasks-report.md — speckit-analyze 合规报告
• ${WORKDIR}/process.log — stream-json 流式日志（追加，含两段 banner）
• ${WORKDIR}/meta.yaml — 更新后的 attempts / round / history
• 需求 phase 为 tasks-generated