t-run

任务执行

运行时边界统一参考：${CLAUDE_PLUGIN_ROOT}/protocols/runtime-boundaries.md

执行时以当前 item 的成功标准和最小必要验证为目标；遇到冲突、缺失上下文或无法判断的语义问题时停止并说明。

前置条件

• .ai/task/[feature]/.state.json 必须存在且可解析；目标阶段必须是 supported phase 且存在于当前任务 active phases（未启用 miniapp/Flutter 的项目不得执行对应 phase），并已规划（phases[phase]、tasks[phase] 和对应阶段目录存在）。
• 当前阶段目录必须包含：index.md、对应 slot manifest（backend/frontend/miniapp/flutter 为 dev.md, test.md, accept.md；web-demo/flutter-demo 为 dev.md, accept.md）、对应 item 目录和 item 文件。

共享契约

执行单元、slot 顺序、item 选择（含启动归一化）、agent 最小上下文、backend/test 特殊规则和失败处理统一参考：

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

参数

参数	说明
[feature]	功能名
--phase <backend|frontend|miniapp|flutter|web-demo|flutter-demo>	仅执行指定阶段；未指定时执行 .state.json 的当前阶段

Input Contract

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

• .ai/task/[feature]/.state.json — 任务状态文件（必须存在且可解析）
• .ai/task/[feature]/<phase>/index.md — 阶段总览
• .ai/task/[feature]/<phase>/<slot>.md — Slot manifest（slot 内 item 执行顺序的真源）
• .ai/task/[feature]/<phase>/<slot>/<ITEM-ID>-*.md — Item 文件（Goal / Work / Files / Validation / Handoff 五章节，即执行依据）

index.md 和 slot manifest 不作为直接执行单元。backend 的 OpenAPI 导出与前端 API 生成验收由 backend-accept 负责。

执行循环

1. 读取状态并确定执行范围，按共享契约校验状态与执行顺序。

2. 完成校验后、启动任何 agent 前，将目标 phase 中全部 generated item 归一化为 pending，重新聚合对应 slot/phase 并一次性写回 .state.json（保留其他状态不变）；归一化写回失败时按状态写入失败处理，不得启动 agent。

3. 按共享契约选择第一个 pending 或 failed item，通过 Agent tool 启动 subagent_type 为 item agent 字段值的 sub agent（调度规则见 ${CLAUDE_PLUGIN_ROOT}/protocols/subagent-dispatch.md，最小上下文按 task-phase-execution 的 Agent Context）。

   最小上下文示例：

   # 调用 backend-dev item 时的最小上下文
   feature: sample-feature
   phase: backend
   slot: dev
   item_id: BE-D02
   agent: backend-dev
   agent_spec: ${CLAUDE_PLUGIN_ROOT}/agents/backend-dev.md
   item_file: .ai/task/sample-feature/backend/dev/BE-D02-domain-models.md
   slot_manifest: .ai/task/sample-feature/backend/dev.md
   phase_index: .ai/task/sample-feature/backend/index.md
   previous_items:
     BE-D01: completed, file=.ai/task/sample-feature/backend/dev/BE-D01-domain-models.md, handoff=<必要片段>