# 时间盒子创建流程

## 目标

将用户当前要做的任务拆成可执行的专注时段，并明确每个盒子的交付成果。

时间盒的落地方式是：把每个盒子创建成一条真实的滴答任务，并写入对应时间与提醒。

## 流程

### Step 1: 了解任务

先根据现有描述给一个可执行的时间盒初稿；只有在缺口会明显影响排程时，才补 1 个关键问题。

优先补充这两类信息：

1. 任务到底要产出什么
2. 预计总时长或期望完成时间

不要把时长确认做成固定选项问卷。

### Step 2: 推荐工作法

调用 `recommend_work_method()` 后，给出：

- 推荐的工作法
- 为什么推荐
- 另外 1-2 个可替代方案

先给推荐结论和理由，用户需要时再展开替代方案。

### Step 3: 生成时间盒安排

调用 `calculate_timeboxes()`，展示：

- 盒子编号
- 开始和结束时间
- 每个盒子的成果定义

格式示例：

```text
📦 盒子 1 | 09:00-09:30 | 成果：完成框架和第一部分 ✓
   └─ 📦 盒子 1: 写项目报告
```

### Step 4: 请求确认

如果用户还在讨论方案阶段，再告诉他可调整这些维度：

- 改开始时间
- 改单个盒子时长
- 删减盒子数量
- 更换工作法

如果用户已经明确说“帮我安排 / 直接创建 / 就这么做”，不要再走一轮冗长确认，直接创建并回报。

### Step 5: 创建并设置检查点

用户确认后：

1. 为每个盒子创建滴答清单任务，优先用 `create_task`；一次要落多个盒子时可用 `batch_add_tasks`
2. 在标题或描述里保留盒子编号与成果定义
3. 把盒子的日期 / 截止时间写进任务字段
4. 如果用户要求开始提醒、提前提醒或检查点提醒，用任务提醒字段一起写入
5. 如果设置优先级，按滴答规则使用：`!1` 低、`!2` 中、`!3` 高
6. 加标签 `#时间盒子`

不要把“时间盒”只停留在文本计划里；一旦用户确认，就要真的落成任务。

### Step 6: 创建后回读校验

创建完成后，必须重新读取刚创建的任务并校验：

- 优先用 `get_task_by_id`

- 优先级是否符合预期
- 截止时间是否正确
- 提醒是否真的早于截止时间
- 如果用户指定了开始提醒或检查点提醒，提醒是否真的存在
- 如果回读里只有任务本身，没有提醒字段落盘，就不能说“时间盒已经带提醒创建好了”

如果用户要求“15:00 截止，14:30 提醒”，但回读后发现提醒仍是 `15:00`，说明只是设置了截止时间，没有单独设置提醒，不能向用户汇报“已设置提前提醒”。

完成后说明下一次检查点是什么时候触发。

默认输出顺序：

1. 先用自然语言说明整体安排是否合理
2. 再给短时间表
3. 如果用户已明确要求落地，直接创建并回报；如果还在讨论，再让用户微调