# 获取当前时间
date +"%H:%M:%S"

# 获取时间戳（秒）
date +%s

# 计算剩余时间（示例：deadline - now）
echo $((deadline_ts - $(date +%s)))

**强制规则**：
- ❌ 禁止凭空说"大概过了 10 分钟"
- ✅ 必须用 `date` 命令获取当前时间
- ✅ 每次报告进度时必须附带当前时间和剩余时间

---

### 1. 任务启动时必须定义

```markdown
## 时间盒定义

| 要素 | 内容 |
|------|------|
| **任务目标** | [一句话描述要做什么] |
| **时间盒长度** | 10min / 20min / 30min（默认 10min） |
| **结束时间** | HH:MM（绝对时间） |
| **MVU 定义** | [什么是可演示的最小功能] |
| **MVU 完成标准** | [怎样算 MVU 完成] |

P0 - MVU 核心（必须完成）
├── 没有它功能无法运行
├── 没有它用户无法理解
└── 占时间盒 60-70% 时间

P1 - MVU 增强（时间允许再做）
├── 让功能更好用
├── 让界面更美观
└── 占时间盒 20-30% 时间

P2 - 锦上添花（有剩余时间）
├── 动效优化
├── 边界 case 处理
└── 占时间盒 0-10% 时间

遇到问题/卡点
    │
    ├── 影响 MVU 核心功能吗？
    │   │
    │   ├── 是 → 有现成方案吗？
    │   │   │
    │   │   ├── 有 → 立即应用 (限时 3min)
    │   │   └── 没有 → 用 Workaround 绕过 (限时 5min)
    │   │           │
    │   │           └── 还是搞不定？→ 降级 MVU 范围
    │   │
    │   └── 否 → 标记 TODO，继续
    │
    └── 时间剩余多少？
        │
        ├── >50% → 可以继续打磨
        ├── 20-50% → 收缩范围，保 MVU
        └── <20% → 停止新功能，收尾交付

{
  "box_id": "tb-20260318-001",
  "task": "用户登录功能",
  "started": "2026-03-18T10:00:00+08:00",
  "deadline": "2026-03-18T10:30:00+08:00",
  "duration_minutes": 30,

  "mvu": {
    "definition": "用户输入账号密码能登录成功，错误有基本提示",
    "completion_criteria": [
      "登录表单能提交",
      "正确密码能跳转",
      "错误密码有提示"
    ]
  },

  "priority_layers": {
    "P0": [
      {"item": "登录表单 UI", "status": "done", "time_spent": 8},
      {"item": "API 调用逻辑", "status": "done", "time_spent": 10},
      {"item": "错误处理", "status": "in_progress", "time_spent": 5}
    ],
    "P1": [
      {"item": "表单验证", "status": "pending"},
      {"item": "记住我功能", "status": "pending"}
    ],
    "P2": [
      {"item": "动效优化", "status": "pending"},
      {"item": "UI 美化", "status": "pending"}
    ]
  },

  "time_checkpoints": [
    {"elapsed": 10, "mvu_progress": 40, "note": "表单完成", "clock": "10:10:23"},
    {"elapsed": 20, "mvu_progress": 75, "note": "API 调通", "clock": "10:20:15"}
  ],

  "clock": {
    "start_ts": 1710732600,
    "deadline_ts": 1710734400,
    "last_check": "10:20:15",
    "remaining_minutes": 10
  },

  "todos": [
    {"desc": "密码强度验证", "reason": "不影响核心登录"},
    {"desc": "第三方登录", "reason": "MVU 不需要"}
  ],

  "status": "in_progress"
}

用户说"开始时间盒"或类似触发词
    ↓
1. 确认任务目标
2. 确认时间盒长度（默认 30min）
3. 执行 `date` 命令：
   - 记录开始时间：start_time=$(date +"%H:%M:%S")
   - 计算 deadline：deadline_ts=$(date -d "+30 minutes" +%s)
4. 定义 MVU 和完成标准
5. 创建 .agent/time-box.json
6. 报告："时间盒启动，当前时间 HH:MM，结束时间 HH:MM"

每 10 分钟或完成一个 P0 项后：
    ↓
1. 执行 date +"%H:%M:%S" 获取当前时间
2. 计算剩余时间：deadline - now
3. 更新 time-box.json
4. 报告：当前时间 / 已用时间 / MVU 完成度% / 剩余 P0 项
5. 判断：按当前速度能按时完成 MVU 吗？
    │
    ├── 能 → 继续
    └── 不能 → 收缩范围，砍掉低优先 P0 项

# 快速检查时间（每次工具调用前执行）
now=$(date +%s); deadline=1710734400; echo "当前：$(date +%H:%M), 剩余：$(( (deadline-now)/60 )) 分钟"

时间盒到期（提前 5 分钟提醒）：
    ↓
1. 执行 `date` 命令确认时间
2. 停止新功能开发
3. 确保 MVU 能跑起来
4. 清理临时代码
5. 输出交付报告
6. 记录 TODO 清单（给下个时间盒）
7. 执行 `date` 命令记录结束时间

# 检查是否剩余<5 分钟
now=$(date +%s)
if [ $((deadline_ts - now)) -lt 300 ]; then
  echo "⚠️ 剩余时间 <5 分钟，停止新功能，准备收尾"
fi

## 时间盒交付报告

**任务**: [任务名称]
**时间盒**: XX 分钟 (HH:MM - HH:MM)
**实际使用**: XX 分钟

### MVU 完成度

| P0 项 | 状态 | 说明 |
|-------|------|------|
| 项 1 | ✅ | |
| 项 2 | ✅ | |
| 项 3 | ⚠️ 部分 | 降级方案：xxx |

### P1/P2 完成情况
- P1 完成：X/Y 项
- P2 完成：0/0 项（正常，时间不够）

### 遗留 TODO
| 内容 | 优先级 | 建议放入下个时间盒 |
|------|--------|-------------------|
| xxx | 高 | 是 |
| yyy | 中 | 看时间 |

### 时间分配分析
- MVU 核心：XX%（目标 60-70%）
- 增强功能：XX%（目标 20-30%）
- 调试/卡点：XX%（目标<10%）

### 下一步建议
[给下个时间盒的建议]

# 完整检查（推荐）
now=$(date +%s); clock=$(date +"%H:%M:%S"); remaining=$(( (deadline_ts - now) / 60 ))
echo "当前时间：$clock, 剩余：$remaining 分钟"

# 简单检查
date +"当前时间：%H:%M:%S"

# 剩余时间百分比
now=$(date +%s); elapsed=$(( now - start_ts )); total=$(( deadline_ts - start_ts ))
echo "时间进度：$(( elapsed * 100 / total ))% 已用"

用户：用 10 分钟做个登录功能

## Claude 响应：

### 时间盒定义
- 任务：用户登录功能
- 时间盒：10 分钟 (10:00-10:10)
- MVU：用户输入账号密码能登录，错误有基本提示

### P0 优先级（必须完成）
1. 登录表单 UI（3min）
2. API 调用逻辑（4min）
3. 错误提示（2min）
4. 登录成功跳转（1min）

### P1（时间允许再做）
- 表单验证
- 记住我

### P2（不做）
- 动效
- UI 美化

---

[启动] 时间盒开始，当前时间 10:00:00，结束时间 10:10:00

[10:03] 进度报告：已用 3min, 剩余 7min, MVU 30%, 表单完成
[10:06] 进度报告：已用 6min, 剩余 4min, MVU 70%, API 调通
[10:08] 提醒：剩余 2 分钟，停止新功能，收尾
[10:10] 交付报告：MVU 完成

---

## 交付报告
**MVU 完成度**: 100%
**P1 完成**: 0/2 项（正常，时间不够）
**实际用时**: 10 分钟 (10:00-10:10)
**遗留 TODO**: 表单验证、记住我、UI 美化