第 2 阶段手册 — 基础与脚手架

2026.6.10 研发部 1
Phase 2

第 2 阶段手册 — 基础与脚手架

搭好后续所有工作的技术和运营基础。先把骨架立起来,再往上加肉。这个阶段结束后,每个开发者都有可用的开发环境、可部署的流水线、和可用的设计系统。

⏱️ 时长:3-5 天 🤖 智能体:6 个 🛡️ 守门人:DevOps 自动化师 + 证据收集者

目标

搭好后续所有工作的技术和运营基础。先把骨架立起来,再往上加肉。这个阶段结束后,每个开发者都有可用的开发环境、可部署的流水线、和可用的设计系统。

前提条件

  • [ ] 第 1 阶段质量门禁通过(架构包已批准)
  • [ ] 收到第 1 阶段交接包
  • [ ] 所有架构文档已定稿

智能体激活顺序

工作流 A:基础设施(第 1-3 天,并行)

DevOps 自动化师 — CI/CD 流水线 + 基础设施

激活 DevOps 自动化师,为 [项目] 搭建基础设施。

输入:后端架构师系统架构 + 部署要求
交付要求:
1. CI/CD 流水线(GitHub Actions / GitLab CI)
   - 安全扫描阶段
   - 自动化测试阶段
   - 构建和容器化阶段
   - 部署阶段(蓝绿或金丝雀)
   - 自动回滚能力
2. 基础设施即代码
   - 环境配置(开发、预发布、生产)
   - 容器编排配置
   - 网络和安全配置
3. 环境配置
   - 密钥管理
   - 环境变量管理
   - 多环境一致性

要创建的文件:
- .github/workflows/ci-cd.yml(或等效配置)
- infrastructure/(Terraform/CDK 模板)
- docker-compose.yml
- Dockerfile

格式:可运行的 CI/CD 流水线 + IaC 模板
时间线:3 天

基础设施运维师 — 云基础设施 + 监控

激活基础设施运维师,为 [项目] 搭建监控。

输入:DevOps 自动化师基础设施 + 后端架构师架构
交付要求:
1. 云资源配置
   - 计算、存储、网络资源
   - 自动伸缩配置
   - 负载均衡配置
2. 监控体系
   - 应用指标(Prometheus/DataDog)
   - 基础设施指标
   - 自定义仪表盘(Grafana)
3. 日志和告警
   - 集中式日志收集
   - 关键阈值的告警规则
   - 值班通知配置
4. 安全加固
   - 防火墙规则
   - SSL/TLS 配置
   - 访问控制策略

格式:基础设施就绪报告 + 仪表盘访问入口
时间线:3 天

工作室运营 — 流程搭建

激活工作室运营,为 [项目] 搭建流程。

输入:Sprint 排序师计划 + 项目牧羊人协调需求
交付要求:
1. Git 工作流
   - 分支策略(GitFlow / 主干开发)
   - PR 审核流程
   - 合并策略
2. 沟通渠道
   - 团队频道搭建
   - 通知路由
   - 状态更新节奏
3. 文档模板
   - PR 模板
   - Issue 模板
   - 决策日志模板
4. 协作工具
   - 项目看板搭建
   - Sprint 追踪配置

格式:运营手册
时间线:2 天

工作流 B:应用基础(第 1-4 天,并行)

前端开发者 — 项目脚手架 + 组件库

激活前端开发者,为 [项目] 搭建项目脚手架。

输入:UX 架构师 CSS 设计系统 + 品牌守护者品牌识别
交付要求:
1. 项目脚手架
   - 框架搭建(React/Vue/Angular,按架构定)
   - TypeScript 配置
   - 构建工具(Vite/Webpack/Next.js)
   - 测试框架(Jest/Vitest + Testing Library)
2. 设计系统实现
   - UX 架构师的 CSS 设计 token
   - 基础组件库(Button, Input, Card, Layout)
   - 主题系统(亮色/暗色/跟随系统切换)
   - 响应式工具
3. 应用外壳
   - 路由搭建
   - 布局组件(Header, Footer, Sidebar)
   - 错误边界实现
   - 加载状态

要创建的文件:
- src/(应用源码)
- src/components/(组件库)
- src/styles/(设计 token)
- src/layouts/(布局组件)

格式:可运行的应用骨架 + 组件库
时间线:3 天

后端架构师 — 数据库 + API 基础

