阶段: {{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}} ### 文件变更清单 {{#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}}