72 lines
3.7 KiB
Markdown
72 lines
3.7 KiB
Markdown
# 任务看板（Tasks）
|
||
|
||
> 把 MVP 拆成小步、可独立交付的任务，让 AI 一步一步开发，避免一次生成整个项目。
|
||
|
||
## 使用规则
|
||
|
||
1. **一次只做一个任务**：每轮只领取一个状态为 `TODO`、且依赖均已 `DONE` 的任务，取最靠前的那个。
|
||
2. **做完即停**：完成该任务、自测通过、把状态改成 `DONE` 后，停下来汇报。
|
||
3. **不跳步**：依赖未完成的任务不能开工。
|
||
4. **完成定义**：以 [编码规则](05-coding-rules.md) 的验证清单为准。
|
||
5. **passing 需证据**：标记 `DONE` 前，必须在 [`../progress.md`](../progress.md) 记录跑过的验证命令和结果作为证据；只有"代码已写"而没有可运行证据，不得标 `DONE`。验收要点要写成可执行、可观察的步骤，不写"应该能用"这类无法验证的描述。
|
||
6. **动手前**先读 `00-ai-start-here.md`、`05-coding-rules.md` 和 `current-state.md`。
|
||
7. **完成后**把任务状态同步到本文，把执行记录追加到 [`../progress.md`](../progress.md)，覆盖更新 [`current-state.md`](current-state.md)，并过一遍 [`clean-state-checklist.md`](clean-state-checklist.md)。
|
||
|
||
如新项目希望任务看板放在根目录，可把本文复制或改名为根目录 `tasks.md`，并同步更新 `README.md`、`docs/README.md`、`00-ai-start-here.md` 和 `current-state.md` 的链接。
|
||
|
||
## 状态图例
|
||
|
||
`TODO` 待开始 · `DOING` 进行中（同一时间最多 1 个）· `DONE` 已完成并验收 · `BLOCKED` 受阻（注明原因）
|
||
|
||
---
|
||
|
||
## Phase 0 · 地基
|
||
|
||
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|
||
| --- | --- | --- | --- | --- |
|
||
| T-001 | 初始化项目骨架 | - | 依赖安装成功；本地能启动；首页 / 入口可访问；用真实可运行命令替换 `00-ai-start-here.md`、`03-tech-stack.md`、`05-coding-rules.md`、`current-state.md` 中的占位验证命令 | TODO |
|
||
| T-002 | 建立基础目录和配置 | T-001 | 目录结构符合 `04-architecture.md`；配置不含密钥 | TODO |
|
||
| T-003 | 加入最小测试 / 构建检查 | T-001 | 测试命令和构建命令可运行 | TODO |
|
||
|
||
## Phase 1 · 最高风险验证
|
||
|
||
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|
||
| --- | --- | --- | --- | --- |
|
||
| T-101 | 验证最高风险功能原型 | T-001 | 用最小输入跑通核心难点，结论写入文档 | TODO |
|
||
| T-102 | 把原型接入正式结构 | T-101 | 代码进入约定模块，测试覆盖关键路径 | TODO |
|
||
|
||
## Phase 2 · 核心用户流程
|
||
|
||
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|
||
| --- | --- | --- | --- | --- |
|
||
| T-201 | 实现核心页面 / 入口 | T-102 | 用户能进入主流程第一步 | TODO |
|
||
| T-202 | 实现核心动作 | T-201 | 用户能完成 MVP 最关键动作 | TODO |
|
||
| T-203 | 实现结果展示 / 状态反馈 | T-202 | 用户能看到保存、提交或处理结果 | TODO |
|
||
|
||
## Phase 3 · 数据与账号
|
||
|
||
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|
||
| --- | --- | --- | --- | --- |
|
||
| T-301 | 建立数据模型 / 迁移 | T-202 | 表结构符合 `04-architecture.md` | TODO |
|
||
| T-302 | 实现鉴权 / 权限边界 | T-301 | 未授权访问被拒绝；授权后可访问 | TODO |
|
||
| T-303 | 实现数据持久化 | T-302 | 刷新 / 重进后数据仍在 | TODO |
|
||
|
||
## Phase 4 · 收尾与发布
|
||
|
||
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|
||
| --- | --- | --- | --- | --- |
|
||
| T-401 | 完整验收 MVP | T-303 | `02-requirements.md` 的 P0 验收全部通过 | TODO |
|
||
| T-402 | 部署 / 打包 / 运行文档 | T-401 | 新环境可按文档运行 | TODO |
|
||
|
||
## 里程碑
|
||
|
||
- M1：最小可运行地基完成。
|
||
- M2：最高风险功能已验证。
|
||
- M3：MVP 核心闭环完成。
|
||
- M4：可交付 / 可部署。
|
||
|
||
## 待办池（Backlog）
|
||
|
||
- 【V2 功能 1】
|
||
- 【V2 功能 2】
|
||
- 【优化项】 |