docs-08-initial-template.md
3.92 KB
08-工作流进度
全流程进度跟踪。CC 每完成一项产出就勾选一项。
- § 一 Plan(A0~A6):
plan-start找第一个未勾 A 子项分发到对应 skill- § 二 Coding(模块):分发以
docs/02-开发计划.md § 二 开发顺序清单为准;coding-start按 docs/02 顺序扫描,对每个 REQ 所属模块查询本 § 二的里程碑:字段 + 本地git tag -l 'milestone/<id>',找第一个未打里程碑模块分发。本 § 二 行序无语义,仅作模块元数据表
一、Plan 阶段(一次性)
-
A0 项目初始化 — project-init
- 依赖检查通过
- 项目文件骨架已创建(CLAUDE.md + docs/01-需求清单/index.md + docs/04-技术规范.md)
- Git 已初始化
-
A1 范围锁定 — scope-lock
- 项目概述已填写(CLAUDE.md § 🎯 项目概述)
- 技术栈已确认(docs/04 § 零)
- 需求清单索引已填写(docs/01-需求清单/index.md)
- REQ 卡片骨架已生成(docs/01-需求清单//REQ-*.md,业务内容留待人工填写)
-
A2 骨架生成 — skeleton-gen
- 架构文档已生成(docs/04 § 一+、docs/06、docs/07、docs/09)
- 工具脚本已生成(scripts/*.mjs、.env.local)
- 样式 token 骨架已生成(src/styles/tokens.css)
- .gitignore 已配置
-
A3 DB 设计 + REQ 回填 — db-design-gen
- docs/03-数据库设计文档.md 已生成
- docs/01 各 REQ 卡片"依赖表" + 模块头"涉及表" 已回填
-
A4 DB 初始化 — db-init
- sql/migrations/V1__initial_schema.sql 已生成
- DDL 与 docs/03 全量一致
- .env.local 凭据已验证(mysql -e "SELECT 1" OK)
- setup-test-db.mjs 防护通过 + DROP+CREATE + apply V1 已执行
- DDL ↔ docs/03 apply 后 5 维一致(validate-ddl.mjs)
-
A5 下游文档生成 — downstream-gen
- docs/02 开发计划已生成
- docs/05 API 契约已生成
- docs/06 § 三 页面清单已填入
- docs/10 验收清单已生成
- 下方模块列表已填入
- REQ 卡片依赖接口已回填
-
A6 前端范围锁定 — frontend-scope-lock
- docs/06 项目级 UI 约定 + Design Tokens + 组件库已锁定
- docs/04 § 二 前端栈已锁定(引用 docs/06)
- 各 FE-NN 设计决策表已生成(docs/06 § 三之后 / docs/08 § 三)
二、Coding 阶段(后端模块循环)
(A5 填入后,每行一个后端模块。每个模块的 里程碑: 字段在 — 和 milestone/<id> 之间变化,完成由本地 git tag -l 判定。coding-start 每次按 docs/02 REQ 序扫每模块的里程碑 tag 决定派发。后端模块全部打里程碑后自动进入 § 三 前端阶段。)
三、Coding 阶段(前端整体)
(FE 业务功能清单在 Plan 期 A6 frontend-scope-lock 由 prototype/ + docs/01 + docs/05 推导后写入下方"功能:"项;Coding 阶段 coding.mjs 的 Router 把全部未完成 FE 聚合为单一 frontend-phase 阶段,排在所有后端模块之后。整个前端阶段 1 个里程碑 tag,分支 frontend-phase。)
- 整体里程碑: —
- 功能:
<!-- AI 进入时按以下行格式写入(每行 1 个 FE,可关联多个 REQ / 多份原型):
- FE-NN 功能名 | 关联 REQ:REQ-A, REQ-B | 关联原型:prototype/.html, prototype/.html
示例:
- FE-01 用户登录与注册 | 关联 REQ:REQ-SYS-001, REQ-SYS-002 | 关联原型:prototype/auth.html
- FE-02 仪表盘总览 | 关联 REQ:REQ-DASH-001 | 关联原型:prototype/dashboard.html -->