Files
harness_coding_docs/docs/06-tasks.md

3.5 KiB
Raw Permalink Blame History

任务路线图(Roadmap)

本文是只读路线图:维护阶段划分、里程碑、待办池和建议拆分清单,把 MVP 拆成小步、可独立交付的任务,让 AI 一步一步开发,避免一次生成整个项目。 真实任务以「一任务一文件」存放在 tasks/(docs/tasks/T-<编号>.md)。未启用 Gitea 时以任务文件 frontmatter 为状态权威;启用后以 Issue 为实时状态、合并后的任务文件为长期事实。本文不跟踪单任务状态。

使用规则

  1. 开工先落文件:从下方「建议拆分清单」把下一个任务按 tasks/README.md 落成 docs/tasks/T-<编号>.md(沿用建议编号),把验收要点展开成可执行、可观察的步骤,再开始实现。
  2. 每个 agent 一次只做一个任务:领取、状态流转、执行记录、完成定义全部遵循 tasks/README.md 和 编码规则;DONE 需要可运行证据,多 agent 只并行写路径互不重叠的任务。
  3. 不跳步:依赖未完成的任务不能开工。
  4. 本文只在规划变化时修改:调整阶段划分、里程碑、增删建议任务或 Backlog 条目时才动本文;单个任务开工或完成不修改本文。
  5. 动手前先读 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】
  • 【优化项】