环境搭建与基础设施 — 子工作流

本文件定义"环境搭建与基础设施"阶段的独立子工作流。用户可单独加载本文件执行环境搭建阶段。

阶段目标

建立可复现的开发环境和基础设施。环境搭建阶段的核心产出是"环境可用"——新加入的成员可以在合理时间内完成环境配置并开始开发。

AI 编程场景特有风险

在 AI 辅助编程项目中，环境搭建阶段存在以下特有风险：

独立使用时的目标锚定

当本子工作流被独立加载（非通过 main-workflow.md 总入口加载）时，MUST 在执行阶段活动前完成以下自包含检查。本段不依赖任何其他文件。

锚定步骤（每步有具体文件路径和检查目标）：

1. 目标确认：读取 .governance/plan-tracker.md → 找到 ## 项目配置 节 → 确认项目目标和技术栈约束。如果 plan-tracker 中无明确目标 → MUST 通过 AskUserQuestion 工具询问用户（M5.1 禁止内联文字问题），选项示例：(1) "输入项目目标和技术栈" (2) "跳过目标锚定——我知道风险" (3) "初始化 governance 后再继续"
2. 偏离检查：对照成功标准，确认环境搭建范围与项目总目标一致（如：小工具不需要 K8s 集群）。偏离 → MUST 先记录到 .governance/decision-log.md
3. 质量底线：环境配置 MUST 可复现（在干净机器上可重放）+ 可通过 CI 验证（参考 profile 质量要求）

降级行为（.governance/ 缺失时）：

• .governance/plan-tracker.md 不存在 → 内联告知用户（单向通知，非提问——不触发 M5.1 禁令）："当前项目未初始化 governance。独立使用模式下目标锚定不可用——无法确认环境搭建是否与项目目标匹配。建议运行 governance-init 初始化治理。"
• 降级不阻塞执行——独立使用模式下可直接开始环境搭建，但 agent MUST 在开始前内联告知用户锚定缺失的风险（单向通知——非交互式提问）
• 如果后续初始化了 governance，锚定检查在下一会话自动恢复

进入条件

• 技术选型已完成（G3 通过）
• 有明确的技术栈决策

活动清单

1. 仓库初始化

2. 开发环境配置

3. 基础 CI 配置

4. 协作规范建立

产出物标准

退出条件

• 开发环境可复现（有 Dockerfile/环境配置文档/一键脚本，且在 CI 中验证通过）
• 仓库结构与约定一致（验证脚本通过）
• 基础 CI 可运行（至少成功运行 1 次）
• 协作规范已建立（贡献指南 + commit 规范 + PR 模板）
• 依赖版本已锁定（有 lockfile，具体到版本号）

Gate 映射

本阶段对应 G4 — 环境就绪。

企业实践溯源

本子工作流的设计参考了以下企业实践，每条实践已映射到具体活动步骤：