docs-08-initial-template.md 3.26 KB

08-工作流进度

全流程进度跟踪。CC 每完成一项产出就勾选一项。

  • § 一 Plan(A0~A6)plan-start 找第一个未勾 A 子项分发到对应 skill
  • § 二 Coding(模块):分发以 docs/02-开发计划.md § 二 开发顺序清单 为准;coding.mjs Router 按 docs/02 顺序扫描,对每个 REQ 所属模块查询本 § 二的 里程碑: 字段 + 本地 git tag -l 'milestone/<id>' 判定模块完成,并用 git tag -l 'req-done/<REQ-or-FE>' 判定功能级跳过。本 § 二 行序无语义,仅作模块元数据表

一、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 'milestone/<id>' 判定。功能行 checkbox 只作可视化,真正的功能级 resume 由 req-done/<REQ> tag 判定。后端模块全部打里程碑后自动进入 § 三 前端阶段。)

三、Coding 阶段(前端整体)

(FE 业务功能清单在 Plan 期 A6 frontend-scope-lock 由 prototype/ + docs/01 + docs/05 推导后写入下方"功能:"项;Coding 阶段 coding.mjs 的 Router 把缺少 req-done/<FE-NN> tag 的 FE 聚合为单一 frontend-phase 阶段,排在所有后端模块之后。整个前端阶段 1 个里程碑 tag,分支 frontend-phase。)

  • 整体里程碑: —
  • 功能: