完整流程

这页只保留关键内容。

看这页只抓 4 件事：

这一阶段先看什么文档。
这一阶段产出放在哪里。
这一阶段人工智能应完成什么。
这一阶段什么情况下不能继续。

新项目怎么起手

新项目直接按这个例子交给 AI：

text

产品情况：
这是一个园区运营管理系统，第一期先做商户管理、商铺管理、合同管理、收费管理。

项目情况：
这是新项目，当前很多基础资料还没有整理完整。

输入来源：
- 产品源 Git：<仓库地址>
- 产品文档目录：doc/产品输入/<项目名>/product/
- 原型目录：prototype/

当前对象：
项目整体

目标状态：
先把项目基础整理好，再判断现在应该从哪个阶段开始推进。

人工边界：
数据库总设计评审结论、业务边界、专项审批由人确认。

其他常见例子

起始输入最少 4 项

输入项	说明
产品情况	做什么业务、主要模块大概有哪些
项目情况	新项目、二开项目，还是只拿到产品源
输入来源	Git 仓、产品文档目录、原型目录
目标状态	先整理项目、先建基础资料、还是先推进某个模块

项目情况只分 3 类

项目情况	说明
产品来源仓	只是产品输入来源，不是当前研发仓
二开项目	当前仓库已经有代码、文档、配置和历史实现
新项目工作流仓	当前仓库主要负责承接产品输入、生成契约和推进研发

没分清这 3 类，最容易出错：

把产品来源仓当研发仓直接开改
把二开项目当新项目，跳过现状梳理
项目基础还没整理完，就直接开始写模块代码

先看这一张总表

顺序	阶段	先看什么文档	主要产出	产出路径	本阶段 AI 应完成什么
1	产品情况说明与项目初始化	你提供的产品情况、项目情况、输入来源；然后再看 `.contract/project.json`、`doc/产品输入/`、`prototype/`、`AGENTS.md`	项目情况判断清楚、输入来源固定、项目基础上下文齐全	`.contract/project.json`、`doc/产品输入/`、`prototype/`	整理新项目基础，判断当前仓库性质，固定正式输入
2	项目级门禁	`.trellis/project-plan.yaml`、`doc/项目管理/项目任务拆分表.md`、数据库评审相关文档	项目是否具备启动条件的结论	`.trellis/project-plan.yaml`、`doc/项目管理/`	检查项目是否具备启动条件，列出缺口
3	数据库总设计与评审	产品文档、模块清单、项目配置、已有评审稿	数据库总设计评审稿、建表语句、关系图、数据字典、评审记录	`doc/数据库设计/`	整理数据库评审材料，列出待人工确认点
4	模块开始任务	`.contract/tasks/<模块>.task.json`、产品文档、数据库设计、原型资料	开始任务、风险清单、模块实施手册、前端还原资料骨架	`doc/任务管理/<模块>v*/开始任务/`	补齐模块起步资料，明确页面入口、流程、风险和边界
5	模块任务设计	开始任务目录、`.contract/schemas/<模块>.schema.json`、`.contract/api/<模块>.yaml`、数据库设计	模块设计资料、接口定义、测试口径、契约资料	`doc/任务管理/<模块>v*/任务设计/`、`.contract/`	收敛字段、接口、动作和测试口径
6	实现输入冻结	开始任务、任务设计、数据库设计、模块实施手册	实现输入冻结资料、实现窗口准备结果	`doc/任务管理/<模块>v*/任务设计/实现输入冻结.json`、`.trellis/workspace/implementation-input-freeze/`	冻结实现输入，检查是否满足并行实现前提
7	前后端实现	冻结资料、任务契约、模块实施手册、页面原型	后端代码、管理端代码、小程序代码、交接材料	`sei-server/`、`playground/apps/web/`、`mini/<按项目约定的端型目录>/`、`doc/任务管理/<模块>v*/`	判断实现落点并按冻结输入完成代码与交接材料
8	审核与验收收口	交接材料、运行时报告、验收记录、整改清单	可人工验收的证据包	`doc/任务管理/<模块>v*/产品功能验收/`、`.trellis/workspace/`	补齐验证、证据和整改闭环

