README.md
6.67 KB
📋 任务管理
此目录包含项目任务管理的相关文档。
📁 目录结构
tasks/
├── ideas/ # 💡 需求收集（零碎、原始）
├── todo/ # 📝 待办任务（整理后、相对完整）
├── plan/ # ⚙️ 技术方案（详细设计）
└── done/ # ✅ 完成总结
🔄 任务生命周期
ideas（零碎需求） → todo（整理后） → plan（技术方案） → done（完成总结）
各阶段说明
| 阶段 | 用途 | 文档特点 | 时机 | 预估时间 |
|---|---|---|---|---|
| ideas/ | 需求收集 | 零碎、随便写、随时记 | 收到需求时 | 5 分钟 |
| todo/ | 待办任务 | 简短、完整、可评估 | 需求整理后 | 15 分钟 |
| plan/ | 技术方案 | 详细、可执行、可评审 | 决定开发时 | 1-2 小时 |
| done/ | 完成总结 | 记录、反思、可复用 | 开发完成后 | 30 分钟 |
📂 各目录说明
💡 ideas/ - 需求收集
用途: 记录原始的、零碎的需求和反馈，在整理成正式需求之前。
适合放这里的内容:
- ✅ 用户反馈的原话（一句话也行）
- ✅ 临时想到的功能点
- ✅ 简短的问题描述
- ✅ 未整理的会议记录
- ✅ 任何不完整的需求
特点:
- 📝 随便写，不需要格式
- 🎯 快速记录，不要过度整理
- 💾 先存下来，避免遗忘
文档格式示例:
## 2026-01-28 用户反馈
- 图片上传失败
- 草稿不能恢复
- 视频卡顿
或者稍详细版:
# 打卡图片上传失败
**时间**: 2026-01-28 14:30
**来源**: 用户微信群 - 张三
**问题**:
上传图片时，转圈30秒，最后提示"上传失败"，图片需要重新选。
**初步想法**:
- 可能是网络问题
- 需要加重试机制
就这么简单！ 不需要模板，想到就写。
何时整理: 当相关需求收集得差不多时，整理成正式的 todo/ 文档。
详细说明: 见 ideas/README.md
📝 todo/ - 待办任务
用途: 存放整理后、相对完整的需求文档，等待排期和开发。
包含内容:
- ✅ 整理后的需求描述
- ✅ 清晰的目标和预期结果
- ✅ 初步技术评估（复杂度、工作量、风险）
- ✅ 优先级标记
- ✅ 相关资源链接
- ❌ 详细技术方案（应在
plan/） - ❌ API 设计（应在
plan/）
文档特点:
- 简洁明了: 3-5 分钟能看完
- 重点突出: 核心需求和目标
- 快速评估: 技术可行性初步判断
- 易于决策: 判断是否要做、何时做
示例:
# 优化打卡上传体验
**优先级**: 🟡中
**来源**: 多个用户反馈
**日期**: 2026-02-03
## 需求描述
综合最近收到的多个用户反馈：
1. 图片上传失败率高
2. 上传慢
3. 失败后需要重新选图
## 期望结果
- 上传成功率 > 95%
- 上传时间 < 5 秒
- 支持失败重传
## 初步评估
- 技术复杂度: 中等
- 预估: 3人天
- 方向: 七牛云 SDK 优化、重试机制
何时移到 plan/:
- ✅ 需求已确认，准备开发
- ✅ 需要详细技术设计
- ✅ 需要排期和资源规划
完整模板: 见 todo/TODO_TEMPLATE.md
⚙️ plan/ - 技术方案
用途: 存放正在进行或计划中的功能的详细技术设计文档。
包含内容:
- 功能需求分析（来自
todo/） - 技术方案设计
- API 接口设计
- 数据库设计（如需要）
- 实现步骤和时间规划
- 测试方案
文档特点:
- 详细设计: 包含技术细节
- 可执行: 开发者能按方案实施
- 可评审: 团队可评审方案的可行性
何时创建:
- 从
todo/移过来时 - 决定要开发，需要详细设计时
✅ done/ - 已完成任务
用途: 存放已完成的功能和任务的实现记录和总结。
包含内容:
- 功能实现总结
- 技术方案记录
- 遇到的问题与解决方案
- 测试结果
- 部署记录
文档特点:
- 回顾价值: 未来可参考
- 经验总结: 记录踩坑经验
- 知识沉淀: 团队知识共享
🔄 工作流示例
场景：收到用户反馈
1️⃣ 零碎反馈阶段
# 直接记录，随便写
vim ideas/feedback_20260128.md
## 2026-01-28 用户反馈
- 图片上传失败
- 草稿不能恢复
时间: 5 分钟
2️⃣ 需求整理阶段
# 一两周后，相关反馈收集得差不多了
# 整理成正式需求
vim todo/20260203_优化打卡上传.md
使用 TODO_TEMPLATE.md 模板，填写：
- 需求描述
- 期望结果
- 初步评估
时间: 15 分钟
3️⃣ 技术设计阶段
# 决定要做这个功能
# 展开为详细技术方案
mv todo/20260203_优化打卡上传.md plan/20260203_优化打卡上传.md
vim plan/20260203_优化打卡上传.md
添加：
- 详细技术方案
- API 设计
- 实现步骤
- 测试方案
时间: 1-2 小时
4️⃣ 开发完成
# 功能开发完成
# 移到 done，写实现总结
mv plan/20260203_优化打卡上传.md done/20260203_优化打卡上传.md
vim done/20260203_优化打卡上传.md
记录：
- 实现过程
- 遇到的问题
- 解决方案
- 测试结果
时间: 30 分钟
💡 核心原则
ideas/ - 快速记录
- ⚡ 不要过度整理: 先记下来，避免遗忘
- 🎯 不要追求完美: 有想法就写
- 📝 不要用模板: 随便写，能看懂就行
todo/ - 简洁完整
- ✅ 需求相对完整: 不是零碎的
- ✅ 可以评估决策: 领导能看懂
- ✅ 不要太详细: 详细设计留给
plan/
plan/ - 详细可执行
- ✅ 技术细节完整: 开发者能照着做
- ✅ 经过评审: 团队达成一致
- ✅ 考虑边界情况: 异常处理、错误流程
done/ - 经验沉淀
- ✅ 记录真实过程: 包括踩坑
- ✅ 有复用价值: 未来可参考
- ✅ 简洁即可: 不需要太详细
📊 任务统计
| 状态 | 数量 | 说明 |
|---|---|---|
| 💡 收集中 (ideas/) | - | 待整理的需求 |
| 📝 待办 (todo/) | - | 等待排期 |
| ⚙️ 进行中 (plan/) | - | 正在开发/计划中 |
| ✅ 已完成 (done/) | - | 已上线 |
🔗 相关资源
最后更新: 2026-01-28