docs-08-initial-template.md 3.47 KB

08-工作流进度

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

  • § 一 Plan(A0~A5)plan-start 找第一个未勾 A 子项分发到对应 skill
  • § 二 Coding(模块):分发以 docs/02-开发计划.md § 二 开发顺序清单 为准;coding-start 按 docs/02 顺序扫描,对每个 REQ 所属模块查询本 § 二的 MR: 字段 + GitLab API state,找第一个非 merged 模块分发。本 § 二 行序无语义,仅作模块元数据表

一、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/*.sh、.githooks/pre-push、.env.local)
    • .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.sh 防护通过 + DROP+CREATE + apply V1 已执行
    • SHOW TABLES 行数 == docs/03 表数量
  • A5 下游文档生成 — downstream-gen

    • docs/02 开发计划已生成
    • docs/05 API 契约已生成
    • docs/06 § 三 页面清单已填入
    • docs/10 验收清单已生成
    • 下方模块列表已填入
    • REQ 卡片依赖接口已回填

二、Coding 阶段(后端模块循环)

(A5 填入后,每行一个后端模块。每个模块的 MR: 字段在 !<iid> 之间变化,完成由 GitLab API state=merged 判定。coding-start 每次按 docs/02 REQ 序扫每模块的 MR state 决定派发。后端模块全部 merged 后自动进入 § 三 前端阶段。)

三、Coding 阶段(前端整体)

frontend-start 进入时扫 prototype/ + docs/01 + docs/05 → AI 自主推导 FE 业务功能清单写到下方"功能:"项(无人工审阅断点;合理性由整体 MR 时统一校核)。已有清单则直接加载。整个前端阶段 1 个 MR,分支 frontend-phase。)

  • 整体 MR: —
  • 功能: <!-- 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 -->