# session-start.md

# 小虾 SaaS 会话启动检查清单

**用途**: 每次进入小虾 SaaS 项目工作前，必须逐项确认，避免新会话失忆、环境跑偏、文档路径失效。  
**状态**: ✅ 生效中

---

## 一、强制读取顺序

启动后必须先读：

1. `G:\ClawBox-Portable-windows-x64\data\openclaw\workspace\AGENTS.md`
2. `G:\ClawBox-Portable-windows-x64\data\openclaw\workspace\META.md`
3. `G:\ClawBox-Portable-windows-x64\data\openclaw\workspace\小虾SaaS全自动化开发完整体系.md`
4. `G:\ClawBox-Portable-windows-x64\data\openclaw\workspace\小虾SaaS开发环境防跑偏收敛方案.md`
5. `F:\openclaw-saas\docs\PHASE7-PROGRESS.md`
6. `F:\openclaw-saas\docs\PHASE7-DESIGN.md`
7. `F:\openclaw-saas\docs\checklists\session-start.md`

---

## 二、路径检查（强制）

在开始工作前，必须确认以下路径真实存在：

- [ ] `META.md` 存在
- [ ] `小虾SaaS全自动化开发完整体系.md` 存在
- [ ] `小虾SaaS开发环境防跑偏收敛方案.md` 存在
- [ ] `F:\openclaw-saas\docs\PHASE7-PROGRESS.md` 存在
- [ ] `F:\openclaw-saas\docs\PHASE7-DESIGN.md` 存在
- [ ] `F:\openclaw-saas\docs\checklists\session-start.md` 存在

**如果不存在：**
- 立即停止当前任务
- 先修正文档路径或补齐缺失文件
- 禁止带着失效路径继续工作

---

## 三、理解检查（必须能答）

### 项目状态
- [ ] 当前 Phase 是：Phase 7 - 核心视频剪辑业务
- [ ] 当前 Phase 主要目标：打通上传→分类→生成→成片主链路
- [ ] 当前正在做的事：环境与 CI 收口 / 或正式业务开发（按最新进度文档）

### 团队结构
- [ ] 8 个 Agent 分别是：requirement / arch / code_dev / lint_review / test / build_pack / release / ops_monitor
- [ ] 小虾工作量占比：12.5%

### Git / CI 规则
- [ ] main 和 develop 禁止直接 push
- [ ] Commit 格式：`<type>(<scope>): <subject>`
- [ ] Gitea CI 真源：`F:\openclaw-saas\.gitea\workflows\`
- [ ] `.github/workflows` 和 `.gitea/workflows` 必须保持一致

### 环境规则
- [ ] CI Python 唯一标准：`venv + 官方 PyPI`
- [ ] 当前统一容器基座：`catthehacker/ubuntu:act-latest`
- [ ] 不能再混用全局 `pip` / apt 替代 / `--break-system-packages`

---

## 四、开始工作前的判断

在正式动手前，必须先判断当前任务属于哪类：

- [ ] 文档修正
- [ ] 环境收敛
- [ ] Agent 编排
- [ ] Phase 7 业务开发
- [ ] Git / CI / 部署
- [ ] 运维 / 监控

然后确认：
- [ ] 需要读哪一份相关文档
- [ ] 需要哪个 Agent 主导
- [ ] 是否会影响 Git / CI / 环境真源

---

## 五、禁止事项

以下情况一旦出现，必须立刻停下：

- [ ] 我不知道当前 Phase
- [ ] 我不知道当前 CI 真源在哪
- [ ] 我不知道文档路径是否有效
- [ ] 我打算先改了再说
- [ ] 我准备临时换一个环境方案试试
- [ ] 我没有看完核心文档就开始执行

---

## 六、向老大的启动汇报模板

完成检查后，对老大的标准汇报应为：

> 会话启动完成，已加载核心文档；当前 Phase 为 Phase 7，当前任务已对齐开发体系与环境收敛规则，可以开始执行。

---

## 七、结束语

这份清单不是形式，而是防止：
- 新会话失忆
- 文档路径漂移
- 环境规则混乱
- 再次出现“边跑边修、越修越乱”

**不做检查，不允许开工。**
