xiaoxia-saas/docs/checklists/session-start.md

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，当前任务已对齐开发体系与环境收敛规则，可以开始执行。

---

七、结束语

这份清单不是形式，而是防止：

• 新会话失忆
• 文档路径漂移
• 环境规则混乱
• 再次出现“边跑边修、越修越乱”

不做检查，不允许开工。