第一阶段：产品情况说明与项目初始化

先看什么

你先提供的产品情况
你先提供的项目情况
你给出的输入来源
.contract/project.json
AGENTS.md
doc/产品输入/<项目名>/
prototype/

如果最开始这些文件还不全，就先让人工智能把它们整理到正式目录，再往下走。

重点先看 .contract/project.json 里的这几组字段：

productInput.sourceRepo、productInput.sourceBranch：产品源 Git 在哪里
productInput.sourceDirs：产品文档、管理端、小程序原始目录来自哪里
productInput.prototypePaths：正式原型目录映射到哪里
productInput.miniModuleTargets：如果产品已经定义小程序端型，这里才作为映射依据

产出放在哪里

.contract/project.json
doc/产品输入/
prototype/

本阶段 AI 应完成什么

基于已给出的产品情况、项目情况、输入来源，判断当前仓库属于哪一类
如果是新项目，先整理项目基础资料和正式目录
如果是产品来源输入，先固定输入映射
如果是二开项目，先梳理现状、已有代码、已有文档和原型
给出“当前应从哪个阶段继续推进”的结论

这一阶段什么时候不能继续

产品情况还没说清
项目情况还没判断清楚
输入来源没判断清楚
新项目基础资料还没整理出来
产品文档或原型目录还没固定
项目配置还读不出来

第二阶段：项目级门禁

先看什么

.trellis/project-plan.yaml
doc/项目管理/项目任务拆分表.md
doc/数据库设计/评审记录.md
doc/技术设计/

产出放在哪里

.trellis/project-plan.yaml
doc/项目管理/
.trellis/workspace/shared-summary.yaml

本阶段 AI 应完成什么

判断当前项目是否具备启动模块研发的条件
输出未满足的门禁项
按优先级列出缺失文档、缺失结论和阻塞点

这一阶段什么时候不能继续

项目计划还没建立
数据库评审还没明确通过
当前项目状态还不允许启动模块

第三阶段：数据库总设计与评审

先看什么

doc/产品输入/<项目名>/product/
doc/项目管理/项目任务拆分表.md
.contract/project.json
已有 doc/数据库设计/ 文档

产出放在哪里

doc/数据库设计/数据库总设计评审稿.md
doc/数据库设计/ddl.sql
doc/数据库设计/er-diagram.md
doc/数据库设计/data-dictionary.md
doc/数据库设计/评审记录.md

本阶段 AI 应完成什么

基于当前产品输入整理数据库总设计评审材料
形成评审稿、建表语句、关系图和数据字典草稿
列出需要人工确认的风险点

这一阶段什么时候不能继续

评审材料没补齐
评审记录里还没有“评审结论：通过”
高风险模块的关键数据边界还没定清

第四阶段：模块开始任务

先看什么

.contract/tasks/<模块>.task.json（如有）
doc/数据库设计/
doc/产品输入/<项目名>/product/
prototype/

产出放在哪里

doc/任务管理/<模块>v*/开始任务/开始任务.md
doc/任务管理/<模块>v*/开始任务/AI实施风险清单.md
doc/任务管理/<模块>v*/开始任务/模块AI实施手册.md
doc/任务管理/<模块>v*/开始任务/

本阶段 AI 应完成什么

补齐模块开始任务资料
明确页面入口、用户流程、核心字段、风险清单和模块实施手册
如果模块涉及小程序，先检查产品资料和任务契约是否已定义具体端型
如果产品未定义具体端型，只按小程序模块收敛，不自行扩写端型名称
输出当前缺口

这一阶段什么时候不能继续

模块目标还不清
页面入口还不清
小程序模块的产品定义还没收敛
核心字段和异常场景还没写实
风险清单和模块实施手册还没补齐

第五阶段：模块任务设计

先看什么

