t-task

任务规划生成

运行时边界统一参考：${CLAUDE_PLUGIN_ROOT}/protocols/runtime-boundaries.md 需求来源边界统一参考：${CLAUDE_PLUGIN_ROOT}/protocols/requirement-source-contract.md 决策连续性和用户决策暴露统一参考：${CLAUDE_PLUGIN_ROOT}/protocols/decision-continuity-contract.md 设计生成状态统一参考：${CLAUDE_PLUGIN_ROOT}/protocols/design-state-contract.md

任务拆分必须服务于边界清楚、验证闭环明确的执行；如果设计文档、guide 或 protocol 冲突，停止并说明冲突。

影响规划方向的缺口必须通过 AskUserQuestion 解决，不得把问题写成 P0/P1、假设或 handoff 后继续生成任务。

Input Contract

上游输入（来自 /t-design 产出）：

• .ai/design/[feature].md — 设计主文档（必须存在）
  • 必须包含：目标、范围、交付端范围、跨端契约摘要、测试与验收汇总、文件影响范围全量汇总
  • 应包含：现有实现分析概览、用户故事/PRD/技术预研引用、Decision Trace
  • 纯技术方案设计可只包含技术预研引用，但必须声明不涉及业务逻辑、产品规则、用户可见流程或验收目标变动
• .ai/design/[feature]/backend.md、.ai/design/[feature]/frontend.md、.ai/design/[feature]/flutter.md — 分端设计文档；主文档 §4.2 标记适用时必须存在，生成对应 phase 时必须读取（API 契约、数据库设计等分端细节以分端文档为准）
• .ai/design/[feature]/.state.json — 设计生成状态；存在时必须为 complete
• .ai/decision-log/[feature].md — 跨阶段决策账本（存在时必须读取；本阶段不得采用 Superseded Decision）

可选输入：

• .ai/task/[feature]/.state.json — 已有任务状态（增量生成时）
• docs/prd/**/*.md — PRD 文档
• .ai/user-stories/**/*.md — draft 用户故事
• docs/user-stories/**/*.md — 已发布用户故事
• .ai/tech-research/**/*.md — 技术预研报告
• ${CLAUDE_PLUGIN_ROOT}/guides/ — 开发规范

Output Contract

下游产出：

• .ai/task/[feature]/.state.json — 任务状态文件，包含 phase/slot/item 层级状态
• .ai/task/[feature]/<phase>/index.md — 阶段总览，包含当前 phase 的 Decision Trace
• .ai/task/[feature]/<phase>/<slot>.md — Slot manifest（导航与执行顺序）
• .ai/task/[feature]/<phase>/<slot>/<ITEM-ID>-*.md — 可执行的 item 文件

状态结构、item 字段、slot 顺序、测试集中执行和 backend/test 特殊字段统一参考：

• ${CLAUDE_PLUGIN_ROOT}/protocols/task-state-contract.md
• ${CLAUDE_PLUGIN_ROOT}/protocols/task-phase-execution.md

Purpose

• 从 .ai/design/[feature].md 生成 .ai/task/[feature]/ 任务目录和 .state.json。
• 固定使用 phase -> slot -> item 模型。
• 生成串行执行的 item 文件，而不是把 manifest 当执行输入。

Args

参数	说明
[feature]	功能名（必填）
--phase <backend|frontend|miniapp|flutter|web-demo|flutter-demo>	指定阶段生成；未指定时默认选择第一个 active phase