MathLab/skills/task-board/SKILL.md

Task Board Skill - 任务看板技能

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

📋 功能

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

🚀 快速使用

添加主任务

curl -X POST http://你的公网IP:3001/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"name":"项目名称"}'

添加子任务

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

更新任务状态

# 开始任务
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"}'

删除任务

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：

const PORT = process.env.PORT || 3001;

修改访问地址

在调用 API 时替换 你的公网IP:3001 为实际地址

📝 示例

开发一个新项目

# 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 文件
• 不要在日志中输出敏感信息