# 第 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 阶段

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

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

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

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

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

---

*当骨架应用跑起来、CI/CD 流水线可用、证据收集者用截图验证了所有基础组件后，第 2 阶段结束。*