阶段: {{phase}}

---

规格 + 计划：{{id}} — {{title}}

日期：{{date}}

---

规格

（phase=backend 填写）后端规格

---

req_id: {{req_id}} date: {{date}}

module: {{module}}

目标

{{goal}}

输入 / 触发

{{input}}

输出 / 结果

{{output}}

业务规则

{{rules}}

边界与约束

{{constraints}}

依赖的 schema 表 / 字段

{{schema_refs}}

依赖的接口

{{api_refs}}

验收标准

{{acceptance}}

---

（phase=frontend 填写）前端规格

关联 REQ：{{associated_reqs}} 关联原型：{{associated_prototypes}}

功能概述

{{feature_overview}}

组件树

{{component_tree}}

页面状态机

#	状态	触发条件	视觉表现	用户可执行操作

{{state_machine_rows}}

至少包含：loading / empty / error / 正常 / 提交中 五态。

消费的后端端点

#	方法	路径	触发时机	关联 REQ

{{endpoint_rows}}

业务规则前端复刻清单

#	规则描述	触发时机	报错文案	来源 REQ

{{validation_rows}}

要求：每条规则必须在前端 form-level 校验中复刻，不仅依赖后端报错。文案与后端语义一致。

Design Tokens 引用清单

{{token_list}}

交互流程关键路径

{{interaction_flow}}

备注与开放问题

{{open_questions}}

---

任务级计划

Execution: Parent skill feature-tdd executes this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: {{plan_goal}}

Architecture: {{plan_architecture}}

Tech Stack: {{plan_tech_stack}}

---

Schema 改动

{{schema_change_decision}} <!-- "无" 或 "需要 migration：V__.sql，作用：<一行描述>" — 仅 phase=backend 适用 -->

文件变更清单

{{#each files}}

• {{path}} — {{action}}（{{rationale}}） {{/each}}

任务步骤

{{#each tasks}}

Task {{index}}: {{title}}

Files: {{task_files}}

API shape / Props shape（只写需要约束实现的签名）: {{api_shape}}

• Step 1: 写失败测试

  • 测试名: {{test_file}}::{{test_name}}
  • 意图: {{test_intent}}
  • 子会话确认 FAIL

• Step 2: 实现最小代码

  • 目标: 让 Step 1 测试通过；不多做
  • 涉及文件: {{impl_file}}

• Step 3: 子会话验证 PASS

• Step 4: Commit

  • git add <文件>
  • git commit -m "{{commit_message}}" {{/each}}

提交计划

{{#each commits}}

• {{message}}（覆盖 Task {{task_index}}） {{/each}}