doc/任务管理/<模块>v*/开始任务/
.contract/schemas/<模块>.schema.json
.contract/api/<模块>.yaml
doc/数据库设计/

产出放在哪里

doc/任务管理/<模块>v*/任务设计/
.contract/schemas/
.contract/api/
.contract/sei/

本阶段 AI 应完成什么

收敛字段口径
收敛接口定义
收敛页面动作、异常场景和测试口径
未收敛前不得进入实现

这一阶段什么时候不能继续

字段口径还在漂
接口定义还没定
页面动作和异常场景没写清
测试口径还没补齐

第六阶段：实现输入冻结

先看什么

doc/任务管理/<模块>v*/开始任务/
doc/任务管理/<模块>v*/任务设计/
doc/数据库设计/
doc/任务管理/<模块>v*/开始任务/模块AI实施手册.md

产出放在哪里

doc/任务管理/<模块>v*/任务设计/实现输入冻结.json
.trellis/workspace/implementation-input-freeze/<模块>.json
.trellis/workspace/shared-summary.yaml

本阶段 AI 应完成什么

生成 <模块名> 的实现输入冻结资料
明确当前实现依据、冻结结果和是否命中专项审批
如果审批未通过，停止在冻结阶段，不进入前后端并行实现

这一阶段什么时候不能继续

冻结资料没生成
当前实现依据还不完整
专项审批还没过

第七阶段：前后端实现

先看什么

冻结资料
.contract/schemas/<模块>.schema.json
.contract/api/<模块>.yaml
.contract/tasks/<模块>.task.json
doc/任务管理/<模块>v*/开始任务/模块AI实施手册.md
页面原型和前端还原资料

产出放在哪里

sei-server/src/main/java/sei/cloud/longzhou/
sei-server/src/main/resources/
playground/apps/web/src/views/：管理端页面
playground/apps/web/src/api/：管理端接口调用
playground/apps/web/src/router/：管理端路由
mini/<按项目约定的端型目录>/src/：产品已定义具体端型时再落这里
doc/任务管理/<模块>v*/开始任务/
doc/任务管理/<模块>v*/产品功能验收/

本阶段 AI 应完成什么

按冻结输入推进 <模块名> 的实现
判断当前模块实现落点是管理端还是小程序
如果是小程序，先读取产品文档和任务契约，确认端型是否已经定义
只有产品已经定义具体端型时，才把产出写到对应目录
实现过程中同步补齐交接材料
如果存在阻塞，明确指出阻塞点

这一阶段什么时候不能继续

还没冻结输入
还没判断清楚当前模块是管理端还是小程序
产品资料和任务契约还没把小程序端型定义清楚
还在改冻结之外的口径
交接材料没补
明显超出本轮范围

小程序怎么落目录

这里要先讲清楚一件事：

text

工作流不预设任何固定小程序端名。
端型只在产品文档和任务契约定义清楚以后，才按映射落目录。

如果模块涉及小程序，而且产品已经把具体端型定义清楚，再继续按映射落到对应目录；目录名以项目约定和任务契约为准，工作流里不再先写死端名。

人工智能不能自己长期靠猜，必须优先看：

.contract/tasks/<模块>.task.json
frontendStage
miniPrototypeTarget
.contract/project.json > productInput.miniModuleTargets

本段 AI 判断规则：

如果模块涉及小程序，先读取产品文档和任务契约里的端类型定义
如果端类型还没有定义清楚，停在小程序模块这一层，不自行扩写
如果端类型已经定义清楚，再把代码产出写到正确目录

第八阶段：审核与验收收口

先看什么

本轮交接材料
运行时报告
页面验收记录
业务场景自测
整改清单

产出放在哪里

doc/任务管理/<模块>v*/产品功能验收/前端运行时自检报告.*
doc/任务管理/<模块>v*/产品功能验收/前端浏览器验收记录.*
doc/任务管理/<模块>v*/产品功能验收/业务场景自测记录.*
doc/任务管理/<模块>v*/产品功能验收/验收整改清单.md
.trellis/workspace/shared-summary.yaml

