# Task Board Skill - 任务看板技能

用于在开发过程中实时更新任务进度，通过 Web 看板查看当前工作状态。

## 📋 功能

- 🌳 树状结构展示任务层级
- 🎨 不同颜色圆点表示状态（未开始/进行中/已完成/有bug）
- ⏰ 时间跟踪（开始/结束时间）
- 📱 移动端和桌面端自适应
- 🔒 无需登录，无后门

## 🚀 快速使用

### 添加主任务
```bash
curl -X POST http://你的公网IP:3001/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"name":"项目名称"}'
```

### 添加子任务
```bash
curl -X POST http://你的公网IP:3001/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"name":"子任务名称","parentId":"父任务ID"}'
```

### 更新任务状态
```bash
# 开始任务
curl -X PUT http://你的公网IP:3001/api/tasks/任务ID \
  -H "Content-Type: application/json" \
  -d '{"status":"in-progress","startTime":"2026-02-22T09:00:00.000Z"}'

# 完成任务
curl -X PUT http://你的公网IP:3001/api/tasks/任务ID \
  -H "Content-Type: application/json" \
  -d '{"status":"completed","endTime":"2026-02-22T10:00:00.000Z"}'

# 标记有bug
curl -X PUT http://你的公网IP:3001/api/tasks/任务ID \
  -H "Content-Type: application/json" \
  -d '{"status":"bug"}'
```

### 删除任务
```bash
curl -X DELETE http://你的公网IP:3001/api/tasks/任务ID
```

## 📊 状态说明

- ⚪ **pending** - 未开始
- 🟡 **in-progress** - 进行中
- 🟢 **completed** - 已完成
- 🔴 **bug** - 有bug

## 🌐 访问看板

在浏览器中打开：
```
http://你的公网IP:3001
```

## 💡 使用建议

1. **开始工作前** - 创建主任务
2. **拆解任务** - 为主任务添加子任务
3. **开始执行** - 将子任务状态改为 "in-progress"
4. **遇到问题** - 标记为 "bug"
5. **完成任务** - 状态改为 "completed"

## 🔧 配置

### 修改端口
编辑 `task-board/server.js`：
```javascript
const PORT = process.env.PORT || 3001;
```

### 修改访问地址
在调用 API 时替换 `你的公网IP:3001` 为实际地址

## 📝 示例

### 开发一个新项目

```bash
# 1. 创建主任务
curl -X POST http://192.168.1.100:3001/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"name":"开发新功能"}'

# 返回: {"id":"1234567890","name":"开发新功能",...}

# 2. 添加子任务
curl -X POST http://192.168.1.100:3001/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"name":"需求分析","parentId":"1234567890"}'

curl -X POST http://192.168.1.100:3001/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"name":"技术选型","parentId":"1234567890"}'

# 3. 开始工作
curl -X PUT http://192.168.1.100:3001/api/tasks/1234567890 \
  -H "Content-Type: application/json" \
  -d '{"status":"in-progress","startTime":"2026-02-22T09:00:00.000Z"}'

# 4. 完成子任务
curl -X PUT http://192.168.1.100:3001/api/tasks/1234567891 \
  -H "Content-Type: application/json" \
  -d '{"status":"completed","endTime":"2026-02-22T10:00:00.000Z"}'
```

## 📱 移动端访问

在手机浏览器中打开看板地址，可以实时查看进度。

## 🔒 安全提示

- 生产环境建议使用 HTTPS
- 可配置 IP 白名单限制访问
- 定期备份 `tasks.json` 文件
- 不要在日志中输出敏感信息