任务路线图(Roadmap)
本文是只读路线图:维护阶段划分、里程碑、待办池和建议拆分清单,把 MVP 拆成小步、可独立交付的任务,让 AI 一步一步开发,避免一次生成整个项目。
真实任务以「一任务一文件」存放在 tasks/(docs/tasks/T-<编号>.md)。未启用 Gitea 时以任务文件 frontmatter 为状态权威;启用后以 Issue 为实时状态、合并后的任务文件为长期事实。本文不跟踪单任务状态。
使用规则
- 开工先落文件:从下方「建议拆分清单」把下一个任务按
tasks/README.md 落成 docs/tasks/T-<编号>.md(沿用建议编号),把验收要点展开成可执行、可观察的步骤,再开始实现。
- 每个 agent 一次只做一个任务:领取、状态流转、执行记录、完成定义全部遵循
tasks/README.md 和 编码规则;DONE 需要可运行证据,多 agent 只并行写路径互不重叠的任务。
- 不跳步:依赖未完成的任务不能开工。
- 本文只在规划变化时修改:调整阶段划分、里程碑、增删建议任务或 Backlog 条目时才动本文;单个任务开工或完成不修改本文。
- 动手前先读
00-ai-start-here.md、05-coding-rules.md 和 current-state.md。
建议拆分清单
以下是按阶段列出的建议任务;T-编号 为建议编号,落成任务文件时沿用。
Phase 0 · 地基
| ID |
任务 |
依赖 |
验收要点 |
| T-001 |
初始化项目骨架 |
- |
依赖安装成功;本地能启动;首页 / 入口可访问;用真实可运行命令替换 00-ai-start-here.md、03-tech-stack.md、05-coding-rules.md、current-state.md 中的占位验证命令 |
| T-002 |
建立基础目录和配置 |
T-001 |
目录结构符合 04-architecture.md;配置不含密钥 |
| T-003 |
加入最小测试 / 构建检查 |
T-001 |
测试命令和构建命令可运行 |
Phase 1 · 最高风险验证
| ID |
任务 |
依赖 |
验收要点 |
| T-101 |
验证最高风险功能原型 |
T-001 |
用最小输入跑通核心难点,结论写入文档 |
| T-102 |
把原型接入正式结构 |
T-101 |
代码进入约定模块,测试覆盖关键路径 |
Phase 2 · 核心用户流程
| ID |
任务 |
依赖 |
验收要点 |
| T-201 |
实现核心页面 / 入口 |
T-102 |
用户能进入主流程第一步 |
| T-202 |
实现核心动作 |
T-201 |
用户能完成 MVP 最关键动作 |
| T-203 |
实现结果展示 / 状态反馈 |
T-202 |
用户能看到保存、提交或处理结果 |
Phase 3 · 数据与账号
| ID |
任务 |
依赖 |
验收要点 |
| T-301 |
建立数据模型 / 迁移 |
T-202 |
表结构符合 04-architecture.md |
| T-302 |
实现鉴权 / 权限边界 |
T-301 |
未授权访问被拒绝;授权后可访问 |
| T-303 |
实现数据持久化 |
T-302 |
刷新 / 重进后数据仍在 |
Phase 4 · 收尾与发布
| ID |
任务 |
依赖 |
验收要点 |
| T-401 |
完整验收 MVP |
T-303 |
02-requirements.md 的 P0 验收全部通过 |
| T-402 |
部署 / 打包 / 运行文档 |
T-401 |
新环境可按文档运行 |
里程碑
- M1:最小可运行地基完成。
- M2:最高风险功能已验证。
- M3:MVP 核心闭环完成。
- M4:可交付 / 可部署。
待办池(Backlog)
- 【V2 功能 1】
- 【V2 功能 2】
- 【优化项】