本阶段 AI 应完成什么

对 <模块名> 执行验收收口
补齐运行时检查、页面验收证据、业务场景自测和整改清单
没有证据时不得给出“可人工验收”的结论

这一阶段什么时候不能继续

没有运行时证据
没有页面验收记录
没有整改清单
高风险模块缺关键场景自测

最常用的读文档顺序

如果是第一次接手一个项目，建议按这个顺序看：

.contract/project.json
AGENTS.md
.trellis/project-plan.yaml
doc/数据库设计/
doc/产品输入/

如果是第一次接手一个模块，建议按这个顺序看：

.contract/tasks/<模块>.task.json
doc/任务管理/<模块>v*/开始任务/
doc/任务管理/<模块>v*/任务设计/
.contract/schemas/<模块>.schema.json
.contract/api/<模块>.yaml
doc/任务管理/<模块>v*/产品功能验收/

最短记忆版

text

每一步都先明确：先看什么、先补什么、产出放哪、什么情况下不要继续。

完整流程 ​

新项目怎么起手 ​

其他常见例子 ​

起始输入最少 4 项 ​

项目情况只分 3 类 ​

先看这一张总表 ​

第一阶段：产品情况说明与项目初始化 ​

先看什么 ​

产出放在哪里 ​

本阶段 AI 应完成什么 ​

这一阶段什么时候不能继续 ​

第二阶段：项目级门禁 ​

先看什么 ​

产出放在哪里 ​

本阶段 AI 应完成什么 ​

这一阶段什么时候不能继续 ​

第三阶段：数据库总设计与评审 ​

先看什么 ​

产出放在哪里 ​

本阶段 AI 应完成什么 ​

这一阶段什么时候不能继续 ​

第四阶段：模块开始任务 ​

先看什么 ​

产出放在哪里 ​

本阶段 AI 应完成什么 ​

这一阶段什么时候不能继续 ​

第五阶段：模块任务设计 ​

先看什么 ​

产出放在哪里 ​

本阶段 AI 应完成什么 ​

这一阶段什么时候不能继续 ​

第六阶段：实现输入冻结 ​

先看什么 ​

产出放在哪里 ​

本阶段 AI 应完成什么 ​

这一阶段什么时候不能继续 ​

第七阶段：前后端实现 ​

先看什么 ​

产出放在哪里 ​

本阶段 AI 应完成什么 ​

这一阶段什么时候不能继续 ​

小程序怎么落目录 ​

第八阶段：审核与验收收口 ​

先看什么 ​

产出放在哪里 ​

本阶段 AI 应完成什么 ​

这一阶段什么时候不能继续 ​

最常用的读文档顺序 ​

最短记忆版 ​

完整流程

新项目怎么起手

其他常见例子

起始输入最少 4 项

项目情况只分 3 类

先看这一张总表

第一阶段：产品情况说明与项目初始化

先看什么

产出放在哪里

本阶段 AI 应完成什么

这一阶段什么时候不能继续

第二阶段：项目级门禁

先看什么

产出放在哪里

本阶段 AI 应完成什么

这一阶段什么时候不能继续

第三阶段：数据库总设计与评审

先看什么

产出放在哪里

本阶段 AI 应完成什么

这一阶段什么时候不能继续

第四阶段：模块开始任务

先看什么

产出放在哪里

本阶段 AI 应完成什么

这一阶段什么时候不能继续

第五阶段：模块任务设计

先看什么

产出放在哪里

本阶段 AI 应完成什么

这一阶段什么时候不能继续

第六阶段：实现输入冻结

先看什么

产出放在哪里

本阶段 AI 应完成什么

这一阶段什么时候不能继续

第七阶段：前后端实现

先看什么

产出放在哪里

本阶段 AI 应完成什么

这一阶段什么时候不能继续

小程序怎么落目录

第八阶段：审核与验收收口

先看什么

产出放在哪里

本阶段 AI 应完成什么

这一阶段什么时候不能继续

最常用的读文档顺序

最短记忆版