激活后端架构师,为 [项目] 搭建 API 基础。

输入:系统架构文档 + 数据库 Schema 设计
交付要求:
1. 数据库搭建
   - Schema 部署(迁移脚本)
   - 索引创建
   - 开发用种子数据
   - 连接池配置
2. API 骨架
   - 框架搭建(Express/FastAPI 等)
   - 按架构搭好路由结构
   - 中间件体系(认证、校验、错误处理、CORS)
   - 健康检查端点
3. 认证系统
   - 认证提供商集成
   - JWT/Session 管理
   - 基于角色的访问控制骨架
4. 服务通信
   - API 版本管理
   - 请求/响应序列化
   - 错误响应标准化

要创建的文件:
- api/ 或 server/(后端源码)
- migrations/(数据库迁移)
- docs/api-spec.yaml(OpenAPI 文档)

格式:可运行的 API 骨架 + 数据库 + 认证
时间线:4 天

UX 架构师 — CSS 系统实现

激活 UX 架构师,为 [项目] 实现 CSS 系统。

输入:品牌守护者品牌识别 + 自己第 1 阶段的 CSS 设计系统规范
交付要求:
1. 设计 Token 实现
   - CSS 自定义属性(颜色、字体、间距)
   - 品牌色板 + 语义化命名
   - 响应式字体比例尺
2. 布局系统
   - 容器系统(响应式断点)
   - 网格模式(2 栏、3 栏、侧边栏)
   - Flexbox 工具类
3. 主题系统
   - 亮色主题变量
   - 暗色主题变量
   - 系统偏好检测
   - 主题切换组件
   - 主题间的平滑过渡

要创建/更新的文件:
- css/design-system.css(或框架中的等效文件)
- css/layout.css
- css/components.css
- js/theme-manager.js

格式:已实现的 CSS 设计系统 + 主题切换
时间线:2 天

验证检查点(第 4-5 天)

证据收集者验证

激活证据收集者,验证第 2 阶段基础搭建。

用截图证据验证以下项目:
1. CI/CD 流水线成功执行(展示流水线日志)
2. 应用骨架在浏览器中正常加载(桌面端截图)
3. 应用骨架在手机上正常加载(手机截图)
4. 主题切换正常工作(亮色 + 暗色截图)
5. API 健康检查有响应(curl 输出)
6. 数据库可访问(迁移状态)
7. 监控仪表盘在线(仪表盘截图)
8. 组件库可渲染(组件演示页面)

格式:证据包 + 截图
判定:通过 / 不通过,不通过时列出具体问题

质量门禁检查清单

# 标准 证据来源 状态
1 CI/CD 流水线能构建、测试和部署 流水线执行日志
2 数据库 Schema 已部署,表和索引都建好了 迁移成功的输出
3 API 骨架在健康检查端点上有响应 curl 响应证据
4 前端骨架在浏览器中正常渲染 证据收集者截图
5 监控仪表盘在显示指标 仪表盘截图
6 设计系统 token 已实现 组件库演示
7 主题切换可用(亮色/暗色/跟随系统) 切换前后截图
8 Git 工作流和流程已文档化 工作室运营手册

门禁决策

需要双签:DevOps 自动化师(基础设施层面)+ 证据收集者(视觉层面)

  • 通过:骨架应用可运行 + 完整 DevOps 流水线 → 激活第 3 阶段
  • 不通过:具体的基础设施或应用问题 → 修复后重新验证

交接给第 3 阶段

## 第 2 阶段 → 第 3 阶段交接包

### 给所有开发智能体的:
- 可运行的 CI/CD 流水线(合并后自动部署)
- 设计系统 token 和组件库
- API 骨架 + 认证 + 健康检查
- 数据库 + Schema + 种子数据
- Git 工作流和 PR 流程

### 给证据收集者(持续 QA)的:
- 应用地址(开发、预发布)
- 截图采集方法
- 组件库参考
- 视觉验证用的品牌规范

### 给智能体编排者(管理开发-测试循环)的:
- Sprint 排序师的待办列表(来自第 1 阶段)
- 带验收标准的任务清单(来自第 1 阶段)
- 智能体分配矩阵(来自 NEXUS 策略)
- 各类任务的质量阈值

### 环境访问:
- 开发环境:[URL]
- 预发布环境:[URL]
- 监控仪表盘:[URL]
- CI/CD 流水线:[URL]
- API 文档:[URL]

评论